16.0 Upgrading Administration Console

Perform the following steps to upgrade Administration Console:

1. Back up any customized JSP pages and related files.

   Even though the upgrade program backs up the JSP directory and its related files in the /root/nambkup folder, it is a good practice to backup these files.

   /var/opt/novell/tomcat/webapps/nidp/jsp

2. Open a terminal window and log in as the root user.

3. Download the upgrade file from Micro Focus Downloads and extract the tar.gz file using the tar -xzvf <filename> command.

   NOTE:For information about the name of the upgrade file, see the specific Release Notes on the Access Manager Documentation website.

4. Change to the directory where you unpacked the file using the./upgrade.sh command.

5. A confirmation message is displayed with the list of installed components. For example, if Administration Console and Identity Server are installed on the same machine, the following message is displayed:

   The following components were installed on this machine 
   1. Access Manager Administration Console 
   2. Identity Server 
   Do you want to upgrade the above components (y/n)?

6. Type Y and press Enter.

   The system displays a warning message because the latest version of Access Manager uses stronger TLS protocols, ciphers, and other security settings.

   If you are using a BTRFS filesystem, the system displays a warning message that the BTRFS filesystem might cause performance issues with the eDirectory database. It is recommended to change the filesystem from BTRFS to any other available filesystem.

   For information about moving the existing database from BTRFS filesystem to any other available filesystem, see TID 7022755.

7. Type Y to continue with the upgrade, then press Enter.

   If you do not want to include the security configurations, then type n. This stops the upgrade.

8. Enter the Access Manager Administration Console user ID. For example, admin

9. Enter the Access Manager Administration Console password.

10. Re-enter the password for verification.

11. The system displays the following confirmation message:

    Do you want to back up the configuration before the upgrade (y/n)?

12. Type Y and press Enter.

13. The system displays the following message when the upgrade is complete:

    Upgrade completed successfully.

    NOTE:If the configuration backup fails, the system displays the following message:

    The configuration backup failed. Do you want to continue the upgrade without a backup (y/n)?

    You can complete the upgrade by typing Y. However, the configuration will not have a backup.

14. (Optional) To view the upgrade files:

    • To view the upgrade log files, see the files in the /tmp/novell_access_manager directory.

    • If you selected to back up your configuration and used the default directory, see the zip file in the /root/nambkup directory. The log file for this backup is located in the /var/log directory.

    • If Identity Server is installed on the same machine, the JSP directory was backed up to the /root/nambkup directory. The file is prefixed with nidp_jps and contains the date and time of the backup.