...
| Code Block |
|---|
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 restart for more information.
The command accepts the following options:
| Option | Description |
|---|---|
[-ecsa] | Use this option to disconnect only ECSAs, for example: MZ>> disconnect -ecsaIf 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 -ecIf 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 ec1In 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:
...
| Tip | ||
|---|---|---|
| ||
To get the latest status information for all local EC/ECSAs, execute the |
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 |
...