Installing V8.1 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

AIX operating systems Linux operating systems You must be logged on to the system by using the root user ID.

Windows operating systems 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.

If you plan to download the files, set the system user limit for maximum file size to unlimited to ensure that the files can be downloaded correctly.

To query the maximum file size value, issue the following command:
```
ulimit -Hf
```
If the system user limit for maximum file size is not set to unlimited, change it to unlimited by following the instructions in the documentation for your operating system.

About this task

By using the IBM Spectrum Protect™ installation software, you can install the following components:

server
Tip: The database (DB2®), the Global Security Kit (GSKit) and IBM Java™ Runtime Environment (JRE) are automatically installed when you select the server component.
server languages
license
devices
IBM Spectrum Protect for SAN
Operations Center

Procedure

If you are obtaining the package from an IBM download site, download the appropriate package file from one of the following websites:
- Download the server package from Passport Advantage® or Fix Central.
- For the latest information, updates, and maintenance fixes, go to the IBM Support Portal.
If you are downloading the package from one of the download sites, 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 4042944
  - IBM Spectrum Protect Extended Edition technote 4042945
  - IBM Spectrum Protect for Data Retention technote 4042946
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, change the file permissions by issuing the following command:
```
chmod a+x package_name.bin
```
  where package_name is like the following example:
  
  8.1.x.000-IBM_Spectrum_Protect-SRV-AIX. bin
  
  8.1.x.000-IBM_Spectrum_Protect-SRV--Linuxs390x. bin 8.1.x.000-IBM_Spectrum_Protect-SRV-Linuxx86_64. bin
  In the examples, 8.1.x.000 represents the product release level.
4. Extract the installation files by issuing 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 4042944
  - IBM Spectrum Protect Extended Edition technote 4042945
  - IBM Spectrum Protect for Data Retention technote 4042946
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 like this example:
  8.1.x.000-IBM_Spectrum_Protect-SRV-WindowsX64.exe
  The package is large. Therefore, the extraction takes some time.
To ensure that the IBM Spectrum Protect wizards work correctly, verify that the following command is enabled:
- lsuser
By default, the command is enabled.
Install the IBM Spectrum Protect software by using one of the following methods. During the installation process, you must install the IBM Spectrum Protect license.
Tip: If you have multiple server instances on your system, install the IBM Spectrum Protect software only once 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 Tivoli Storage Manager by using the installation wizard.

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

To install the server by using the graphical wizard of IBM Installation Manager, follow the instructions in Installing Tivoli Storage Manager 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 Install icon; do not click the Update or Modify icon.

Command line in console mode

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

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

To install the server by using the command line in 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.
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
Obtain any applicable fixes by going to the IBM Support Portal. Click Downloads (fixes and PTFs) and apply any applicable fixes.
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, issue 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, issue the following IBM Spectrum Protect administrative command:
```
query system
```
  To obtain information about the database, issue the following IBM Spectrum Protect administrative command:
```
query db format=detailed
```
Verify that the upgrade was successful:
1. Start the server instance. To start the server from the default directory, C:\Program Files\Tivoli\TSM, issue the following IBM Spectrum Protect administrative command:
```
dsmserv -k server_instance
```
  where 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, issue 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, issue the following IBM Spectrum Protect administrative command:
```
query system
```
  To obtain information about the database, issue the following IBM Spectrum Protect administrative command:
```
query db format=detailed
```
Register the licenses for the IBM Spectrum Protect server components that are installed on your system by issuing 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, register the license by issuing the following command:
```
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, issue 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, issue 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 IBM Spectrum Protect for Mail, IBM Spectrum Protect for Databases, IBM Spectrum Protect for Enterprise Resource Planning, and 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.
Register the licenses for the server components that are installed on your system by issuing 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, register the license by issuing the following command:
```
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, issue 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, issue 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 IBM Spectrum Protect for Mail, IBM Spectrum Protect for Databases, IBM Spectrum Protect for Enterprise Resource Planning, and 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.
Optional: To install an additional language package, use the modify function of the IBM Installation Manager.
Optional: To upgrade to a newer version of a language package, use the update function of the IBM Installation Manager.

What to do next

You can authenticate passwords with the LDAP directory server, or authenticate passwords with the IBM Spectrum Protect server. Passwords that are authenticated with the LDAP directory server can provide enhanced system security.

Windows operating systems If a native device driver is available on Windows for the tape drives or medium changers that you plan to use, use the native device driver. If a native device driver is not available on Windows for the tape drives or medium changers that you plan to use, install the IBM Spectrum Protect device driver by issuing the dpinst.exe /a command. The dpinst.exe file is in the device driver directory. The default directory is C:\Program Files\Tivoli\TSM\device\drivers.