Transact

⌘K
  1. Home
  2. Transact
  3. Install and Upgrade
  4. Additional Resources
  5. Windows
  6. UAC, Environment Variable, and IPv6 Prerequisite Checks in the Ephesoft Transact Windows Installer

UAC, Environment Variable, and IPv6 Prerequisite Checks in the Ephesoft Transact Windows Installer

Transact Versions: 4.5.0.0-2020.1.02

The Ephesoft Transact Windows installer for versions 4.5.0.0 through 2020.1.02 checks the UAC, Environment Variable, and IPv6 settings to ensure successful installation of Transact and its license. During installation, the Ephesoft Prerequisites Check screen will appear. It will contain the results for the following three checks:

  1. UAC (User Account Control) Check is performed to ensure that UAC is turned off, which is required for Ephesoft Transact installation. If UAC is on, the error message will be displayed. The user will need to finish the installation and then restart it after changing the UAC settings. This check applies to both fresh and upgrade installations. When completing a silent Transact installation, if the check fails, the details will be registered in the logs and installation will stop.
  2. Environment Variable Check is done to confirm whether JAVA_HOME environment variable has been defined. If it has already been set by the user, the warning will be displayed informing the user that the installer will update/overwrite this environment variable. Since it is just a warning, the installation process will continue. When completing a silent Transact installation, the warning message will be saved in the logs and installation will continue.
  3. IPv6 Check is done to confirm whether IPv6 is disabled in the system. If IPv6 is enabled, then the warning message is displayed prompting the user to disable it. Since this is just a warning, it will not impact the installation. However, there might be some issues with Transact license installation but the user can continue even if IPv6 is enabled. When completing a silent Transact installation, the warning message will be saved in the logs and installation will continue.

If all prerequisite checks completed successfully, the Ephesoft Prerequisites Check message will look as follows:

If any of the three prerequisite checks fail, then the Ephesoft Prerequisites Check message will appear indicating which prerequisite or prerequisite failed. In the example below, the Disable UAC prerequisite check failed.

Resolving Ephesoft Prerequisite Check Issues

Follow the steps below to resolve any prerequisite check issues.

Disable UAC

If the UAC Check fails, the Next button in the Ephesoft Prerequisites Check will be disabled until UAC is turned off. If you click the Details button, the following message is displayed:

Click Finish to stop the installation process and then disable UAC. To disable UAC, go to the Control Panel System and Security Security and Maintenance and select Change User Account Control Settings. Move the slider to Never notify and click OK.

Once the changes are saved, restart the Transact installer. The Next button in the Ephesoft Prerequisites Check is now enabled. Click Next to finish the installation.

Environment Variable

If Environment Variable check fails, you will receive a warning message. However, the Next button of the Ephesoft Prerequisites Check will not be disabled and the installation process can be continued without making any changes. However, the Transact installer will delete the existing JAVA_HOME environment variable. If you click the Details button, the following message will be displayed:

You can also cancel the installation if you do not want your JAVA_HOME environment variable to be modified. You can check your variables settings by going to the Control Panel All Control Panel Items System and selecting Advanced system settings. In the System Properties window, click Environment Variables…

If the existing JAVA_HOME environment variable is deleted, the prerequisite check will pass and the Ephesoft Prerequisites Check screen will look as follows:

Note: During installation, the required Environment Variable in the system is set according to the Transact installation folder. The Ephesoft Transact installer includes the setEnv.vbs file, which contains various paths and placeholder @@INSTALL_DIR@@. @@INSTALL_DIR@@ the Transact installer will replace @@INSTALL_DIR@@ with Transact installation folder path (for example, d:ephesoft):

In rare cases, an internal error may cause the installer to not update these placeholders. If this happens, then the installer will not set the Environment Variable, stop the installation, or initiate rollback during an upgrade. You will need to identify and remove the root cause of the internal error before you can continue with the installation.

Disable IPV6

If the IPv6 Check fails, then the following message will appear:

You can see more information by clicking the Details button in the Ephesoft Prerequisites Check screen. You can resolve this issue by following the steps provided in the License Issue with IPv6 article to disable IPv6.

Alternatively, go to the Control Panel Network and Internet Network and Sharing Center, and select your connection to view Status details.

ephesoft.com/…ocs/license-issue-with-ipv6

In the popup window, click Properties. In the Properties window, disable Internet Protocol Version 6 and click OK.

Once the changes are saved, the Ephesoft Prerequisites Check screen will look as follows:

Click Next to proceed with the installation process.