Web Services Security Guides › CA SiteMinder® Web Services Security Upgrade Guide › Upgrading from CA SOA Security Manager r12.1 SP3 › How to Migrate from SOA Security Manager r12.1 SP3 › How to Upgrade a SOA Security Manager r12.1 SP3 Administrative UI

How to Upgrade a SOA Security Manager r12.1 SP3 Administrative UI

Complete the following procedures to upgrade an r12.1 SP3 Administrative UI to 12.52 SP1 on Windows and UNIX.

1. Verify that you are prepared for the upgrade
2. Verify that required libraries are present on Linux systems
3. Upgrade the Administrative UI on Windows
4. Upgrade the Administrative UI on UNIX using a GUI
5. Upgrade the Administrative UI on UNIX using a console

Before You Upgrade

Consider the following items before you upgrade the Administrative UI:

• Important! Review the Administrative UI upgrade options.
• 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.

• Extract the executable for the prerequisite installer into the same directory that you extracted the Administrative UI installer. The installers must be in the same location so that the layout.properties file, included with the installation zip, is co-located with both executables.

  The installation zip contains a layout.properties file at the same level as the installation media. If you moved the installation media after extracting the installation zip, move the properties file to the same location 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.

More information:

Locate the Installation Media

Installation Media Names

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

Be sure that you extracted the prerequisite installer executable into the same directory that you extracted the Administrative UI installer. The installers must be in the same location so that the layout.properties file, included with the Administrative UI installation zip, is co-located with both executables.

If you move the prerequisite or Administrative UI installation media after extracting the zips, move the executables and the layout.properties file to the same location. Both executables and the layout.properties file must be co-located or the stand-alone installation fails.

Upgrading the Administrative UI requires that you run a prerequisite installer and the Administrative UI installer.

Follow these steps:

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

   Note: For more information about stopping the application server, see the r12.x Policy Server Installation Guide.

3. Run the following executable:

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

4. Follow the prerequisite installer prompts.
5. Run the following executable:

   ca-adminui-version-cr-win32.exe
   

6. Follow the installer prompts and confirm the upgrade of the Administrative UI.
7. Review the installation settings and click Install.

   The Administrative UI is upgraded.

Upgrade the Administrative UI on UNIX

Be sure that you extracted the prerequisite installer executable into the same directory that you extracted the Administrative UI installer. The installers must be in the same location so that the layout.properties file, included with the Administrative UI installation zip, is co-located with both executables.

If you move the prerequisite or Administrative UI installation media after extracting the zips, move the executables and the layout.properties file to the same location. Both executables and the layout.properties file must be co-located or the stand-alone installation fails.

You can upgrade the Administrative UI in GUI or console mode.

Follow these steps:

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

   Note: For more information about stopping the application server, see the r12.x Policy Server Installation Guide.

3. 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
   

4. Enter the command for the appropriate mode:

   GUI Mode

   ./prerequisite_installation_media
   

   Console Mode

   ./prerequisite_installation_media -i console
   

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

   ca-adminui-version-cr-linux.bin
   

   ca-adminui-version-cr-sol.bin
   

7. Enter the command for the appropriate mode:

   GUI Mode

   ./installation_media
   

   Console Mode

   ./installation_media -i console
   

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

    Note: For more information about starting the application server, see the 12.52 SP1 Policy Server Installation Guide.

    The Administrative UI is upgraded.

Upgrade the Administrative UI on UNIX Using a Console

Be sure that you extracted the prerequisite installer executable into the same directory that you extracted the Administrative UI installer. The installers must be in the same location so that the layout.properties file, included with the Administrative UI installation zip, is co-located with both executables.

If you move the prerequisite or Administrative UI installation media after extracting the zips, move the executables and the layout.properties file to the same location. Both executables and the layout.properties file must be co-located or the stand-alone installation fails.

Upgrading the Administrative UI requires that you run a prerequisite installer and the Administrative UI installer.

Follow these steps:

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

   Note: For more information about stopping the application server, see the r12.x Policy Server Installation Guide.

3. 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
   

4. Enter the following command:

   ./prerequisite_installation_media -i console
   

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

   ca-adminui-version-cr-linux.bin
   ca-adminui-version-cr-sol.bin
   

7. Enter the following command:

   ./installation_media -i console
   

8. Follow the prompts and confirm that the installer can upgrade the Administrative UI.
9. Review the installation settings and press Enter.
10. Start the application server that is hosting the Administrative UI.

    Note: For more information about starting the application server, see the 12.52 SP1 Policy Server Installation Guide.

    The Administrative UI is upgraded.