Installing the server and verifying the upgrade

To complete the process of upgrading the server to V8.1, you must install the V8.1 server. Then, verify that the upgrade was successful by starting the server instance.

Before you begin

You must be logged on to the system by using the root user ID.

You must be logged on to the system with the administrative user ID that was used to install the previous server.

You can obtain the installation package from an IBM® download site.

Set the system user limit for maximum file size to unlimited to ensure that the files can be downloaded correctly.

1. To query the maximum file size value, run the following command:

   ulimit -Hf

2. If the system user limit for maximum file size is not set to unlimited, change the setting to unlimited by completing the instructions in the documentation for your operating system.

1. Download the appropriate package file from one of the following websites:
   • Download the server package from Passport Advantage® or Fix Central.
   • For the most recent information, updates, and maintenance fixes, go to the IBM Support Portal.
2. Complete the following steps:

   

   

   1. Verify that you have enough space to store the installation files when they are extracted from the product package. For space requirements, see the download document for your product.
      • IBM Spectrum Protect technote 588021
      • IBM Spectrum Protect Extended Edition technote 588023
      • IBM Spectrum Protect for Data Retention technote 588025
   2. Download the package file to the directory of your choice. The path must contain no more than 128 characters. Be sure to extract the installation files to an empty directory. Do not extract to a directory that contains previously extracted files, or any other files.

      Also, ensure that you have executable permission for the package file.

   3. If necessary, run the following command to change the file permissions:

      chmod a+x package_name.bin

      where package_name is like the following example:

      8.1.x.000-IBM-SPSRV-AIX.bin

      

      8.1.x.000-IBM-SPSRV-Linuxs390x.bin
      8.1.x.000-IBM-SPSRV-Linuxx86_64.bin
      8.1.x.000-IBM-SPSRV-Linuxppc64le.bin 

      In the examples, 8.1.x.000 represents the product release level.
   4. Extract the installation files by running the following command:

       ./package_name.bin

      The package is large. Therefore, the extraction takes some time.

   

   

   1. Verify that you have enough space to store the installation files when they are extracted from the product package. For space requirements, see the download document for your product.
      • IBM Spectrum Protect technote 588021
      • IBM Spectrum Protect Extended Edition technote 588023
      • IBM Spectrum Protect for Data Retention technote 588025
   2. Change to the directory where you placed the executable file.
      Tip: In the next step, the files are extracted to the current directory. The path must contain no more than 128 characters. Be sure to extract the installation files to an empty directory. Do not extract to a directory that contains previously extracted files, or any other files.
   3. To extract the installation files, double-click the executable file:

      package_name.exe

      Where package_name is similar to the following example:

      8.1.x.000-SPSRV-WindowsX64.exe

      The package is large. Therefore, the extraction takes some time.

3. To ensure that the IBM Spectrum Protect wizards work correctly, verify that the following command is enabled: lsuser
4. Install the IBM Spectrum Protect software by using one of the following methods. Install the IBM Spectrum Protect license during the installation process.
   Tip: If you have multiple server instances on your system, install the IBM Spectrum Protect software only one time to upgrade all server instances.

   Installation wizard

   To install the server by using the graphical wizard of IBM Installation Manager, follow the instructions in Installing IBM Spectrum Protect by using the installation wizard.

   To install the server by using the graphical wizard of IBM Installation Manager, follow the instructions in Installing IBM Spectrum Protect by using the installation wizard.

   To install the server by using the graphical wizard of IBM Installation Manager, follow the instructions in Installing IBM Spectrum Protect by using the installation wizard.

   Ensure that your system meets the prerequisites for using the installation wizard. Then, complete the installation procedure. In the IBM Installation Manager window, click the Update or Modify icon.

   Installing the server by using the console mode

   To install the server by using the console mode, follow the instructions in Installing Tivoli® Storage Manager by using console mode.

   To install the server by using the console mode, follow the instructions in Installing Tivoli Storage Manager by using console mode.

   To install the server by using the console mode, follow the instructions in Installing Tivoli Storage Manager by using console mode.

   Review the information about installing the server in console mode and then complete the installation procedure.

   Silent mode

   To install the server by using silent mode, follow the instructions in Installing Tivoli Storage Manager in silent mode.

   To install the server by using silent mode, follow the instructions in Installing Tivoli Storage Manager in silent mode.

   To install the server by using silent mode, follow the instructions in Installing Tivoli Storage Manager in silent mode.

   Review the information about installing the server in silent mode and then complete the installation procedure.

   After you install the software, you do not have to reconfigure the system.

5. Correct any errors that are detected during the installation process.

   If you installed the server by using the installation wizard, you can view installation logs by using the IBM Installation Manager tool. Click File > View Log. To collect log files, from the IBM Installation Manager tool, click Help > Export Data for Problem Analysis.

   If you installed the server by using console mode or silent mode, you can view error logs in the IBM Installation Manager log directory, for example:

   • /var/ibm/InstallationManager/logs
   • C:\ProgramData\IBM\Installation Manager\logs
