Prerequisite: Before upgrading Access Manager Appliance, perform the following actions:
If you are upgrading Access Manager, and want to use syslog for auditing, you must first upgrade the base operating system.
If you have customized the tomcat.conf file or the server.xml file, back up these files before upgrading. These files are overwritten during the upgrade process.
NOTE:Platform Agent and Novell Audit are no longer supported. Access Manager 4.2 onwards, the installation no longer installs Platform Agent and Novell Audit for auditing. If you upgrade from an older version of Access Manager to 4.5, Platform Agent is still available. It is recommended to use syslog for auditing. For more information about auditing, see Auditing in the NetIQ Access Manager Appliance 4.5 Administration Guide.
IMPORTANT:If you are using SQL database and you are upgrading to Access Manager 4.5, you must run a utility to re-factor the database. This is to ensure that Access Manager and its associated products use the same naming convention.
Perform the following steps to upgrade Access Manager Appliance.
Log in as the root user.
Download the tar.gz file of Access Manager Appliance from Software Licenses and Downloads and extract the tar.gz file using the following command:
tar -xzvf <filename>
NOTE:For information about the name of the file, see the specific Release Notes on theAccess Manager Appliance Documentation website.
Change to the directory where you extracted the file, then run the following command:
./sb_upgrade.sh
The system displays the following confirmation message:
Would you like to continue this upgrade (y/n)? [y]:
Type Y to continue with the upgrade, then press Enter.
Enter the Access Manager Administration Console user ID.
Enter the Access Manager Administration Console password.
Re-enter the password for verification.
The system displays the following confirmation message:
Do you want to back up the configuration before the upgrade (y/n)?
Type Y and press Enter.
The system displays the following message when the upgrade is complete:
Upgrade completed successfully.
NOTE:
If you have customized the Java settings in the /opt/novell/nam/idp/conf/tomcat.conf file, then copy the customized setting to the new file after the upgrade.
If OAuth and OpenID Connect protocol is enabled, then after upgrading you must update Administration cluster to use the JSON Web Token (JWT token). For more information about JWT token, see Understanding How Access Manager Uses OAuth and OpenID Connect in the NetIQ Access Manager Appliance 4.5 Administration Guide.
NOTE:If you have enabled history for risk-based authentication in a prior version of Access Manager, you must upgrade the database for risk-based authentication after upgrading to 4.5. You can find the upgrade script here: /opt/novell/nids/lib/webapp/WEB-INF/RiskDBScripts.zip.
MySQL: Run netiq_risk_mysql_upgrade.sql
Oracle: Run netiq_risk_oracle_upgrade.sql
Microsoft SQL Server: Run netiq_risk_sql_server_upgrade.sql
NOTE:To use Syslog for auditing, you need to upgrade the base operating system. After the upgrade, install the Syslog RPMs manually. To install the RPMs, execute the following command: zypper in -t pattern NetIQ-Access-Manager.