Update an instance
You can use the /RegisterInstance command to update the available interfaces on previously registered instances.
Parameters
This command has the following parameters and flags:
|
Parameter |
Required / Optional | Description |
|---|---|---|
| /Host | Required | The server hosting the instance.
The value of the /Host parameter should be resolvable to an actual IP address both on the Contract Manager server and the KCM Instance server. If the value cannot be resolved, or it resolves to a loopback address (such as 127.0.0.1), an error message appears. |
| /Instance | Required | The number of the instance or a range to register multiple instances.
Must be in the range of 1 to 99. A range is separated with a dash mark. For example, instance=6-99 updates instances from 6 to 99. |
| /Update | Required | Updates the specified instance or instances that are associated with the contract. |
| /Force | Optional | Permits breaking updates. |
Notes on usage
- If a range of instances is specified, the included instances are registered consecutively. If the registration of an instance fails, the processing stops, and further instances (those of higher numbers) are not processed. A failed instance is not updated. Instances of lower numbers that were already processed successfully remain updated.
- You can only introduce new contract types in an update. If support for contract types is removed, the command fails. In that case, you can use the /Force flag to force a breaking update.
Example
The following example demonstrates how the instances from 1 to 5 can be updated on the server host42.
ManageCM /RegisterInstance /Host=host42 /Instance=1-5 /Update