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 S/N is used to purchase a subscription for a given period of time. Note that a S/N is bound to the first MAC address of an appliance and can’t be modified.
When purchasing a new subscription, you receive a license key that allows you to activate your subscription. Following the initial subscription period, a renewal is required to continue to use your appliance. In case where the you omit to renew your subscription in time, your appliance will enter into a suspended mode. In suspended mode, Web traffic are blocked in forwarding mode (mode web on). Furthermore, the configuration of a suspended appliance is locked (you will not be able to modify any configurations). To reactivate a suspended appliance, you should proceed with its subscription renewal. After getting your renewal confirmation, you can manually reactivate your subscription by re-registering your license key again or wait for the automatic reactivation. The automatic reactivation is done the day following the renewal confirmation. To avoid any service interruption, it is highly recommended to renew a subscription before its expiry date.
Without any arguments, the register command gives you useful information on how to register your appliance. For already registered appliance, it prints its registration state.
The first usage form of this command allows you to register an appliance in order to get its unique S/N. If this is the first time registering your appliance use the keywords appliance new followed by a registration email address and a registration OTP (One Time Password). To get your 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 this command without any arguments. You should provide a valid and active registration email address to properly register your appliance. Otherwise the registration fails.
If your appliance has been previously registered and you reinstall CacheGuard-OS on it your S/N is no longer locally assigned to your appliance and it should be re-registered. To do so use the keywords appliance old followed by a re-registration OTP. To get your 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 this command without any arguments. Please note that during the re-registration process your previously given registration email address is asked and the OTP is sent to that email.
In both cases if no OTP is specified, you will be prompted to enter the OTP in hidden mode.
The second usage form of this command allows you to activate a subscription effected by a license key. To activate a subscription use the keywords license followed by your license key.
Please note that to register, your appliance should be connected to the internet and have access to the registration service (https://appliance.cacheguard.net and https://os.cacheguard.net) during the whole registration process.
The third usage for of this command allows you to unregister an already registered appliance. You may need to unregister an appliance in case where you made a clone of a virtual appliance and want to purchase a new subscription for it. Please note that a S/N and a license key are only valid on a unique machine and we reserve the right to disable duplicated appliances without notice. Please refer to the CacheGuard-OS License Agreement for further information (see the command license). To unregister 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. Consequently if you install the OS on a VM (Virtual Machine), you should ensure that its first NIC is at least unique 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 again.
apply (1) system (1)
CacheGuard Technologies Ltd <www.cacheguard.com>
Send bug reports or comments to the above author.
Copyright (C) 2009-2023 CacheGuard - All rights reserved