register - Manage the appliance S/N and license key registration
[1] register [appliance (new <email> [<otp>]) | (old [<otp>])]
[2] register [license <license-key>]
[3] register [clear]
The registration process associates an appliance to a S/N (Serial Number) that uniquely identifies that appliance. The registering is free and allows you to subscribe to optional services or purchase subscriptions for commercial installations. Note that a S/N is bound to the first MAC address of an appliance and can’t be modified.
Without any arguments, the register command shows the appliance registration/subscription state and gives you useful information about the appliance registration/subscription.
The first usage form of this command allows you to register an appliance in order to get its unique S/N. If you register an appliance for the first time, use the keywords appliance new followed by a registration email address and a registration OTP (One Time Password). To get a registration OTP please go to the menu option [GENERAL] > [Main Settings] > [Registration & Subscription] of the Web GUI, select "First Registration" and click on the "Get OTP" button. Alternatively you can get the registration URL by using the register command without any arguments. You must provide a valid and active email address to properly register the appliance. Otherwise the registration fails. In case where no OTP is specified, you will be prompted to enter the OTP in hidden mode.
If the appliance has been previously registered and for any reason (an OS reinstallation for instance) its S/N is no longer locally assigned to it, you can recover its S/N by re-registering it. To recover the S/N of an already registered appliance, use the keywords appliance old followed by a re-registration OTP. To get a re-registration OTP, please go to the menu option [GENERAL] > [Main Settings] > [Registration] of the Web GUI, select "Already Registered" and click on the "Get OTP" button. Alternatively you can get the re-registration URL by using register command without any arguments. Please note that during the re-registration process the previously used registration email address is asked and the OTP is sent to that email. In case where no OTP is specified, you will be prompted to enter the OTP in hidden mode.
Please note that to register, the appliance should be connected to the internet and have access to the registration services (https://appliance.cacheguard.net and https://os.cacheguard.net) during the whole registration process.
For commercial installations, the registration and subscription become mandatory. After having registered and appliance and subscribed for a given period of time, a license key is assigned to the appliance. The license key is used to activate a subscription on an appliance for the first time. Following the initial subscription period, a subscription renewal is required to continue to use the appliance. In case where the renewal in time is omitted, the appliance enters into a suspended mode. In suspended mode, Web traffic via the Web gateway (forwarding Web proxy) are blocked in and the system configuration is locked (can no longer be modified). To reactivate a suspended appliance, you should proceed with its subscription renewal. After getting the renewal confirmation, the appliance is automatically reactivated during the night following the renewal confirmation date. The reactivation can also be manually done by re-registering the appliance license key (see the second usage form below). To avoid any service interruption, it is highly recommended to renew a subscription before its expiry date.
The second usage form of this command allows you to activate a subscription on an appliance using a license key. To activate a subscription use the keywords license followed by the license key.
The third usage form allows you to deregister an already registered appliance. You may need to deregister an appliance in case where you need to replace its first hardware NIC (Network Interface Card) and then need to get a new S/N for it. Please note that a S/N and a license key are valid on a unique machine only. Refer to the CacheGuard-OS License Agreement for further information (see the license command). To deregister an appliance use the keyword clear.
A hardware NIC is identified by a MAC address that is universally unique and guarantees a successful appliance registration. If you install the OS on a VM (Virtual Machine), you should ensure that its first NIC is unique at least in your environment. If the chosen MAC address is already registered for a another appliance, the registration fails. In this case, we suggest that you modify your VM’s MAC address and try to register it again.
apply (1) system (1)
CacheGuard Technologies Ltd <www.cacheguard.com>
Send bug reports or comments to the above author.
Copyright (C) 2009-2024 CacheGuard - All rights reserved