Upgrade an r12.x Administrative UI

Installation and Upgrade Guides › SiteMinder Upgrade Guide › Upgrading from 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 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 libraries are required on the host system:

Red Hat 5.x

compat–gcc-34-c++-3.4.6-patch_version.I386

Red Hat 6.x (32-bit)

libstdc++-4.4.6-3.el6.i686.rpm

To have the appropriate 32-bit C run–time library for your operating environment, install the previous rpm.

Red Hat 6.x (64-bit)

libXau-1.0.5-1.el6.i686.rpm

libxcb-1.5-1.el6.i686.rpm

libstdc++-4.4.6-4.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

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:

Exit all applications that are running.
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.
Run the following executable:
```
adminui-pre-req-version-cr-win32.exe
```
Follow the prerequisite installer prompts.
Run the following executable:
```
ca-adminui-version-cr-win32.exe
```
Follow the installer prompts and confirm the upgrade of the Administrative UI.
Review the installation settings and click Install.
The Administrative UI is upgraded.

Upgrade the Administrative UI on UNIX

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

Follow these steps:

Exit all applications that are running.
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.
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
```

Enter the command for the appropriate mode:

GUI Mode

./prerequisite_installation_media

Console Mode

./prerequisite_installation_media -i console

Follow the prerequisite installer prompts.
Open a shell and navigate to one of the following installation executables:
```
ca-adminui-version-cr-linux.bin
```
```
ca-adminui-version-cr-sol.bin
```
Enter the command for the appropriate mode:
GUI Mode
```
./installation_media
```
Console Mode
```
./installation_media -i console
```
Follow the prompts and confirm the upgrade of the Administrative UI.
Review the installation settings and click Install.
Start the application server that is hosting the Administrative UI.
Note: For more information about starting the application server, see the r12.5 Policy Server Installation Guide.

The Administrative UI is upgraded.