This section describes how to export the seed file, activate, and deactivate an appliance.
Exporting the seed file/ISO
Once the new appliance record has been created within the admin UI, you'll need a seed file to activate the target appliance.
To export the seed file:
Navigate to Appliances (System > Appliances).
Hover over the newly-created appliance in the list and select Export Seed File/ISO.
NOTE
It is not possible to seed a newer target appliance than the Controller version you are using to export the seed.
Activate the appliance
If you haven’t already, you will need to perform an appliance installation on a physical/virtual host or use a Cloud instance of the appliance. Ensure you have SSH access to the new appliance and that it has access to the Controller on port 443.
When the new appliance finds a valid JSON (or ISO) seed file, it automatically activates. The seed file remains valid only for the Seed Lifetime that was selected. It is also possible to seed an appliance manually once it is up and running.
After a new appliance has been seeded, it will establish communication towards the Controller. As part of the registration it will get a signed certificate and change its status from Pending to Active.
Once activated, the temporary certificate included in the seed file is deleted. This means a seed file can only be used once if activation succeeded, so a new seed file will have to be generated to reactivate it.
Once communications are established, the Controller messages the appliances. For example, asking for health status or telling Gateways which tokens are no longer valid.
Manually seeding an appliance
NOTE
If you are re-seeding an existing appliance, you may need to wipe it before it will accept a new seed file. This can be done by using the command
sudo cz-config wipe-appliance --force
If you need to seed an appliance manually, you do this by passing the seed to the appliance.
NOTE
If you download the JSON seed file, it may be renamed but must end in -
seed.jsonor be exactlyseed.json
To pass the seed to the appliance:
With SSH access |
|
For the cloud | Upload the seed using SCP to the appliance. For example: |
For remote hardware | Mount the seed ISO to the appliance using the Virtual Media function in the iDRAC. |
For local hardware |
|
For a virtual host |
|
Deactivating or migrating an existing appliance
You can deactivate an appliance when migrating it from one host to another, or when removing an appliance from a Collective that you intend to reactivate in the future.
If migrating, the existing appliance needs to be deactivated and taken offline; the seed file is then re-exported for the new appliance.
NOTE
If you are migrating a Gateway, it is recommended to have another Gateway serving the same Site to ensure that migration is seamless.
To deactivate an appliance:
In the Appliances page, select the three dots next to the appliance and select Deactivate.
NOTE
You cannot deactivate an active Controller. The Controller function must be disabled first.
To avoid having the new and old appliances claim the same hostnames:
Power down the old appliance; or
Wipe the appliance using the command:
sudo cz-config wipe-appliance --force
The appliance will no longer appear as Active in the Appliances page.