register

NAME
SYNOPSIS
DESCRIPTION
NIC AND MAC ADDRESS
SEE ALSO
AUTHOR
COPYRIGHT

NAME

register - Appliance and License Key Registration

SYNOPSIS

register [appliance (new <email> [<otp>]) | (old [<otp>])]

register [license <license-key>]

DESCRIPTION

The registration process allows you to get a free S/N (Serial Number) that uniquely identifies an appliance. This S/N is then used in a second step to purchase a subscription. As the S/N binds the first NIC (Network Interface Card) of a machine to the CacheGuard-OS running on it, we highly recommend that you register your appliance as soon as possible to reserve its S/N and ensure the uniqueness of its registered first NIC MAC address.

A subscription for a given period is effected by a license key, which is sent to you the first time you purchase a subscription. Following this initial subscription period a renewal is required to continue to use your appliance. If your subscription expires before the renewal, the appliance will enter into a suspended mode. In suspended mode all Web traffic in forwarding mode (mode web on) will be blocked while Web traffic in reverse mode (mode rweb on) will be allowed but without the possibility of applying a new configuration. To reactivate the appliance, simply renew your subscription. Your appliance will be reactivated automatically the next business day. In case where the reverse mode is deactivated, you have also the possibility to reactivate your appliance with the command apply after having received the confirmation of the renewal.

Without any arguments this command prints the current registration state and gives you important information for registering.

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 use the URL printed by the present command when used 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 use the URL printed by the present command when used 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 appliance license followed by your license key.

As license keys and OTP are long strings, we recommend that you register your appliance using the Web GUI in order to use the copy/paste function of your workstation to proceed with the registration. Furthermore you will have direct access to registration URL. Please note that for it to take effect, the apply command must be used. Also your appliance should be connected to the Internet and have access to registration services (HTTP/HTTPS) during the whole registration process.

NIC AND MAC ADDRESS

A NIC is identified by its MAC address (Ethernet address), which is universally unique for a hardware appliance, which guarantees a successful appliance registration. Consequently if you intend to install CacheGuard-OS on a VM (Virtual Machine), you should ensure that the first NIC of your VM is assigned a unique and static MAC address. If this is the first time registering a virtual appliance and the registration fails, if may mean that you are encountering a MAC address collision. In this case we suggest that you change the MAC address of your VM and try again.

SEE ALSO

apply (1) system (1)

AUTHOR

CacheGuard Technologies Ltd <www.cacheguard.com>

Send bug reports or comments to the above author.

COPYRIGHT

Copyright (C) 2009-2018 CacheGuard - All rights reserved