macOS Required Configurations for AIQ

Recommended guidance

TheApply followingmacOS configuration steps are necessary to improve AIQ compatibility with macOS systems.

Java 8 Related Configuration

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

See StackOverflow for more information.

This configuration is required 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 onesaccording to the /etc/hostsAIQ file.
      127.0.0.1version, Joe-MacBook-Pro.local
::1macOS Joe-MacBook-Pro.local
   3. Pressversion, Ctrl+OCPU toarchitecture, writebrowser changesrequirements, toand customer security policy. Do not bypass macOS security prompts through documentation; the hostsuser file,or administrator should approve required permissions.

      Configuration areas

      • Runtime dependencies, browser dependencies, certificates, and Ctrl-Xlocal topermissions.
      • Download exitquarantine, theGatekeeper, nanoand textapplication editor.execution Makeapprovals sure to replace Joe-MacBook-Pro.local with your actual hostname returnedhandled by the commanduser.
      • Network, inproxy, the first step. Save your file,DNS, and retryfirewall executingaccess yourto scriptAIQ inand testapplications designer.
        Thisunder changetest.
      • File is NOT neededpermissions for recentinstallation, Catalinalogs, OS releases (10.15.5+).

System Preferences

This configuration is necessary to be able to recordrepositories, and playback using Test DesignerNode IDE using a Safari browser.

• In 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 to control your computer to the Terminal App instead of the Java App)
  
  
• If you want to record/playback Test Designer 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
  assets.

SafariValidation Preferencesworkflow

This

1. Confirm configurationAIQ is necessary to be able to recordstarts and playbackusers usingcan Testlog Designerin.
2. Run IDEScenario 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 MacOSEditor and inService MozillaSuite Firefoxsmoke (iftests.

3. Verify present).browser Butlaunch, ifdownloads, 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 applicationcertificates, and clickrequired overpermissions.

4. Document themacOS 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 Systemversion and loginany keychains.

   administrator-approved

   Installingpolicy the Appvance certificate in MacOS

   changes.

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.cerThen click the "Import" button in the Firefox Certificate Manager and select the downloaded "appvance2020.cer" file.

Double-click the appvance2020.cer file and it will be added to the Keychain Access application. Locate the Appvance 2020 in the System Keychain and doble click over 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: JulyOctober 31,7, 20242026

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