6. Go to the IBM Support Portal to obtain fixes. Click Fixes, updates, and drivers and apply any applicable fixes.
7. Verify that the upgrade was successful:
   1. Start the server instance.

      For instructions, see Starting the server instance.

      For instructions, see Starting the server instance.

   2. Monitor the messages that the server issues as it starts. Watch for error and warning messages, and resolve any issues.
   3. Verify that you can connect to the server by using the administrative client. To start an administrative client session, run the following IBM Spectrum Protect administrative command:

      dsmadmc

   4. To obtain information about the upgraded system, run QUERY commands.
      For example, to obtain consolidated information about the system, run the following IBM Spectrum Protect administrative command:

      query system

      To obtain information about the database, run the following IBM Spectrum Protect administrative command:

      query db format=detailed

8. Verify that the upgrade was successful:
   1. Start the server instance. To start the server from the default directory, C:\Program Files\Tivoli\TSM, run the following IBM Spectrum Protect administrative command:

      dsmserv -k server_instance

      server_instance is the name of your server instance. Server1 is the default name for the first instance of the IBM Spectrum Protect server.

      If you plan to run the server as a service under the Local System account, the Local System account must be explicitly granted access to the server database. For instructions, see Starting the server by using Windows services.

   2. Monitor the messages that the server issues as it starts. Watch for error and warning messages, and resolve any issues.
   3. Verify that you can connect to the server by using the administrative client. To start an administrative client session, run the following IBM Spectrum Protect administrative command:

      dsmadmc

   4. To obtain information about the upgraded system, run QUERY commands.
      For example, to obtain consolidated information about the system, run the following IBM Spectrum Protect administrative command:

      query system

      To obtain information about the database, run the following IBM Spectrum Protect administrative command:

      query db format=detailed

9. Register the licenses for the IBM Spectrum Protect server components that are installed on your system by running the REGISTER LICENSE command:

   register license file=installation_directory/server/bin/component_name.lic

   where installation_directory specifies the directory in which you installed the component, and component_name specifies the abbreviation for the component.
   For example, if you installed the server in the default directory, /opt/tivoli/tsm, run the following command to register the license:

   register license file=/opt/tivoli/tsm/server/bin/tsmbasic.lic

   For example, if you installed IBM Spectrum Protect Extended Edition in the /opt/tivoli/tsm directory, run the following command:

   register license file=/opt/tivoli/tsm/server/bin/tsmee.lic

   For example, if you installed IBM Spectrum Protect for Data Retention in the /opt/tivoli/tsm directory, run the following command:

   register license file=/opt/tivoli/tsm/server/bin/dataret.lic

   Restriction:

   You cannot use the IBM Spectrum Protect server to register licenses for the following products:

   • IBM Spectrum Protect for Mail
   • IBM Spectrum Protect for Databases
   • IBM Spectrum Protect for ERP
   • IBM Spectrum Protect for Space Management

   The REGISTER LICENSE command does not apply to these licenses. The licensing for these products is done by IBM Spectrum Protect clients.
10. Register the licenses for the server components that are installed on your system by running the REGISTER LICENSE command:

    register license file=installation_directory\server\component_name.lic

    Where installation_directory specifies the directory in which you installed the component, and component_name specifies the abbreviation for the component.
    For example, if you installed the server in the default directory, c:\Program Files\Tivoli\TSM, run the following command to register the license:

    register license file=c:\Program Files\Tivoli\TSM\server\tsmbasic.lic

    For example, if you installed IBM Spectrum Protect Extended Edition in the c:\Program Files\Tivoli\TSM directory, run the following command:

    register license file=c:\Program Files\Tivoli\TSM\server\tsmee.lic

    For example, if you installed IBM Spectrum Protect for Data Retention in the c:\Program Files\Tivoli\TSM directory, run the following command:

    register license file=c:\Program Files\Tivoli\TSM\server\dataret.lic

    Restriction:

    You cannot use the IBM Spectrum Protect server to register licenses for the following products:

    • IBM Spectrum Protect for Mail
    • IBM Spectrum Protect for Databases
    • IBM Spectrum Protect for ERP
    • IBM Spectrum Protect for Space Management

    The REGISTER LICENSE command does not apply to these licenses. The licensing for these products is done by IBM Spectrum Protect clients.
11. Prepare the server for automatic and manual database backup operations.

    For instructions, see Preparing the server for database backup operations.

    For instructions, see Preparing the server for database backup operations.

    For instructions, see Preparing the server for database backup operations.

12. Verify that the PASSWORDACCESS GENERATE application programming interface (API) client option is not in the client options file. The default name for the client options file is dsm.opt and it is typically located in the c:\programdata\ibm\db2\db2tsm1\tsminst1 directory. Remove the PASSWORDACCESS GENERATE option if it is present.
13. Optional: To install an extra language package, use the modify function of the IBM Installation Manager.
14. Optional: To upgrade to a newer version of a language package, use the update function of the IBM Installation Manager.
15. To facilitate troubleshooting in case of any future issues, ensure that sufficient space is allocated for a core dump. For more information, see technote 6357399.