Answer

The following sections provide information needed to install IBM Data Server Manager, upgrade an existing installation of IBM Data Server Manager, and extend the functions by applying a license activation kit (LAK).

In the details that follow, replace <v.v.v> with the version you are installing or upgrading to and <platform> with your platform:

With DSM 1.1.2.1, you use setup scripts for both fresh installs and upgrades. Running these scripts when upgrading creates backups of the following essential directories:

• config
• dscomponents
• dscomponents_with_rep
• java

These scripts also relocate DSM binaries to the appropriate directories, to prevent leftover contents from interfering with DSM operations and to help keep DSM folder size under control.
Note: When upgrading, copies of the original config, dscomponents, dscomponents_with_rep and java directories are saved in your <installdirectory>/dsm_bak directory.

New installation of IBM Data Server Manager

To complete your first installation of IBM Data Server Manager:

1. From https://www.ibm.com/services/forms/preLogin.do?source=swg-rddsm, download the package ibm-datasrvmgr-<platform>. Alternatively, from Passport Advantage, download the package: ibm-dsm-ee-and-lak-<platform> for Enterprise Edition or ibm-dsm-base-<platform> for Base Edition
2. Extract the package contents.

   The extracted package expands into a /ibm-datasrvrmgr installation directory. For example, if you extract the package contents into C:\, the IBM Data Server Manager product expands into C:\ibm-datasrvrmgr. For the remainder of this Technote, the installation directory is referred to as <installdirectory>

3. Optionally review and modify <installdirectory>\setup.conf. The server parameters in this file have default values. For a silent install, you must make any modifications before running setup.

   Note: To apply any license activation kits, see Applying license activation kits. When finished, continue as follows.

4. From the installation directory, run the setup script and follow the prompts. To run in a terminal window, run setup -silent.

   Note: You can use HTTPS with SSL security exclusively to connect to your Data Server Manager installation. To do so, enter the following values in your <installdirectory>/Config/dswebserver.properties file:

   • cookie.secureOnly=true
   • port=-1
   Your IBM Data Server Manager server is ready for use.

Upgrading IBM Data Server Manager to the latest release or iFix

To upgrade IBM Data Server Manager to the latest release or iFix:

1. Download the IBM Data Server Manager upgrade package: <v.v.v>-IM-Data_Server_Manager-<platform>.
2. Stop the Data Server Manager server or service.
3. If Data Server Manager is running as a Windows service, run <installdirectory>/bin/stopservice. Otherwise, run <installdirectory>/bin/stop.
4. Run <installdirectory>/bin/status, to verify that the service has stopped.

   Note: If you have customized any of the scripts in your existing DSM /bin folder, you will need to make a backup of these files before proceeding with the upgrade, as the upgrade process will overwrite your changes. Once the upgrade is complete, you can migrate your changes over to the newly created versions.

5. Extract the contents of the IBM Data Server Manager package into the previous install directory. Allow the files to be overwritten and replaced.
6. From the install directory, run the setup script.
7. Start the Data Server Manager server or service. If Data Server Manager is running as a Windows service, run <installdirectory>/bin/startservice. Otherwise, run <installdirectory>/bin/start.

The upgrade is complete and your IBM Data Server Manager server is ready for use. When the upgrade is complete, we recommended that all users flush their web browser caches to remove any cached content. You can do this by starting a web browser session, pressing CTRL+SHIFT+DEL, and following the prompts.

Applying IBM Data Server Manager license activation kits

Apply a license activation kit (LAK) to enable additional features such as repository persistence, historical monitoring, and more.

To apply an LAK:

1. Go to the Passport Advantage site and download the entitled license activation kit packages, use the ibm-dsm-lak-only-<platform> LAK.
2. Stop the Data Server Manager server or service.

   If Data Server Manager is running as a Windows service, run <installdirectory>/bin/stopservice. Otherwise, run <installdirectory>/bin/stop.

3. Verify that the server is stopped, by running <installdirectory>/bin/status.
4. Apply the enterprise license activation kit:
   • If Data Server Manager already was up & running, extract each entitled license activation kit into your install directory. Allow files to be overwritten and replaced.
   • If setup.sh/setup.bat is not yet executed, extract each entitled license activation kit into the <installdirectory>/<corresponding>_tmp directories. Allow files to be overwritten and replaced.

     For example, the Config and dscomponents, license folders in the license activation kit should be extracted to Config_tmp, dscomponents_tmp and license_tmp folders in your install directory. The rest of the LAK remains to be extracted into your installation directories.

5. From the install directory, run the setup script to start the Data Server Manager server or service.
6. If Data Server Manager is running as a Windows service, run /bin/startservice. Otherwise, run /bin/start.

   Your IBM Data Server Manager license activation kits have been applied.

   Note: In case of installation failure, you may:

   • Verify that a copy of original Config, dscomponents, dscomponents_with_rep and java directories are saved in <installdirectory>/dsm_bak directory.
   • Remove Config, dscomponents, dscomponents_with_rep and java directories from <installdirectory>.
   • Move Config, dscomponents, dscomponents_with_rep and java directories from <installdirectory>/dsm_bak to <installdirectory>.
   • Remove<installdirectory>/dsm_bak.
   • Repeat steps from New Installation of IBM Data Server Manager.