PathWave ADS 2023 Update 1.2 Installation Instructions

Purpose

This document describes the installation instructions for ADS 2023 Update <1.x>, which needs to be installed on top of the existing ADS 2023 Update 1.0 installation. Also, if your ADS installation has any previous Updates already installed, it is not necessary to remove previous Updates before installing ADS 2023 Update <1.x>. ADS 2023 Update <1.x> can be installed on top-of existing Updates.

Prerequisite

ADS 2023 Update <1.x> installs on top of an existing ADS installation directory. Therefore, you need to install ADS 2023 Update 1.0 before installing the ADS 2023 Update <1.x>.

Precautions

Following is the list of precautions:

• Close ADS 2023 Update 1.0, kill all the background processes related to ADS 2023 Update 1.0, including Job Manager and Remote simulation, before installing the Update."
• Do not start ADS 2023 Update 1.x while the Update installation is in progress.
• Do not interrupt the Update installation while it is in progress.
• Disable/Minimize UAC in the case of Windows 10 before installing the Update.
• Make sure you need to clear the ADS directory (HPEESOF_DIR) after uninstalling the base (ADS2023 Update 1.0), to fresh install the updates.
• Make sure any of these listed processes are not running while installing the Update.
  ("hpeesofde" , "hpeesofemx" , "hpeesofdds" , "hpeesofhelp" , "hpeesofsim", "hpeesofsess","hpeesofpkg", "MomEngine", "agilent-vacomp", "eesofpvm*", "oaFSLockD.exe")

For more information, refer to the instruction notes under the Known Issues and Workaround topic.

Installing the ADS Update <1.x> on Windows

To install ADS Update on Windows:

1. Download the installer archive ads_2023_update<1.x>_win_x64.zip.
2. Extract the contents of the zip file.
   After extraction, a directory ads_2023_update<1.x>_win_x64 will be created.
3. To install ADS 2023 update<1.x>, you can run either of the two files.
   From an executable file "ads_2023_update<1.x>_win_x64.exe" under ads_2023_update<1.x>_win_x64 directory.
   or
   From a batch file "install_ads_2023_update<1.x>.bat" under the "hf_files" directory.
   In Windows 10:

1. 1. Run ads_2023_update<1.x>_win_x64.exe.
      The installer will be launched. Follow the installer screens till the completion.
      Or
   2. Right-click on "install_ads_2023_update<1.x>.bat" and select "Run as administrator".
      A Command window pops up. Follow the instruction till the completion. 

ADS 2023 update <1.x> installer does not support silent installation. To suppress the Update installer GUI, you can launch the Update installation from the command prompt using the batch file (install_ads_2023_update<1.x>.bat); however, this method is an interactive (non-silent) mode that requires your input. After installing ADS 2023 Update 1.2 on windows, the install size of ADS 2023 Update 1.0 will increase from 7.4 GB to 9.5 GB.

Verification of Successful Installation of ADS Update <1.x> on Windows

Launch the shortcut:

Start > All Programs > Advanced Design System 2023 Update 1 > ADS Tools > updates> Show list of installed updates and add-ons.
This shortcut will show the list of installed Updates on ADS 2023  Update 1.

Uninstalling the ADS Update <1.x> on Windows

To uninstall ADS Update<1.x> on Windows:

1. Open the hotfixes folder in the ADS installation directory.
2. Right-click on remove_ads_2023_update<1.x>.bat and select Run as administrator.
3. Enter ADS 2023 Update 1 installation directory location at the prompt.
4. Click Enter.
   The Update uninstallation process will start. Various status messages will be displayed during the uninstallation of the Update.
   At the end of successful uninstallation, a message "Update un-installed successfully" will be displayed.

Please do not close the batch window during Update uninstallation. This operation can make the ADS installation directory unusable. Un-install all the previously installed Updates before uninstalling the ADS base release, or if the ADS base release is uninstalled first, remove all the Update thrashes (folder) after uninstalling the ADS base release. Right-click on remove_all_updates.bat and select Run as administrator to uninstall all the previously installed Updates.

Installing the ADS Update <1.x> on Linux

1. Download the installer archive "ads_2023_update<1.x>Linux_x64.zip"
2. Open a terminal and set the HPEESOF_DIR environment variable to the existing ADS 2023 Update 1.0 installation directory.
   For example, Assuming ADS 2023 is installed at /disk1/ADS2023, HPEESOF_DIR=/disk1/ADS2023; export HPEESOF_DIR # bourne or K shell setenv HPEESOF_DIR /disk1/ADS2023 # C shell
3. Extract the contents of the zip file by running the following command on the terminal:
   unzip ads_2023_update<1.x>_Linux_x64.zip
