Remote administration using the command interface

If you use the command interface for remote administration, you must first determine the names of the openFT instances that you are permitted to administer.

Determining the names of the openFT instances

You obtain the names of the openFT instances using the command ftshwc. You can enter the command directly on the remote administration server. On a remote computer, you must "package" it using the command ftadm:

• Entering ftshwc on the remote administration server:

  ftshwc -rt=i

• Entering ftshwc on the a remote computer:

  ftadm -cs=server "ftshwc -rt=i" transfer-admission

  Explanation

  server

  Name of the remote administration server from the partner list or address of the remote administration server using the format ftadm: //host... .

  transfer-admission

  FTAC transfer admission for accessing the remote administration server. The associated profile must have the property ACCESS-TO-ADMINISTRATION (see section “Setting up admission profiles for accessing the remote administration server”) and the profile name must be assigned to a remote administrator in the configuration file (see section “Creating a configuration file using a text or XML editor”).

Sample output

TYPE    = *INSTANCE     ACCESS = FT+FTOP+FTAC / *CHAR
   NAME = Muenchen/Jonny
   DESC = Computer Test-en-lp
TYPE    = *INSTANCE     ACCESS = FTOP
   NAME = Muenchen/Hello
   DESC = Computer Hello

NAME specifies the name of the instance that you must specify exactly as given here in the remote administration request. Your remote administration permissions for this instance and - if configured - the encoding mode are listed under ACCESS, see also the description of ftshwc.

Issuing a remote administration request

You issue a remote administration request using the ftadm command.

The syntax used for the remote administration request depends on whether you enter the ftadm command directly on the remote administration server or on a different, remote computer.

• Entering the ftadm command on the remote administration server:

  Log in on the remote administration server under the user ID that the ADM administrator has configured as remote administrator in the configuration file. See the UserID attribute in the section “Creating a configuration file using a text or XML editor”.

  Enter the ftadm command in the following form:

  ftadm -ri=instance "command"

• Entering the ftadm command on a remote computer:

  Log in on the remote computer using any user ID and enter the ftadm command in the following format:

  ftadm -cs=server

        -ri=instance "command" transfer-admission

Explanation

server

On the remote computer only: Name of the remote administration server from the partner list or address of the remote administration server using the format
ftadm: //host... .

instance

Routing name of the openFT instance on which the administration command is to be executed. You must enter this name in exactly the form in which it appears with the ftshwc command. See section “Remote administration using the command interface”.

command

Specifies the administration command to be executed on the openFT instance. You should always enclose command in quotes. If command contains spaces or special characters, the quotes are mandatory.

transfer-admission

On the remote computer only: FTAC transfer admission for accessing the remote administration server. The associated profile must have the property ACCESS-TO-ADMINISTRATION (see section “Setting up admission profiles for accessing the remote administration server”) and the profile name must be assigned to a remote administrator in the configuration file (see section “Creating a configuration file using a text or XML editor”).