Linux: Creating the server instance

Create an IBM Spectrum Protect™ instance by issuing the db2icrt command.

About this task

You can have one or more server instances on one workstation.
Linux operating systemsImportant: Before you run the db2icrt command, verify the following items:
  • 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 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 backup copy of the following files must be saved to a safe and secure location:
    • Master encryption key files (dsmkeydb.*)
    • Server certificate and private key files (cert.*)
  • The root user and instance-user ID must have write permission to the shell configuration file. A shell configuration file (for example, .profile) exists in the home directory. For more information, see the Db2® product information. Search for Linux and UNIX environment variable settings.
Linux operating systems
  1. 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:Linux operating systems
    /opt/tivoli/tsm/db2/instance/db2icrt -a server -u 
    instance_name instance_name
    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.Linux operating systems
    /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.
  2. 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:
    db2 update dbm cfg using dftdbpath instance_directory
    For example, where instance_directory is the instance user ID:
    db2 update dbm cfg using dftdbpath /tsminst1
  3. Modify the library path to include libraries that are required for server operations.
    Tip: In the following examples, here are the directories:
    • server_bin_directory is a subdirectory of the server installation directory. For example, /opt/tivoli/tsm/server/bin.
    • instance_users_home_directory is the home directory of the instance user. For example, /home/tsminst1.
    .
    • You must update one of the following files to set the library path when IBM® Db2 or the server are started. Update per the shell that the instance user is configured to use.

      Bash or Korn shell:

      instance_users_home_directory/sqllib/userprofile

      C shell:

      instance_users_home_directory/sqllib/usercshrc
    • Update per the shell that the instance user is configured to use.

      Bash or Korn shell:

      Add the following entry to the instance_users_home_directory/sqllib/userprofile file, on one line:Linux operating systems
      export LD_LIBRARY_PATH=server_bin_directory/
      dbbkapi:/usr/local/ibm/gsk8_64/lib64:
      /opt/ibm/lib:
      /opt/ibm/lib64:$LD_LIBRARY_PATH

      C shell:

      Add the following entry to the instance_users_home_directory/sqllib/usercshrc file, on one line:Linux operating systems
      setenv LD_LIBRARY_PATH server_bin_directory/dbbkapi:/
      usr/local/ibm/gsk8_64/lib64:/
      opt/ibm/lib:/opt/ibm/lib64:/usr/lib64:$LD_LIBRARY_PATH
      Remember: The following entries must be in the library path, preceding any other entries in the library path:
      • server_bin_directory/dbbkapi
      • /usr/local/ibm/gsk8_64/lib64
  4. Create a new server options file.