4. After extraction, a directory "ads_2023_update<1.x>_linux_x64" will be created.
5. Change the directory to the "ads_2023_update<1.x>_linux_x64" and execute the shell script: "install_ads_2023_update<1.x>.sh" as follows:
   e.g: ./ install_ads_2023_update<1.x>.sh
   You will be prompted to confirm the Update installation. Please press "y" at the prompt.
6. Update Installation will start, and various messages will be displayed to indicate the progress. At the end of successful installation, a message "Update installed successfully" will be displayed.

Do not close the Update installation terminal while it is in progress. This can make the ADS installation directory unusable. After installing ADS 2023 Update 1.2 on Linux, the install size of ADS 2023 Update 1.0 will increase from 12 GB to 15 GB.

Verification of successful installation of ADS Update <1.x> on Linux

1. Open a terminal and Set the HPEESOF_DIR environment variable to ADS 2023 Update1.2 installation directory.
   For example, if ADS 2023 is installed at /disk1/ADS2023, then specify the following values for the HPEESOF_DIR Environment variable:
   HPEESOF_DIR=/disk1/ADS2023; export HPEESOF_DIR # bourne or K shell setenv HPEESOF_DIR /disk1/ADS2023 # C shell
2. Change the directory to "$HPEESOF_DIR/hotfixes" and execute the shell script:
   "list_installed_updates.sh".
   For example, /list_installed_updates.sh
3. You will see the list of Updates shown below:

List of regular Updates:

Uninstalling the ADS Update <1.x> on Linux

1. Open a terminal and set the HPEESOF_DIR environment variable to ADS 2023 Update 1.2 installation directory.
   For example, if ADS 2023 is installed at /disk1/ADS2023, then specify the following values for the HPEESOF_DIR environment variable:
   HPEESOF_DIR=/disk1/ADS2023; export HPEESOF_DIR # bourne or K shell setenv HPEESOF_DIR /disk1/ADS2023 # C shell
2. Change the directory to "$HPEESOF_DIR/hotfixes" and execute the shell script:
   "remove_ads_2023_update<1.x>.sh".
   For example, / remove_ads_2023_update<1.x>.sh
3. You will be prompted to confirm the Update removal. Press "y" at the prompt.

Update removal will start, and various messages will be displayed to indicate the progress. At the end of successful uninstallation, a message "update un-installed successfully" will be displayed.

Do not cancel the Update removal process while it is in progress. This can make the installation directory unusable. Un-install all the previously installed Updates before uninstalling the ADS base release, or if the ADS base release is uninstalled first, remove all the update thrashes (folder) after uninstalling the ADS base release. Execute remove_all_updates.sh to uninstall all the previously installed Updates.

Known Issues and Workarounds

Problem: ADS 2023 Update1.2 installation fails with the error message shown in the below screenshot

Platforms on which this error can be seen: Mostly on Windows.

Reason for the error: After uninstalling ADS 2023 Update 1.0, the ADS installation directory still exists with some directories/files. If ADS 2023 Update 1.0 is re-installed with the same installation directory name as before uninstallation, these old directories/files remain, and they interfere with the Update installation causing the above error.

Quick Workaround:

Using this workaround, Update can be installed successfully, and ADS will be usable as before. But in the future, if this Update is removed, then ADS will become unusable.

1. Click OK on the above error message and exit the installer.
2. Using explorer, please go inside <ADS installation directory>/tools/lib/blackbox2023U1.0
3. Delete the directory "prj_lists".
4. Install the Update, and the Update will be installed successfully.

Detailed solution:

1. Click OK on the above error message and exit the installer.
2. Un-install existing ADS 2023 Update 1.0 from the start menu.
3. After Uninstallation, using Windows explorer, delete the previous ADS installation directory.
4. Re-install ADS 2023 Update 1.0.
5. Install the ADS 2023 Update <1.x>, and the Update will be installed successfully. The above workaround/solution should help in resolving this issue.

The above workaround/solution should help in resolving this issue.

In the case of Windows, because of the permission issue UAC problem, Update  installation won't able to back up the old file while installing. Un-check/minimizing the UAC before installation will solve the problem.

Problem: ADS 2023 update <1.x> installed in Admin/Non-Admin Mode with UAC Enabled – ADS fails to invoke in Non-Admin Mode

Quick Workaround:

To un-check/minimize user account settings:

1. Go to Control Panel\All Control Panel Items\User Accounts and click Change User Account Control Setting.
   The User Account Control Settings window is displayed.
   
   
2. Move the Vertical Slider towards Never notify and click OK.