2.2.6 disconnect
usage: disconnect [ -ecsa ] [ -ec ] [ -local ] [ -q ] [ -verbose] <running server process>
By using this command, it possible to let an EC/ECSA and its workflows run in disconnected mode during Platform upgrade, in order to avoid downtime.
Note!
Since a batch workflow cannot run without contact with the Platform, this command should only be executed on ECs/ECSAs running real-time workflows. If an EC/ECSA running a batch workflow is disconnected, the workflow will abort.
After disconnect, the EC/ECSA will continue executing real-time workflows without interference from the Platform and there will be no risk that new software is downloaded to the EC/ECSA during the Platform upgrade.
After the upgrade has been performed, each EC/ECSA has to be restarted in order to re-connect to the Platform, refer to 2.1.10 restartĀ for more information.
The command accepts the following options:
Option | Description |
---|---|
[-ecsa] | Use this option to disconnect only ECSAs, for example: MZ>> disconnect -ecsa If using this option without any ECSA process specified, as in the example, all ECSAs will be disconnected. If a non-ECSA process is specified, fault code 4 will be returned, for example: MZ>> disconnect -ecsa ec1 |
[-ec] | Use this option to disconnect only ECs, for example: MZ>> disconnect -ec If using this option without any EC process specified, as in the example, all ECs will be disconnected. If a non-EC process is specified, fault code 4 will be returned, for example: MZ>> disconnect -ec ecsa1 |
[-local] | Use this option to disconnect an EC/ECSA that is running on a local machine, for example: MZ>> disconnect -local ec1 In the example, the local EC process named ec1 will be disconnected. If using this option without any EC/ECSA process specified, all local ECs/ECSAs will be disconnected. |
[-q] | Quiet mode. Use this option to eliminate the display of any report during execution. |
[-verbose] | Verbose mode. This option will print extended error information. |
By running the disconnect
command from the Platform without any options, all running ECs/ECSAs, on all connected machines, will be disconnected without the need to login to each machine and disconnect them one by one:
MZ>> disconnect
Hint!
To get the latest status information for all local EC/ECSAs, execute the status
command as described in 2.1.13 status.
Return Codes
Listed below are the different return codes for the disconnect
command:
1-3: Errors only effecting one or more EC/ECSA.
10-11: Fatal error, no EC/ECSA was disconnected.
Code | Description |
---|---|
0 | Will be returned if the command was successful. |
1 | Will be returned if an EC/ECSA process is not running. |
2 | Will be returned if an EC/ECSA cannot be reached due to a communication problem. |
3 | Will be returned if an EC/ECSA does not exist. |
10 | Will be returned if the Platform cannot be reached due to communication problems. |
11 | Will be returned in case configuration files in |