MacOS Required Configurations for AIQ

The following steps are necessary to improve AIQ compatibility with macOS systems.

RecommendedJava guidance8 Related Configuration

ApplyThis configuration addresses a known issue that causes slowing in Java 8 applications with macOS Sierra or newer.

See StackOverflow for more information.

This configuration stepsis accordingrequired for macOS Sierra (10.12), High Sierra (10.13) Mojave (10.14), and earlier versions of Catalina (10.15.1 through 10.15.4).

1. Type "hostname" in a terminal window to get your system's canonical name. This <system canonical name> should look similar to Joe-MacBook-Pro.local.
2. Enter the hostname obtained in the first step into your /etc/hosts text file.
   1. Open the nano text editor to edit the /etc/hosts file by typing in a terminal: sudo nano /etc/hosts
   2. Assuming your hostname is "Joe-MacBook-Pro.local", then you should add two lines similar to this ones to the AIQ/etc/hosts version,file.
      127.0.0.1 macOSJoe-MacBook-Pro.local
::1 version,Joe-MacBook-Pro.local
   3. Press CPUCtrl+O architecture,to browserwrite requirements,changes to the hosts file, and customerCtrl-X securityto policy. Do not bypass macOS security prompts through documentation;exit the usernano ortext administratoreditor. shouldMake approvesure requiredto permissions.replace 

      ConfigurationJoe-MacBook-Pro.local areas

      with
      • Runtimeyour dependencies,actual browserhostname dependencies, certificates, and local permissions.
      • Download quarantine, Gatekeeper, and application execution approvals handledreturned by the user.
      • Network,command proxy,in DNS,the first step. Save your file, and firewallretry accessexecuting your script in test designer.
        This change is NOT needed for recent Catalina OS releases (10.15.5+).

System Preferences

This configuration is necessary to AIQbe able to record and applicationsplayback underusing test.Test Designer IDE using a Safari browser.

• FileIn the Security & Privacy preference, select the Privacy section, for Accessibility and Full Disk Access: add the Java app to the list of apps that are allowed to control your computer. (Mojave requires the Accessibility permissions forto installation,control logs,your repositories,computer andto the Terminal App instead of the Java App)
  
  
• If you want to record/playback Test NodeDesigner assets.script with Safari, make sure you select Safari as your default system browser in the Preferences General tab
  
• In the Network preferences, Proxies settings: set the Bypass proxy settings to your AIQ server DNS
  

ValidationSafari workflowPreferences

1. Confirm

   This AIQconfiguration startsis necessary to be able to record and usersplayback using Test Designer IDE using a Safari browser.

   Safari opens with: A new private window. New window open with Empty PageNew tabs open with Empty Page

   

   Select "When a new tab or window opens, make it active" in Tabs section

   

   Other optional settings in Safari Advanced tab:

   

   Apvance Certificate

   Check if the Appvance Certificate is present (only needed if after the above steps you have Test Designer IDE recording problems)

   The client installer for Test Designer scripts should automatically install Appvance 2020 SSL certificate in MacOS and in Mozilla Firefox (if present). But if you have problems recording on HTTPS sites, do validate if the certificate "Appvance 2020" is installed in the MacOS and/or Firefox.

   Verifying the Appvance certificate is installed in MacOS

   To check the MacOS certificates open the Keychain Access application and click over the tab. You should be able to find the "Appvance 2020" certificate with a blue dot (meaning it is trusted) as in this image:

   

   Catalina updates (May 2019) requires that the Appvance2020 certificate needs to be installed both in System and login keychains.

   Installing the Appvance certificate in MacOS

   If the certificate is not installed in Mozilla Firefox, you can logdownload in.

2. Runit Scenariofrom Editorthis link:https://aiq-client-installer.s3-us-west-2.amazonaws.com/appvance2020.cerThen click the "Import" button in the Firefox Certificate Manager and Serviceselect Suitethe smokedownloaded tests.
3. Verify"appvance2020.cer" browserfile. launch,

   Double-click downloads,the certificates,appvance2020.cer file and requiredit permissions.

4. Documentwill macOSbe versionadded to the Keychain Access application. Locate the Appvance 2020 in the System Keychain and anydoble administrator-approvedclick policyover changes.

it to see its details. Expand the Trust option and select Always Trust in the first select box.The OS will ask for your password to trust this certificate and the screen should look like this

Verifying the Appvance certificate is installed in Firefox

To check if the certificate is installed on Mozilla Firefox, open Firefox and open the Preferences, then type "Certificates" in the search input box. Click the View Certificates button to open the Certificates Manager:

In the Certificate Manager, click the "Authorities" tab and scroll down until you find the Appvance 2020 certificate

Installing the Appvance certificate in Firefox

If the certificate is not installed in Mozilla Firefox, you can download it from this link:https://aiq-client-installer.s3-us-west-2.amazonaws.com/appvance2020.cer

Then click the "Import" button in the Firefox Certificate Manager and select the downloaded "appvance2020.cer" file. Then click both trust checkboxes as in this image, and click Ok.

 

Next step: MySQL Install & Setup

---

Last updated: OctoberJuly 7,31, 20262024

If you have any feedback on this topic, please contact us at documentation@appvance.ai