Appvance IQ Manual Test Designer Install (GraalVM 11 Based)

Setting up Appvance IQ

As is often the case with the best things in life, your computer requires a little bit of preparation to run Appvance IQ.

Appvance Installation Instructions

Download installer from Appvance IQ

Go to the following path in your Appvance IQ URL, for example http://12-123-123-123:8080/UI/TestDesigner-installer.exe (or .dmg for Mac)

Couldn’t Download Installer?

  1. Go to your Appvance IQ URL, for example http://12-123-123-123:8080,and login using the credentials provided by Appvance.

  2. Expand Test Designer and click IDE
    A prompt appears with an option to download the installer.

  1. Run TestDesigner-installer.exe (or .dmg)

  2. Upon completion:

    1. A message appears stating the Designer Proxy is running, or to start Designer Proxy using the shortcut on your Desktop.

    2. A shortcut was created on your Desktop.

Should you restart your system or manually stop the Test Designer proxy, use the shortcut on your Desktop to the restart Test Designer proxy.

Excluding files/folders from antivirus scans

The Test Designer* folder should be excluded from live, daily, or weekly or monthly scheduled scans, which will take up some time scanning them. Also if these folders are not excluded, you may see some unexpected behavior.

Following are some of the top Anti-virus from which the files / folders of Appvance IQ should be excluded:

  • AVG Anti-virus

  • Avast Anti-virus

  • Kasperskey Anti-virus

  • McAfee Virus Scan

  • Norton Anti-virus

  • Symantec Endpoint protection

  • Windows Defender

 

*Test Designer folder
Windows default path: C:\TestDesigner
Mac default path: $HOME/TestDesigner

How did the install go?

Manual Install

If you are unable to use the Client Installer due to permission restrictions, manually configure as follows:

Download and install GraalVM version 11

  1. For help installing, go to https://github.com/graalvm/graalvm-ce-builds/releases/tag/vm-21.3.0 and select Java 11 Based windows link

  2. Once downloaded, extract the files.

  3. Place the extracted folder in C:/Program Files.

Set Environment Variables

  1. Locate the folder where graalvm 11 is copied over (in the C:/Program Files from the step above)

    1. For example C:\Program Files\graalvm-ce-java11-windows-amd64-21.3.0\graalvm-ce-java11-21.3.0

  2. Click Start, enter Environment Variables, and select Edit System Environment Variables
    The System Properties window appears

  3. Select the Advanced tab and click Environment Variables

  4. In the System Variables section, click New
    The New System Variable window appears

  5. Enter JAVA_HOME in the Variable name box


  6. Enter your Java install path, noted above, in the Variable value box

    1. For example C:\Program Files\graalvm-ce-java11-windows-amd64-21.3.0\graalvm-ce-java11-21.3.0

  7. In the System Variables list, select the Path variable and click Edit

  8. Enter your Java path, appended by \bin; at the beginning of the Variable value box.
    For example: C:\Program Files\graalvm-ce-java11-windows-amd64-21.3.0\graalvm-ce-java11-21.3.0\bin;

  9. To confirm Java installed properly

    1. Select Start, enter cmd and select Command Prompt

    2. When the Command Prompt window appears, enter java -version and press Enter
      The Java install details display

    GraalVm 11 should be successfully installed to continue

Update Java Settings

In order to avoid or minimize Java warning messages, please follow these steps:

  1. Click Start, enter Java, and select Configure Java

  2. Select the Advanced tab and update the settings as follows:

    1. Scroll to Execution Environment Security Settings

      1. Uncheck Show sandbox warning banner

      2. Uncheck Warn if site certificate does not match hostname

    2. Scroll to Mixed code (sandboxed vs. trusted) security verification and select Disable verification

    3. Scroll to Perform signed code certificates revocation check on and select Do not check

    4. Scroll to Perform TLS certificates revocation check on and select Do not check

  3. Click OK

Adding a Trusted Site

Windows

  1. Click Start, enter Internet Op and select Internet Options

  2. Select Security

  3. Click Trusted Sites

  4. Click Sites

  5. Enter the URL for the application under test (i.e. The application you wish to test)

  6. Click Add

  7. Click Close

  8. Click OK

Installing Appvance Certificate

Edge and Chrome

  1. Retrieve the certificate from the Appvance IQ controller

    • If hosted by Appvance, you may need to request the certificate from your Appvance contact

    • If hosting your own install, request the certificate used when setting up the Appvance Controller

  2. Close all browsers

  3. Double click the certificate file appvance.cer

  4. Click Install Certificate
    The Certificate Import Wizard window appears

  5. Click Next

  6. In the Store Location box select Local Machine, select Place all certificates in the following store and click Browse

    1. The Select Certificate Store window appears

  7. Select Trusted Root Certification Authorities and click OK

  8. Click Next

  9. With Certificate Store Selected by User selected, click Finish

Firefox

Firefox does not use OS-level certificates, but instead maintains its own

  1. Open Firefox

  2. Go to Menu > Options > Advanced > Certificates

  3. Click View Certificates
    The Certificate Manager window appears

  4. Select the Authorities tab and click Import

  5. Browse to and select the appvance.cer file

    • If hosted by Appvance, you may need to request the certificate from your Appvance contact

    • If hosting your own install, request the certificate used when setting up the Appvance Controller

  6. Check all options and click OK

  7. The Appvance 2020 should be visible in certificates list

  8. Click OK

  9. Restart Firefox