Note on usage
Function: Import the configuration of the remote administration server
User group: ADM administrator
Functional description
ftimpc stands for "import configuration". If you are an ADM administrator, ftimpc allows you to import an XML file containing configuration data on the remote administration server. The existing configuration is overwritten on import.
The format of the XML file must match the format in the schema defined in config.xsd. config.xsd is located in the openFT installation directory under the directory include. You will find further details on creating a configuration file in the manual "openFT (Unix and Windows systems) - Installation and Operation".
The XML file is checked for correct syntax and semantics by the XML parser and XML schema validator during import. If errors occur, a message is output to stderr indicating the element or the row/column in which the error occurred. The messages generated always appear in English.
In some cases, it is possible that you will receive a message during import indicating that the configuration data cannot be imported and that the asynchronous openFT server must be terminated. In this case, stop the asynchronous openFT server (e.g. using the ftstop command), call the ftimpc command again and then restart the asynchronous openFT server (e.g. using the ftstart command).
You can use ftimpc if you wish to change an existing configuration. To do this, export the existing configuration into an XML file with ftexpc, adapt the file and then import the changed file again with ftimpc.
The content of the XML file exported with ftexpc is encoded using UTF-8 (see the ftexpc command). You should therefore also encode an import file in UTF-8.
Format
ftimpc -h |
<file name>
Description
-h
Displays the command syntax on the screen. Entries after the -h are ignored.
file name
specifies the name of the XML file to be imported.
Messages of the ftimpc command
If ftimpc could not be executed properly, a self-explaining message is output. The exit code is not equal zero in this case.