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

Reference Manual

Tivoli Management Framework Reference Manual, 3.7.1, March, 2001

oserv

Provides operations to control and configure object dispatchers.

Syntax

oserv -k dbdir [-a TRUE | FALSE] [-b install_dir] [-B libpath] [-c crypt] [-C crypt] [-d] [-E {default | cipher...}] [-K kerb_serv_inst] [-l log_file] [-m swapsize] [-n {none | SSL | FORCE_SSL}] [-N ali [-r region]] [-N {by_addr | by_name}] [-p local_port] [-R irkey] [-S] [-s install_key] [-t max_trace_size] [-v] [-z TRUE | FALSE]

oserv -k dbdir [-b install_dir] [-B libpath] [-d] [-E {default | cipher...}] [-h TMEhost] [-l log_file] [-m swapsize] [-n {none | SSL | FORCE_SSL}] [-p local_port] [-S][-t max_trace_size] [-v] [-z TRUE | FALSE]

oserv -b install_dir -k dbdir [-f TRUE | FALSE] -i -r region [-a TRUE | FALSE] [-B libpath] [-c crypt] [-C crypt] [-d] [-E {default | cipher...}] [-K kerb_serv_inst] [-l log_file] [-m swapsize] [-n {none | SSL | FORCE_SSL}] [-N {by_addr | by_name | ali}] [-p local_port] [-R irkey] [-S] [-s install_key] [-t max_trace_size] [-v] [-z TRUE | FALSE]

oserv -k dbdir [-f TRUE | FALSE] -i -h TMEhost -b install_dir [-B libpath] [-d] [-E {default | cipher...}] [-l log_file] [-m swapsize] [-n {none | SSL | FORCE_SSL}] [-p local_port] [-S][-s install_key] [-t max_trace_size] [-v] [-z TRUE | FALSE]

Windows NT or Windows 2000 Systems Only

net start oserv /-option...

The oserv command can only be invoked from the Service Manager. From the command line, the oserv command must be preceded by net start.

All options must be preceded by a slash and a dash (/-) instead of the single dash (-) used in UNIX. Any letter options that require a value cannot have a space between the letter and the value (for example, net start oserv /-Nbyaddr).

The -k option is not required. If not specified, the location of the database directory is taken from the registry.

Description

The oserv command starts the Tivoli object dispatcher. The Tivoli object dispatcher has multiple functions. It maintains the Tivoli object database on each system that has Tivoli installed, it routes object calls to the proper systems and objects, and it arranges for the execution of methods that are invoked in the context of objects that reside on the local system.

The first form of the oserv command is used to restart the object dispatcher on a Tivoli management region server.

The second form of the oserv command is used to restart the object dispatcher on a Tivoli client.

The third form of the oserv command is used to initialize the object dispatcher on a Tivoli management region server.

The fourth form of the oserv command is used to initialize the object dispatcher on a Tivoli client.

The third and fourth forms of the oserv command are used only when you are using the installation programs.

The object dispatcher saves its configuration options in its database so that the object dispatcher resumes with its previous settings when it is restarted. When restarting an object dispatcher, you typically specify the -k option plus the options for any settings you want to change. You can change the object dispatcher settings without shutting down the object dispatcher by using the odadmin command.

Options

-a TRUE | FALSE

Sets the flag that controls client installations. Client installations can be allowed (TRUE) or prohibited (FALSE). This option is only valid for the Tivoli management region server.

-b install_dir

Specifies the path name of the method binaries installation directory. This option is required if the -i option is specified. Note that $BINDIR/.. and %BINDIR%\.. are literal path name values, and the two dots after the slash are part of the name. The dots are not an ellipses (...) indicating a continuation of a path name. This is the same directory referred to by $BINDIR/.. (UNIX) and %BINDIR%\.. (Windows NT and Windows 2000).

-B libpath

Specifies the shared library search path. If the -i option is specified and this option is not specified, the library search path is read from the invoker's environment. This is the same directory referred to by $LIBDIR (UNIX) or %LIBDIR% (Windows NT and Windows 2000).

-c crypt

Specifies the intraregion encryption level. The crypt option can be des, simple, or none.

-C crypt

Specifies the interregion encryption level. The crypt option can be des, simple, or none.

-d

Does not detach the object dispatcher from the controlling terminal. This option is used for running an object dispatcher in a debugger. Standard output is not mapped to /dev/null.

