Reference Manual

Tivoli Management Framework Reference Manual, 3.7.1, March, 2001

wconnect

Connects two Tivoli management regions.

Syntax

wconnect [-u] [-P port] [-m mode] [-r encrypt_level] -s server region_num

wconnect [-nu][-P port] [-c encrypt_level] [-l login] [-m Two-way | Managing | Managed] [-r encrypt_level] server

Description

The wconnect command establishes a connection between the Tivoli management region servers in two regions. The first usage of wconnect shown in the syntax performs a secure connection. To complete the connection, this command must be run on both the Tivoli management region servers being connected. The second usage performs a remote connection. This command is run on only one Tivoli server. If the connection being made is to be a one-way connection, the Tivoli server from which the remote connection was performed becomes the managing server.

Tivoli management regions can be connected in a one-way connection or a two-way connection. With a one-way connection, one server is the managing server and one is the managed server. An administrator on the managing server can manage any resources on either the managing server or the managed server. However, an administrator on the managed server cannot manage resources on the managing server. With a two-way connection, administrators on either server can manage any resources of the other server.

Options

-c encrypt_level

Specifies the interregion encryption level that is in use in the local Tivoli management region. Valid encryption levels are simple, none, or DES. If the encryption level is none, no key is required. If the level is simple or DES, the command prompts for the key in use. The encryption key is the same as the installation password specified during the server installation. The encryption level must be the same as that specified during the Tivoli management region server installation. The default encryption level is simple.

-l login

Supplies a login name for the remote connection process. This login must be a valid login for a user on the remote server, and the user must have a Tivoli administrator with the super role defined in the remote Tivoli management region. If the -l option is specified, the command prompts for a password. If the trusted host's facility is used, do not type the password. Instead, press the Enter key to continue.

-m mode

Specifies the mode of connection to be established between Tivoli management regions. Valid connection modes are as follows:

Two-way: Establishes a two-way connection between Tivoli management regions. In a two-way connection, both Tivoli management region servers have managing authority over the resources in both regions. This is the default value.
Managing: Establishes a one-way connection with the local Tivoli management region server as the managing server. The local Tivoli server can manage resources in the remote Tivoli management region, but the remote Tivoli server cannot manage resources in the local region.
Managed: Establishes a one-way connection with the local Tivoli management region server as the managed server. This option is valid on secure connections only. For remote connections, the local server can be only a managing server.

-n

Instructs Tivoli Management Framework not to prompt for passwords. You can use this option only when you have trusted host access and do not require an encryption key.

Note:: Because a Windows NT or Windows 2000 system does not have trusted host access, this option cannot be used when connecting Tivoli management region servers on Windows systems.

-P port

Specifies the port number to use for communication with the Tivoli management region server if different from the local object dispatcher's port.

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

-r encrypt_level

Specifies the encryption level in use in the remote Tivoli management region. Valid encryption levels are simple, none, or DES. If the encryption level is none, no key is required. If the level is simple or DES, the command prompts for the key in use. The encryption key is the same as the installation password specified during the server installation. The encryption level must be the same as that specified during the Tivoli management region server installation. The default encryption level is simple.

-s

Establishes the connection using the secure connection process. This requires running wconnect -s on both Tivoli management region servers in the connection.

-u

Updates resources between Tivoli management regions in a two-way connection or from the remote region in a one-way connection. Note that because this is a time-intensive process, you can use the wlsconn -u command to perform this operation at a later date (not connection time).

region_num

Specifies the region number of the remote Tivoli management region.

server

Specifies the name of the Tivoli management region server in the remote region.

Authorization

super

Examples

The following example performs a remote two-way connection. Both Tivoli management region servers use simple encryption. The administrator running this command has the login sally on the remote server, elbert. Resource information is exchanged between the servers as soon as the connection is complete.
```
wconnect -u -c simple -l sally -m Two-way -r simple\ elbert
```
The following example performs a remote one-way connection. The local server uses no encryption, but the remote server, cook, uses simple encryption. The local server becomes the managing server and the remote server becomes the managed server. Resource information is updated on the local server.
```
wconnect -u -c none -m Managing -r simple cook

 
```
The following example performs a secure two-way connection. The remote server, pinatubo, uses simple encryption (by default). The region number of the remote server is 4004418954. Resource information is exchanged between the servers when the connection has been completed.
```
wconnect -u -s pinatubo 4004418954

 
```
To complete the connection, you must run wconnect on the remote server also. The following command must be run from pinatubo. In this example, the encryption level is specified with the -r option, while the previous command used the default value. Resource information is updated between servers.
```
wconnect -u -r simple -s everest 4004598145

 
```
The following example performs a secure one-way connection. The remote server, meiron, uses simple encryption (by default). The region number of the remote server is 0003432265. The local server will be the managed server. Resource information is exchanged between the servers when the connection is complete.
```
wconnect -u -m Managed -s meiron 0003432265

 
```
To complete the connection, you must run wconnect on the remote server also. The following command must be run from meiron. meiron will be the managing server.
```
wconnect -u -m Managing -s space 4004598145

 
```

Note:: If you make a one-way connection using the secure connection process and the first server you run wconnect on is specified as the managing server instead of the managed server, you must run the wlsconn -u command to complete the exchange of connection information on the managing server.

See Also

wdisconn, wlsconn, wupdate

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