Tivoli Storage Manager for Windows: Administrator's Reference

DSMSERV FORMAT (Format the Database and Log)

Use this command to initialize the server database and recovery log. No other server activity is allowed while initializing the database and recovery log.

Attention:

To install an additional server, create a new directory and issue the DSMSERV FORMAT command, with the -k parameter, from that directory. That directory becomes the location of the server. The registry tracks the installed servers.

Syntax

            .- -k--Server1--.
>>-dsmserv--+---------------+--format--number_of_log_files------>
            '- -k--key_name-'
 
     .-------------------------.
     V                         |
>--+---log_file_name--log_size-+-+--number_of_db_files---------->
   '-file:log_file_name----------'
 
     .------------------.
     V                  |
>--+---db_name--db_size-+-+------------------------------------><
   '-file:db_file_name----'
 
 

Parameters

-k key_name
Specifies the name of a Windows NT registry key used to store information about this server. Use this parameter only to install additional servers on the same system. After you install a server by using this parameter, you must always start it with the value of this parameter. The default is SERVER1.

number_of_log_files (Required)
Specifies the number of recovery log files.

log_file_name
Specifies one or more recovery log file names. The files must not exist before you issue the command, or the command fails.

The number of names must match the number specified by the number_of_log_files parameter. The minimum size for the log is 9MB.

log_size (Required)
Specifies the size of the recovery log file in megabytes. The minimum size is 9MB.

file:log_file_name
Specifies the name of a file that contains a list of recovery log volume names and sizes (one name and size per line) used to format the recovery log. If the files exist before you issue the command, the command fails.

It is recommended that you specify a fully-qualified name enclosed in single quotes so that you will not be affected by data set name qualification rules that depend on your operating environment.

The number of names must match the number specified by the number_of_log_files parameter. You must list the volumes in the order in which they are to be used. The minimum size for the log is 9MB.

number_of_db_files (Required)
Specifies the number of database files.

db_file_name
Specifies one or more database file names. If the files exist before you issue the command, the command fails.

The number of names must match the number specified by the number_of_db_files parameter. The minimum size for the database is 5MB.

db_size (Required)
Specifies the size of the database in megabytes. The minimum size is 5MB.

file:db_file_name
Specifies the name of a file that contains a list of database volume names and sizes (one name and size per line). The files must not exist before you issue the command or the command fails.

The number of names must match the number specified by the number_of_db_files parameter. You must list the volumes in the order they are to be used. The minimum size for the database is 5MB.

Examples

Task 1:

To manually install the first server on a Windows NT system, change to that directory that contains the server executable and issue the DSMSERV FORMAT command. For example, from a Windows NT prompt, enter the following commands:

  1. cd:\"program files"\tivoli\tsm\server
  2. dsmserv format 1 log1.dsm 9 1 db1.dsm 13

Because the -k parameter is not specified, TSM creates an NT registry key of Server1. When this command is run without specifying a -k parameter, it uses information stored in the system registry under the key SERVER1.

Use the following example to install an additional server on a Windows NT machine. The server is installed in the c:\"program files"\tivoli\tsm\server directory and TCP/IP is the communications method used.

Note:
If you have installed TSM in a different location, substitute that location for the one listed in the example below.
  1. From the c:\"program files"\tivoli\tsm directory, enter the following commands to create a new directory and change into that directory:
    md server2
    cd server2
    
  2. From the c:\"program files"\tivoli\tsm\server2 directory, enter the following commands:
    ..\utils\dsmfmt -data data1.dsm 4
    ..\server\dsmserv -k server2 format 1 log1.dsm 9 1 db1.dsm 13
    ..\server\dsmserv -k server2 runfile ..\server\initnode.dat
    ..\server\dsmserv -k server2 runfile ..\server\dsmserv.idl
    Copy ..\server\dsmserv.opt
    ..\utils\adsm
    
  3. From the Main Menu, select Options, Options Files, Select Options File.
  4. From the list, select Server2.
  5. Select File, Open.
  6. Select Options, TCP/IP, Port Address.
  7. Change the value for the Port Address to 1501.
  8. Click on the Client Settings button to view the parameters the clients must use in the Client Options File to connect to the new server.
  9. Select File and then Save.
  10. Enter ..\server\dsmserv -k server2 to start the new server.

Task 2:

Initialize the recovery log and database volumes by specifying files containing the volume names and sizes (in megabytes):

Command:
c:\"program files"\tivoli\tsm\server2>dsmserv -k server2 in
file:log.vols 1 file:db.vols


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]