Note on usage
Function: Switch on and off single-user mode
User group: FT administrator, ADM administrator, FTAC administrator.
The command is only available on Unix systems.
Functional description
With ftsetmode the administrator can switch openFT between multi-user mode and singleuser mode. This is valid for all openFT instances. In single-user mode, openFT completely runs under a specific ID, the so called openFT user ID. However, it is possible to define an individual openFT ID when creating a new instance in single-user mode.
The ftsetmode command should not be used during ongoing openFT operation, because if necessary ftsetmode ends the openFT processes of all active instances prior to changing to single-user mode (openFT, openFT Explorer, ftscript jobs, ftexec and ncopy commands) respectively prior to changing to multi-user mode (openFT, openFT Explorer, ftscript jobs, ftexec and ncopy commands).
Format
ftsetmode -h |
[ -ua=<openFT user ID> ]
[ -s ]
[ -m ]
Description
-h
Displays the command syntax on the screen. Entries after the -h are ignored.
-ua=openFT user ID
You use -ua to specify the user ID for the single-user mode. openFT completely runs under this ID. Access options, the executing of commands, etc. are consequently restricted to the permissions of this ID, the so called openFT ID.
The standard instance and all other active instances are allocated to the openFT ID.
When switching from multi-user to single-user mode, the following is valid for every active instance:
FT and FTAC administrators are set to the openFT ID
If the openFT ID was ADM administrator, it also remains this in single-user mode
For all other IDs including root, that had been ADM administrator, the ADM administration permission is returned in single-user mode
The Ftscript user options (including the options of the openFT ID) are deleted. The Ftscript runs of unauthorized IDs can not be accessed by means of openFT resources anymore.
After the switch openFT is restarted for the instances, for which it had been started before the switch.
When booting the system in single-user mode openFT starts under the ID of the instance owner.
-s
Single-user mode. With this option the administrator switches from multi-user to singleuser mode.
To enable the openFT instance to work as a central administration server in single-user mode the appropriate permission is returned when transferring to single-user mode, providing it had an ID different from the openFT ID. If required, the openFT ID can then give itself this permission (ftmoda -admpriv=y).
-m
Multi-user mode. The administrator switches from single-user to multi-user mode. After invoking this command all active openFT instances work in multi-user mode.
The following applies to each active instance, including the standard instance:
FT and FTAC administrators are set to root.
If the openFT ID was the ADM administrator in single-user mode, the ADM administration permission is returned.
After the switch openFT is restarted for the instances, for which it had been started before the switch.
Example
Switch to single user mode under the user ID user01:
ftsetmode -s -ua=user01