13.2 Upgrading Access Gateway Service on Windows

13.2.1 Upgrading the Evaluation Version to the Purchased Version

If you have downloaded the evaluation version and want to keep your configuration after purchasing the product, you need to upgrade each of your components with the purchased version. The upgrade to the purchased version automatically changes your installation to a licensed version.

After you have purchased the product, log in to the Novell Customer Center and follow the link that allows you to download the product. Then follow the instructions in Section 13.2.2, Upgrading Access Gateway Service.

13.2.2 Upgrading Access Gateway Service

Log in to the NetIQ Downloads page and follow the link that allows you to download the product.

You can upgrade by using the same installer you used to install the product. The program detects that Access Gateway Service is already installed and prompts you to upgrade.

IMPORTANT:Windows packages KB2919442 and KB2919355 must be installed before upgrading Access Gateway Service. These packages must be installed in the same sequence. You can verify if these packages are installed by using the following commands:

  • dism /online /get-packages | findstr KB2919442

  • dism /online /get-packages | findstr KB2919355

If these packages are installed, you will get a confirmation message. If the packages are not installed, you will not receive any response.

  1. Download and run AM_44_AccessGatewayService_Win64.exe file from NetIQ.

  2. Run the installation program. When the installation program detects an installed version of Access Gateway, it automatically prompts you to upgrade.

  3. Answer Yes to the prompt to upgrade.

  4. Read the Introduction, then click Next.

  5. Review the Readme information, then click Next.

  6. Accept the License Agreement, then click Next.

  7. Specify the following information:

    User ID: Specify the name of the administration user for Administration Console.

    Password and Re-enter Password: Specify the password and re-enter the password for the administration user account.

  8. Review the installation summary, then click Install.

    Access Gateway Service is upgraded.

    IMPORTANT:The httpd.conf file is overwritten with a new file because Access Manager 4.4 upgrades Apache 2.2 to Apache 2.4 to support WebSocket. A backup of the existing httpd.conf file is available at C:\nambkup.

  9. View the log files. The install logs are located in the C:\Program Files\Novell\log and C:\agsinstall.log directories.

  10. Restore any customized files from the backup taken earlier.

    To restore the files, copy the content of the following files to the corresponding file in the new location.

    server.xml:

    If you have customized the server.xml file from the backup taken in 4.2.x or 4.3.x, ensure that you apply the same to the new server.xml located at C:\Program Files\Novell\Tomcat\conf\ directory.

    An example below shows that the IP address is removed and ciphers added.<Connector NIDP_Name="connector" port="8443" address="" ciphers="SSL_RSA_WITH_RC4_128_MD5, SSL_RSA_WITH_RC4_128_SHA, ... ../>

    Tomcat properties:

    Go to C:\Program Files\Novell\Tomcat\bin. Click the tomcat7w (for 4.1.x) or the tomcat8w (for 4.2.x and 4.3.x) file and make a note of any elements or attributes that are customized.

    On the 4.4 server, go to C:\Program Files\Novell\Tomcat\bin\tomcat8w. Change the values and attributes as required.

  11. Restart the tomcat server by using the Windows service. Go to Start > Control Panel > System and Security > Administrative Tools > Services.