-E {default | cipher...}

Sets one or more ciphers for managed nodes, in order of preference (for example, 0A09). This option sets ciphers of a managed node's initial connection to the server. After the node connects, it defaults back to the value stored on the server. You also can specify that a managed node has the default setting, which means that the managed node has the default Tivoli cipher list of 05040A030609. For a list of cipher values, see the Tivoli Management Framework User's Guide.

-f TRUE | FALSE

Forces an object dispatcher to bind to a single socket for all Tivoli client connections. Use this option when multiple dispatchers are running on a machine that has multiple Internet Protocol (IP) addresses. This forces each dispatcher to use the same IP address each time it communicates with clients.

-h TMEhost

Specifies the name of the new Tivoli installation's Tivoli management region server. This option is used when starting the object dispatcher on a Tivoli client.

-i

Initializes the object dispatcher. This option is used the first time the object dispatcher is started on a system. It is not recommended that you use the -i option without assistance from Customer Support.

-I

Indicates to the object dispatcher that the object dispatcher is being started by inetd. This option is only specified in inetd configuration files; it should not be specified on the command line.

-k dbdir

Specifies the path name of the object database directory. This is the same directory referred to by $DBDIR (UNIX) or %DBDIR% (Windows NT or Windows 2000).

-K kerb_serv_inst

Sets the Kerberos service instance name. This option can only be specified for the Tivoli management region server.

-l log_file

Specifies the file to be used for logging messages. If this option is not specified, messages are logged to the oservlog file.

-m swapsize

Specifies the size of the swap space allocated by mmap.

-n {none | SSL | FORCE_SSL}

Sets the network security level of a managed node's initial connection to the Tivoli management region server. After the node connects, it defaults back to the value stored on the server. Options are as follows:

none

Specifies that SSL is not used by the managed node, except when it is SSL-capable and is communicating with a FORCE_SSL managed node. This is the default setting.

SSL

Specifies that the managed node uses SSL when communicating with other SSL managed nodes. SSL is not used when communicating to a node with a setting of none.

FORCE_SSL

Specifies that the managed node only communicates using SSL. Non-SSL connections are not accepted by the managed node.

-N {by_addr | by_name | ali}

Refetches IP addresses for odlist entries using gethostbyaddr (by_addr), gethostbyname (by_name), or by replacing the Tivoli management region server's odlist entry with the name and address of this system (ali). Do not move your Tivoli management region server to a new system by using the ali option without first getting instructions for this procedure from Customer Support.

-p local_port

Specifies the port number to use for communication with other processes. The port number must be less than 1024. This option overrides the port specification in the /etc/services file. If this option is not specified, the default is the port specification in the /etc/services file.

-P ali_port

Specifies the port number to use for communication with the Tivoli management region server. The port number must be less than 1024. This option is required only if the -i option is specified and the Tivoli server port is different than the local object dispatcher's port. This option is valid only for Tivoli clients.

Note:

This option is meant for use in development and test environments only. It should not be used in a production environment.

-r region

Sets the region number. This option can be used only with the -i option or the -N ali option.

-R irkey

Specifies the interregion encryption key. If the irkey option is not specified, the interregion encryption key is read from standard input. You cannot specify the -R option if the -s option is specified.

-s install_key

Specifies the installation key. If the install_key option is not specified, the installation key is read from standard input. You cannot specify the -s option if the -R option is specified.

-S

Suppresses the output of oserv errors to syslogd.

-t max_trace_size

Sets the maximum size of the odtrace.log file created for use by the wtrace command.

-v

Causes the oserv to use vfork() to spawn subprocesses instead of fork() on UNIX platforms. Specifying this flag has no effect on Windows NT or Windows 2000 systems.

-z TRUE | FALSE

Enables (TRUE) or disables (FALSE) Kerberos authentication.

Authorization

root

Examples

1. The following example starts the oserv, using all current defaults:

   oserv -k /var/spool/Tivoli/myhost.db
   
   

2. The following example changes the path to the binary and library directories. This is helpful if the mount point to these directories is changed.

   oserv -b /mnt/local/Tivoli/bin -B \
   
   /mnt/local/Tivoli/lib:/usr/lib \
   
    -k /var/spool/Tivoli/myhost.db
   
   

See Also

odadmin, odstat, idlcall, objcall, oinstall, wsettap, wtrace