Top
 Systemwalker User's Guide - Systemwalker User Management and Single Sign-On
Systemwalker

6.1.2 swidmg_set_repository (Connection Destination Systemwalker Authentication Repository Setup Command)

Description

This command sets up the environment for connecting to the Systemwalker authentication repository from Systemwalker products.

Execute this command immediately after installing each Systemwalker product.

Point

  • To perform replication operations using Active Directory for the Systemwalker authentication repository, execute this command with the "ADDHOST" option on each machine where replication operations are to be performed.

  • Some Systemwalker products may need to be restarted.
    To determine whether to restart a particular Systemwalker product, refer to the manual for that product that describes the procedure for using the Systemwalker authentication repository.

Synopsis

swidmg_set_repository

SET -h <host name> [-p <port number>] -id <user ID> -pw <password> -publicdir <public directory> -userdir <user storage directory> -t {AD|IDS} [-help]

swidmg_set_repository

UNSET [-help]

swidmg_set_repository

ADDHOST -h <host name> [-h <host name>][-help]

swidmg_set_repository

DELETEHOST {-h <host name> [-h <host name>]... | -all } [-help]

swidmg_set_repository

ENABLE [-help]

swidmg_set_repository

DISABLE [-help]

swidmg_set_repository

CHECK [-help]

swidmg_set_repository

REFER [-help]

swidmg_set_repository

-help

Options

SET:

Specify this option to set up an environment for connecting to the Systemwalker authentication repository.

-h <host name>:

Specifies the host name of the server where the Systemwalker authentication repository operates, using fully qualified domain name (FQDN) format.

-p <port number>:

Specifies the port number for the directory server to be used as a Systemwalker authentication repository. If this option is omitted, "636" will be set as the port number.

-id <user ID>:

Specifies the user ID of the user that accesses the Systemwalker authentication repository, in DN format and enclosed in double-quotes.

To add, change or delete users in the Systemwalker authentication repository, the user must have administrator privileges for the Systemwalker authentication repository (for Active Directory, this means "Administrator" privileges and for the Interstage Directory Service this means the DN for the administrator).

Example:

"CN=Administrator,CN=Users,dc=fujitsu,dc=com"

-pw <password>:

Specifies the password for the user specified by the "-id" option.

-publicdir <public directory>:

Specifies the public directory for the Systemwalker authentication repository. enclosed in double-quotes.

-userdir <user storage directory>:

Specifies the user storage directory for the Systemwalker authentication repository, enclosed in double quotes.

-t {AD|IDS}:

Specifies the type of the directory server to be used as a Systemwalker authentication repository.

AD:

Specifies that Active Directory be used as the Systemwalker authentication repository.

IDS:

Specifies that the Interstage Directory Service be used as the Systemwalker authentication repository.

-help:

Displays the usage for the SET option.

UNSET:

Deletes the environment settings for connecting to the Systemwalker authentication repository.

-help:

Displays the usage for the UNSET option.

ADDHOST:

Specify this option to add a connection destination Systemwalker authentication repository if replication operations are being performed for the Active Directory database that is being used as the Systemwalker authentication repository.

-h <host name>:

Specifies the host name for the Active Directory database to be added, using FQDN format.

-help:

Displays the usage for the ADDHOST option.

DELETEHOST:

Specify this option to delete a connection destination Systemwalker authentication repository if replication operations are being performed for the Active Directory database that is being used as the Systemwalker authentication repository.

-h <host name>:

Specifies the host name for the Active Directory database to be deleted, using FQDN format.

-all:

Deletes all hosts.

-help:

Displays the usage for the DELETEHOST option.

ENABLE:

Enables settings that were temporarily disabled with the DISABLE option.

-help:

Displays the usage for the ENABLE option.

DISABLE:

Temporarily disables connections to the Systemwalker authentication repository.

-help:

Displays the usage for the DISABLE option.

CHECK:

Checks whether it is possible to connect to the Systemwalker authentication repository.

-help:

Displays the usage for the CHECK option.

REFER:

Displays the settings.

-help:

Displays the usage for the REFER option.

-help:

Displays the usage for all the options.

Return Values

0:

Normal termination

Other than 0:

Abnormal termination

Command Location

Windows

%F4AM_INSTALL_PATH%\F4AMidmg\client

UNIX

/opt/FJSVswaic/client

Privilege Required/Execution Environment

[Windows]

[UNIX]

Usage example 1 (Environment settings)

In the following example, the environment for the Systemwalker authentication repository is as follows:

[Windows]

"%F4AM_INSTALL_PATH%\F4AMidmg\client\swidmg_set_repository" SET -h AD-Server001.fujitsu.com -p 636 -id "CN=Administrator,CN=Users,dc=fujitsu,dc=com" -pw administrator -publicdir "DC=fujitsu,DC=com" -userdir "OU=System,OU=fujitsu,DC=com" -t AD

[UNIX]

/opt/FJSVswaic/client/swidmg_set_repository SET -h AD-Server001.fujitsu.com -p 636 -id "CN=Administrator,CN=Users,dc=fujitsu,dc=com" -pw administrator -publicdir "DC=fujitsu,DC=com" -userdir "OU=System,OU=fujitsu,DC=com" -t AD

Usage example 2 (Deleting the environment settings)

[Windows]

"%F4AM_INSTALL_PATH%\F4AMidmg\client\swidmg_set_repository" UNSET

[UNIX]

/opt/FJSVswaic/client/swidmg_set_repository" UNSET

Usage example 3 (Adding a host)

[Windows]

"%F4AM_INSTALL_PATH%\F4AMidmg\client\swidmg_set_repository" ADDHOST -h AD-Server002.fujitsu.com

[UNIX]

/opt/FJSVswaic/client/swidmg_set_repository ADDHOST -h AD-Server002.fujitsu.com

Usage example 4 (Deleting a host)

[Windows]

"%F4AM_INSTALL_PATH%\F4AMidmg\client\swidmg_set_repository" DELETEHOST -h AD-Server002.fujitsu.com

[UNIX]

/opt/FJSVswaic/client/swidmg_set_repository DELETEHOST -h AD-Server002.fujitsu.com

Usage example 5 (Enabling the settings)

[Windows]

"%F4AM_INSTALL_PATH%\F4AMidmg\client\swidmg_set_repository" ENABLE

[UNIX]

/opt/FJSVswaic/client/swidmg_set_repository ENABLE

Usage example 6 (Disabling the settings)

[Windows]

"%F4AM_INSTALL_PATH%\F4AMidmg\client\swidmg_set_repository" DISABLE

[UNIX]

/opt/FJSVswaic/client/swidmg_set_repository DISABLE

Usage example 7 (Looking up the environment settings)

[Windows]

"%F4AM_INSTALL_PATH%\F4AMidmg\client\swidmg_set_repository" REFER

[UNIX]

/opt/FJSVswaic/client/swidmg_set_repository REFER