ftcrei

Note on usage

Function: Create or activate an instance

User group: FT administrator

Functional description

The ftcrei command allows you to create a new instance or re-activate a deactivated instance.

If the specified instance file tree does not yet exist, it is created.

When the instance file tree is created, the operating parameters and the profile files are initialized in the same way as for a new installation.

Notes for Unix systems

• When the instance file tree is created, in the case of Solaris with SMF, a manifest is generated and entered in SMF, see the manual "openFT (Unix and Windows systems) - Installation and Operation".

  In all other cases the startup and shutdown files are initialized in the same way as for a new installation.

• When an instance is created, the instance file tree is linked to the /var/openFT directory with the resources of an instance.

If the instance file tree already exists, ftcrei checks the version. If the instance file tree was created using an older version of openFT, it must first be updated using the ftupdi command before it can be reactivated.

Important notes for when using multiple instances

• Use of several openFT instances is only possible using the TCP/IP transport system. If you would like to use several instances and are working with CMX with TNS activated (ftmodo -cmx=y -tns=y), you must delete all openFT-specific TNS entries that are not TCP/IP compliant (i.e. all except for LANINET and RFC1006).

• You must explicitly assign an individual address to all instances using -addr.

• If the instance is to be authenticated in partner systems, it must have a unique instance ID assigned to it (using fta -id= ). In addition, a public key for the instance must be made available to the partner systems.

• For Windows systems applies: In all newly generated instances, the operating parameter option Start Asynchronous openFT Server Automatically is deactivated. You can change this setting in the openFT Explorer by choosing the Operating Parameters command in the Administration menu and going to the General tab.

Format

ftcrei -h |

<instance 1..8> [ <directory 1..128> ][ -addr=<host name> ] [ -ua=<user ID 1..32> ]

Description

-h

Displays the command syntax on the screen. Entries after the -h are ignored.

instance

Name of the instance to be created or reactivated. When reactivating an instance in multi-user mode root is always the owner of the instance. If until now the owner was not root, root is made to openFT and FTAC administrator; and if the previous owner was the ADM administrator, this permission is then transferred to root.Instance names have a maximum length of 8 characters. The permitted characters are A-Z, a-z and 0-9, and the first character must not be numerical.

The instance name must not be confused with the instance ID (see ftmodo -id=).

directory

Directory in which the instance file tree is to be located. The directory must not yet exist.

If you do not specify directory, the instance file tree is by default created in:

/var/openFT/. instance (Unix systems)

%ProgramData%\Fujitsu Technology Solutions\openFT\var\instance (Windows systems)

-addr=host name

Internet host name by which the instance is addressed. If your system has a DNS name, you should specify the full DNS name. openFT then uses the first 8 characters of the first part of the name (the host name qualifier) as the processor name (ftmodo -p=) and the entire name as the instance ID (ftmodo -id=).

-ua=<user ID 1..32>

With this parameter root specifies the owner of a new instance in single-user mode on Unix systems. The parameter is only allowed when creating an instance in single-user mode. The parameter is not allowed in multi-user mode or when reactivating an instance in single-user mode.

Messages of the ftcrei command

If ftcrei could not be executed properly, a self-explaining message is output. The exit code is not equal zero in this case.

Examples on Unix systems

1. The instance inst1 is to be newly created in the directory /cluster/inst1. The DNS name is hugo.abc.net. The directory /cluster/inst1 is not allowed to exist.

   ftcrei inst1 /cluster1/inst1 -addr=hugo.abc.net

   Where the operational parameter ftmodo -p= is hugo and ftmodo -id= is hugo.abc.net.

2. The existing instance inst2 from the directory /cluster/inst2 is to be re-activated. No host name may be specified.

   ftcrei inst2 /cluster/inst2

For examples on Windows systems, please refer to the manual "openFT (Unix and Windows Systems) - Installation and Operation".