Installation and Upgrade Guides › SiteMinder Upgrade Guide › Upgrading from CA SiteMinder® r12.x › How to Migrate from r12.x › Upgrade an r12.x Administrative UI

Upgrade an r12.x Administrative UI

The following sections detail how to upgrade the Administrative UI on Windows and UNIX.

Before You Upgrade

Consider the following items before you upgrade the Administrative UI:

• Important! Review the Administrative UI upgrade paths.
• Upgrade the Administrative UI using the installation media on the Technical Support site.

  Note: For a list of installation media names, see the Policy Server Release Notes.

• (Embedded JBoss installations only) Extract the contents of the prerequisite installer into the same directory that you extracted the contents of the Administrative UI installer. The contents of each installer zip file must be in the same location as the layout.properties file. The layout.properties file, which is included with the Administrative UI installation zip, must always be co-located with both executables or the installation fails.
• (Windows) Run the installer from the Administrative UI host system. Do not run the installer from a mapped network share or UNC path.
• (Linux) Be sure that the required Linux libraries are installed to the Administrative UI host system. For more information, see Required Linux Libraries.
• Important! (UNIX) Depending on your permissions, run the following command to add executable permissions to the directory that contains the installation media:

  chmod -R+x directory
  

  directory

  Specifies the directory that contains the installation media.

• (UNIX) If you execute the Administrative UI installer across different subnets, it can crash. Run the Administrative UI installer directly on the host system.

Required Linux Libraries

Certain library files are required for components operating on Linux operating environments. Failure to install the correct libraries can cause the following error:

java.lang.UnsatisfiedLinkError 

If you are installing, configuring, or upgrading a Linux version of this component, the following packages are required on the host system:

Red Hat 5.x:

• compat–gcc-34-c++-3.4.6-patch_version.I386
• libstdc++-4.x.x-x.el5.i686.rpm
• libidn.so.11.rpm
• ncurses

Red Hat 6.x:

• libstdc++-4.x.x-x.el6.i686.rpm
• libidn-1.18-2.el6.i686
• libXext.i686.rpm
• libXrender.i686.rpm
• linXtst.i686.rpm
• libidn.so.11.rpm
• ncurses

Additionally, for Red Hat 6.x (64-bit):

All the RPM packages that are required for 64-bit Red Hat 6.x are 32-bit packages.

• libXau-1.0.5-1.el6.i686.rpm
• libxcb-1.5-1.el6.i686.rpm
• compat-db42-4.2.52-15.el6.i686.rpm
• compat-db43-4.3.29-15.el6.i686.rpm
• libX11-1.3-2.el6.i686.rpm
• libXrender-0.9.5-1.el6.i686.rpm
• libexpat.so.1 (provided by expat-2.0.1-11.el6_2.i686.rpm)
• libfreetype.so.6 (provided by freetype-2.3.11-6.el6_2.9.i686.rpm)
• libfontconfig.so.1 (provided by fontconfig-2.8.0-3.el6.i686.rpm)
• libICE-1.0.6-1.el6.i686.rpm
• libuuid-2.17.2-12.7.el6.i686.rpm
• libSM-1.1.0-7.1.el6.i686.rpm
• libXext-1.1-3.el6.i686.rpm
• compat-libstdc++-33-3.2.3-69.el6.i686.rpm
• compat-db-4.6.21-15.el6.i686.rpm
• libXi-1.3-3.el6.i686.rpm
• libXtst-1.0.99.2-3.el6.i686.rpm
• libXft-2.1.13-4.1.el6.i686.rpm
• libXt-1.0.7-1.el6.i686.rpm
• libXp-1.0.0-15.1.el6.i686.rpm
• libstdc++.i686.rpm
• compat-libtermcap.rpm
• libidn.i686.rpm
• ncurses

Upgrade the Administrative UI on Windows

Follow these steps:

1. (Embedded JBoss setups only). Verify that you extracted the prerequisite installer zip into the same directory that you extracted the Administrative UI installer zip. The layout.properties file, included with the Administrative UI installation zip, must be located in the same directory as both executables.

   Note: If you move the prerequisite or Administrative UI installation executables after extracting the zips, move the layout.properties file to the same location.

2. Exit all applications that are running.
3. Stop the application server that is hosting the Administrative UI.

   Note: For information about stopping and starting the embedded JBoss application server, see the r12.x Policy Server Installation Guide. For information about stopping an existing application server, see the vendor-specific documentation.

4. For embedded JBoss installations only, run the following executable and follow the installer prompts. Otherwise, skip to the next step.

   adminui-pre-req-version-cr-win32.exe
   

5. Run the following executable:

   ca-adminui-version-cr-win32.exe
   

6. Follow the installer prompts and confirm upgrade of the Administrative UI.
7. Review the installation settings and click Install.
8. For existing application servers, restart the application server after the installation is complete.

   Note: The embedded JBoss application server automatically restarts after the installation is complete.

The Administrative UI is upgraded.

Upgrade the Administrative UI on UNIX

You can install the Administrative UI on UNIX platforms in GUI or Console mode.

Follow these steps:

1. (Embedded JBoss setups only). Verify that you extracted the prerequisite installer zip into the same directory that you extracted the Administrative UI installer zip. The layout.properties file, included with the Administrative UI installation zip, must be located in the same directory as both executables.

   Note: If you move the prerequisite or Administrative UI installation executables after extracting the zips, move the layout.properties file to the same location.

2. Exit all applications that are running.
3. Stop the application server that is hosting the Administrative UI.

   Note: For information about stopping and starting the embedded JBoss application server, see the r12.x Policy Server Installation Guide. For information about stopping an existing application server, see the vendor-specific documentation.

4. For embedded JBoss installations only, run the prerequisite installer. Otherwise, skip to the next step.
   1. Open a shell and navigate to one of the following prerequisite installation executables:

      adminui-pre-req-version-cr-linux.bin
      adminui-pre-req-version-cr-sol.bin
      

   2. Enter the command for the appropriate mode:

      GUI Mode

      ./prerequisite_installation_media
      

      Console Mode

      ./prerequisite_installation_media -i console
      

   3. Follow the prerequisite installer prompts.
5. Open a shell and navigate to one of the following installation executables:

   ca-adminui-version-cr-linux.bin
   

   ca-adminui-version-cr-sol.bin
   

6. Enter the command for the appropriate mode:

   GUI Mode

   ./installation_media
   

   Console Mode

   ./installation_media -i console
   

7. Follow the prompts and confirm the upgrade of the Administrative UI.
8. Review the installation settings and click Install.
9. Start the application server that is hosting the Administrative UI.

   Note: For information about stopping and starting the embedded JBoss application server, see the r12.x Policy Server Installation Guide. For information about stopping an existing application server, see the vendor-specific documentation.

   The Administrative UI is upgraded.