Code installation

You should use the instructions in the associatedQuick Start manual for your chosen Tivoli Storage Manager server platform to install the Tivoli Storage Manager code. TheQuick Startmanual is shipped with the install media. The latest version of this manual is also available from the Tivoli Storage Manager Web site in either HTML or PDF format. We recommend that you download the manual to ensure that you are working with the latest information. The URL for Tivoli Storage Manager publications is:

http://www.tivoli.com/support/storage_mgr/pubs/admanual.htm

3.3 Customization

The Tivoli Storage Manager server has a number of options and settings which control its operation. You specify the options in the server options file either by manually editing it or by using the GUI interface provided on some platforms.

Tivoli Storage Manager uses the options specified in the options file at server start-up. You can specify many server settings via an administrative interface.

3.3.1 Options file

Tivoli Storage Manager provides a server options file with a set of default options to start the server. You can modify server options by using a text editor. On some platforms, Tivoli Storage Manager provides a server options file editor to perform this function. The supplied file contains information on what options and option values can be specified. You can display the current server options via the^query options command.

Chapter one ofTivoli Storage Manager for AIX Quick Start, GC35-0367, contains the steps to install the Tivoli Storage Manager code in a section titled, Installing and Setting Up Tivoli Storage Manager. You should install all the components. You should not install the sample command scripts. The sample scripts and our recommended scripts will be installed later.

AIX:

The Program Directory contains the steps to install all the server and

administrator client code.Tivoli Storage Manager for MVS and OS/390 Quick Start, GC35-0376, does not contain the steps to install the code but does contain steps for setting up and customizing a Tivoli Storage Manager environment.

MVS:

Chapter one ofTivoli Storage Manager for Windows NT Quick Start, GC35-0379, contains the steps to install all the server and client code. You should accept all the default options.

Windows NT:

We provide recommended options files for the various server platforms, because the layout of the supplied options file is not easy to understand. See B.2, “Server options files” on page 292, which contains our server option files. The file options are presented in a more logical sequence than those provided during the install.

We assume that TCP/IP is the network protocol and that administrators can access the server via a browser such as Netscape or Internet Explorer.

Table 24 shows the default location of the Tivoli Storage Manager server options file by server platform. We recommend that you take a backup copy of the existing options file before you replace it with your updated version.

Table 24. Server options file location

Although the number of server options is very large, there are only a small number that need to be changed for each server. These options fall into the following categories:

• Communication options

• Site-dependent options

• Performance options

3.3.1.1 Communication options

If your network protocol is not TCP/IP, then we recommend that you update the Communications Options section of our options file to support your protocols. A server can support multiple communication methods. TheQuick Start manual provides the details on what options and values to specify.

3.3.1.2 Site-dependent options

If your locale is not the USA, then we recommend that you update the Date, Number, Time, and Language Options section of the options file to support your requirements. The appropriate Administrator’s Reference manual for your operating system platform (listed in D.3, “Tivoli Storage Management

Publications” on page 304) provides the details on which options and values to specify. You must specify the value for each of these options that was determined during the planning phase. Some options do not apply to some server platforms.

Platform File Location

AIX /usr/tivoli/tsm/server/bin/dsmserv.opt HP/UX /opt/tivoli/tsm/server/bin/dsmserv.opt

MVS As specified by DDname OPTIONS

Solaris /opt/tivoli/tsm/server/bin/dsmserv.opt

Windows NT C:\Program Files\Tivoli\tsm\server\dsmserv.opt

At server initialization, the server reads the server options file. If you update a server option by editing the file, you must remember to stop and restart the server to activate the updated server options file.

Note:

Refer to the Administrator’s Reference manual for specific details. Table 25 shows those server options.

Table 25. Server options: site dependent

3.3.1.3 Performance options

Table 26 identifies performance options for which we recommend different values than the default. Refer to theAdministration Referencemanual for specific details.

Table 26. Server options: performance

Option Description

DATEFORMAT Specifies the format by which dates are displayed by the server

