Linux: Creating the server instance
Create an IBM Spectrum Protect™ instance by issuing the db2icrt command.
About this task
![Linux operating systems](./../common/images/nglinux.gif)
- The home directory for the user (/home/tsminst1)
exists. If there is no home directory, you must create it. The instance directory stores the following core files that are generated by the IBM Spectrum Protect server:
- The server options file, dsmserv.opt
- The server key database file, cert.kdb, and the .arm files (used by clients and other servers to import the Secure Sockets Layer certificates of the server)
- Device configuration file, if the DEVCONFIG server option does not specify a fully qualified name
- Volume history file, if the VOLUMEHISTORY server option does not specify a fully qualified name
- Volumes for DEVTYPE=FILE storage pools, if the directory for the device class is not fully specified, or not fully qualified
- User exits
- Trace output (if not fully qualified)
- A shell configuration file (for example, .profile) exists in the home directory. The root user and instance-user ID must have write permission to this file. For more information, see the DB2® product information. Search for Linux and UNIX environment variable settings.
![Linux operating systems](./../common/images/nglinux.gif)
- Log in using the root user ID and create an IBM
Spectrum Protect instance. The name of the instance must be the same
name as the user that owns the instance. Use the db2icrt command and enter the
command on one line:
For example, if your user ID for this instance is tsminst1, use the following command to create the instance. Enter the command on one line./opt/tivoli/tsm/db2/instance/db2icrt -a server -u instance_name instance_name
/opt/tivoli/tsm/db2/instance/db2icrt -a server -u tsminst1 tsminst1
Remember: From this point on, use this new user ID when you configure your IBM Spectrum Protect server. Log out of the root user ID and log in under the new instance-user ID. - Change the default directory for the database to be the same as the instance directory for the
server. If you have multiple servers, log in under the instance ID for each server. Issue this
command:
For example, where instance_directory is the instance user ID:db2 update dbm cfg using dftdbpath instance_directory
db2 update dbm cfg using dftdbpath /tsminst1
- Modify the library path to use the version of the IBM Global Security Kit (GSKit) that is
installed with the server. In the following examples, server_bin_directory is a
subdirectory of the server installation directory. For example,
/opt/tivoli/tsm/server/bin.
- You must update the following files to set the library path when DB2 or the server are started:
Bash or Korn shell example:
instance_users_home_directory/sqllib/userprofile
C shell example:
instance_users_home_directory/sqllib/usercshrc
- Add the following entry to the
instance_users_home_directory/sqllib/userprofile (Bash or
Korn shell) file. Each entry is on one
line.
LD_LIBRARY_PATH=server_bin_directory/dbbkapi: /usr/local/ibm/gsk8_64/lib64:$LD_LIBRARY_PATH export LD_LIBRARY_PATH
- Add the following entry to the
instance_users_home_directory/sqllib/usercshrc (C shell)
file, on one
line:
setenv LD_LIBRARY_PATH server_bin_directory/dbbkapi: /usr/local/gsk8_64/lib64:$LD_LIBRARY_PATH
- Verify the library path settings and that the GSKit is version 8.0.14.43 or later. Issue the
following
commands:
echo $LD_LIBRARY_PATH gsk8capicmd_64 -version gsk8ver_64
If your GSKit version is not 8.0.14.43 or later, you must reinstall the IBM Spectrum Protect server. The reinstallation ensures that the correct GSKit version is available.
- You must update the following files to set the library path when DB2 or the server are started:
- Create a new server options file. See Linux: Configuring server and client communications.