ftdeli

Note on usage

Function: Deactivate an instance

User group: FT administrator

Functional description

The ftdeli command allows you to deactivate an instance. This causes the following:

• Unix systems: Removes only the symbolic link in the local /var/openFT directory

• Windows systems: The instance is removed from the openFT instance administration.

The instance file tree is not changed. The standard instance std and the currently set instance can not be deleted.

The deactivation of an instance should as a matter of principle not be done during ongoing openFT operation because an asynchronous openFT server or Ftscript jobs running at the time the command is executed will be stopped. The Ftscript user options (including those of the openFT ID) are deleted. The Ftscript runs of unauthorized IDs can no longer be accessed using openFT resources.

In single-user mode only root is permitted to deactivate an openFT instance with the command ftdeli.

Format

ftdeli -h |

<instance 1..8>

Description

-h

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

instance

Name of the instance to be deactivated. Using the ftshwi @a command displays the names of all instances.

Messages of the ftdeli command

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

Examples

1. The instance inst1 from the directory /CLUSTER/inst1 (Unix systems) or S:\CLUSTER\inst1 (Windows systems) is to be deactivated on computer CLUSTER1, since it has been switched over to CLUSTER2. The directory is retained.

   ftdeli inst1

2. Instance inst2 with the directory /CLUSTER/inst1 (Unix systems) or S:\CLUSTER\inst1 (Windows systems) is to be deleted along with the instance file tree.

   Unix systems:

   ftdeli inst2

   rm -r /CLUSTER/inst2

   Windows systems:

   ftdeli inst2

   rmdir /S S:\CLUSTER\inst2

3. Using . ftseti (Unix systems) or ftseti (Windows systems), it was changed to instance inst3. There, an attempt is being made to deactivate the instance inst3.

   ftdeli inst3

   ftdeli: openFT Instance 'inst3' can not be removed.