LANGUAGE Specifies the language used for messages

NUMBERFORMAT Specifies the format by which numbers are displayed by the server

TIMEFORMAT Specifies the format by which times are displayed by the server

DEVCONFIG The file in which Tivoli Storage Manager stores a backup copy of the device configuration information

VOLUMEHISTORY The file in which Tivoli Storage Manager stores a backup copy of the server sequential volume history information MIRRORWRITE log sequential Avoids potential log data corruption when operating

system fails during log update

ENABLE3590LIBRARY Support for IBM 3590 tape drives in an IBM 349x automated library

Server Option and Value Description

EXPINTERVAL 0 Specifies the interval, in hours, between automatic inventory expiration runs by Tivoli Storage Manager.

When set to 0, inventory expiration is disabled and can only be run manually.

TXNGROUPMAX 256 Specifies the number of files that are transferred as a group between a client and the server between transaction commit points

MOVEBATCHSIZE 256 Specifies the number of files that are to be moved and grouped together in a batch, within the same server transaction

MOVESIZETHRESH 500 Specifies a threshold for the amount of data moved as a batch, within the same server transaction

LOGPOOLSIZE 2048 Specifies the size of the recovery log buffer pool size BUFPOOLSIZE 32768 Specifies the minimum size of the database buffer

pool

SELFTUNEBUFPOOLSIZE YES Dynamically adjust the database buffer pool

TCPWINDOWSIZE 32 Specifies the size of the buffer used when sending or receiving data.

3.3.2 Settings

Tivoli Storage Manager provides default server run-time settings. These settings are stored in the Tivoli Storage Manager database and persist across server restarts. You specify the server settings via the administrative interface. You can display the current server settings via thequery status command.

The default values for the server settings are generally acceptable. There are a few settings for which we recommend values other than the defaults. The settings are changed via the^setcommand and fall into the following categories:

• Security related settings

• Our recommended settings 3.3.2.1 Security related settings

Table 27 shows the various default security related settings for the server. We recommend that you select values for these settings which reflect the security policy at your site.

Table 27. Security related settings

For example, consider the security policy at a company which specifies that all passwords must be changed every 90 days and must be a minimum of six characters in length. If three invalid passwords are entered in response to a password prompt, that user must have the system access revoked.

Administrative users accessing the server via the Web interface are never to be timed out.

The policy is implemented by the following administrative commands:

3.3.2.2 Recommended server settings

We recommend changing some of the default server settings.

Setting and Value Description

AUTHENTICATION ON Whether administrators and client nodes must use a password to access the server

INVALIDPWLIMIT 3 Maximum number of failed logon attempts before a node or administrator is locked

MINPWLENGTH 6 Minimum length of a password PASSEXP 90 Password expiration period

WEBAUTHTIMEOUT 0 Time-out interval for the Web administrative interface

tsm: TSM010> set authentication on

ANR2095I Authentication parameter set to ON.

tsm: TSM010> set passexp 90

ANR2092I Password expiration period set to 90 days.

tsm: TSM010> set minpwlength 6

ANR2138I Minimum password length set to 6.

tsm: TSM010> set invalidpwlimit 3

ANR2175I Invalid password limit set to 3 attempts.

tsm: TSM010> set webauthtimeout 0

ANR2198I SET WEBAUTHTIMEOUT: Web authentication time-out set to 0 minutes.

The accounting server setting determines whether an accounting record is created every time a client node session ends. The default is not to create these records. We recommend that accounting be switched on to collect these records.

For MVS systems, this information is recorded in the Systems Management Facility (SMF). For other systems, this information is written to a file which contains text records that can be viewed directly or can be imported into a spreadsheet program.

All server activity is recorded in an activity log. This log is located in the Tivoli Storage Manager database and contains text messages. The log is pruned automatically every night at midnight. The default retention period for the log is only one day. This does not provide an adequate amount of information for production systems. We recommend that you specify a value of between seven and 14 days.

The administrative command to collect accounting information, keep server activity log records for 10 days, and the results of those commands should look like this: