.. _setup:

Setup
=====

This chapter covers the first steps of the setup of your appliance.
The steps in this chapter are shared among the various GSM appliance models.
You will find appliance specific setup and trouble shooting in the chapter :ref:`setup_guides`:

* :ref:`setup_guide_gsm_one`
* :ref:`setup_guide_gsm_25v`
* :ref:`setup_guide_gsm_25`
* :ref:`setup_guide_gsm_100`
* :ref:`setup_guide_gsm_5x0`
* :ref:`setup_guide_gsm_400_6x0`
* :ref:`setup_guide_gsm_5300`

|gb_video| The setup is also explained in a video at http://docs.greenbone.net/Videos/gos-3.1/en/GSM-Setup-GOS-3.1-en-20150629.mp4.

.. include:: adminlogin.rst

.. include:: basekbnet.rst

.. include:: mgmtnic.rst

.. include:: dnsconf.rst

.. include:: pwchange.rst

.. include:: websetup.rst


.. _activation_key:

Activation key
--------------

Every Greenbone Security Manager appliance requires an activation key.
The GSM ONE already comes with a pre-installed activation key.
If you are evaluating a GSM DEMO an activation key is already pre-installed.

If an activation key is installed can be verified by starting up the GOS-Admin-Menu.
The title bar shows if an activation key exists.
In the example in figure :ref:`fig:gsm-activate` the subscription ``gsf201309161`` is stored.

.. _fig:gsm-activate:
.. figure:: images-3.1/gsm-activate.png
   :align: center
   :width: 70%

   Verifying of the activation key

Alternatively from the command line execute :gos:cmd:`show customer`.

.. figure:: images-3.0/gsm-customer.png
   :align: center
   :width: 70%

   Verifying of the activation key from the command line

If no activation key is stored you should have received it usually separately.
After running :gos:cmd:`subscriptiondownload` you must enter they key via copy/paste.
Ideally this is done via SSH connection with the appliance.
Possibly SSH access needs to be activated (see :ref:`ssh_access`).

.. include:: readiness.rst