diff --git a/images/setup_nextronInstaller-diagnostics.png b/images/setup_nextronInstaller-diagnostics.png new file mode 100644 index 0000000..76e2a10 Binary files /dev/null and b/images/setup_nextronInstaller-diagnostics.png differ diff --git a/images/setup_nextronInstaller-fqdn.png b/images/setup_nextronInstaller-fqdn.png new file mode 100644 index 0000000..3269f12 Binary files /dev/null and b/images/setup_nextronInstaller-fqdn.png differ diff --git a/images/setup_nextronInstaller-landing.png b/images/setup_nextronInstaller-landing.png new file mode 100644 index 0000000..08998f3 Binary files /dev/null and b/images/setup_nextronInstaller-landing.png differ diff --git a/images/setup_nextronInstaller-settings.png b/images/setup_nextronInstaller-settings.png new file mode 100644 index 0000000..c141455 Binary files /dev/null and b/images/setup_nextronInstaller-settings.png differ diff --git a/images/setup_nextronInstaller.png b/images/setup_nextronInstaller.png new file mode 100644 index 0000000..13eebb7 Binary files /dev/null and b/images/setup_nextronInstaller.png differ diff --git a/setup/components.rst b/setup/components.rst index d4872a5..72fe967 100644 --- a/setup/components.rst +++ b/setup/components.rst @@ -1,33 +1,141 @@ .. Index:: Install Service -Install the Analysis Cockpit Services -------------------------------------- +Install the ASGARD Analysis Cockpit Service +------------------------------------------- -The base installation is now complete. In the next step we'll install -the Analysis Cockpit service. +The Nextron Universal Installer is a web based installer +which will guide you through the installation of our +ASGARD products. The Nextron Universal Installer will install +**one** of the following products on your server (this manual +focuses on the ``ASGARD Analysis Cockpit``): -.. important:: - - Internet connectivity is required for this step. - - Use an upper case ``i`` in the word ``nextronInstaller``. +- ASGARD Management Center; alternatively if your license permits: + + * ASGARD Broker + * ASGARD Gatekeeper + * ASGARD Lobby -Use the VMWare console or SSH to the appliance using the user -``nextron``. +- Master ASGARD -To start the Analysis Cockpit installation run the following command: +- ASGARD Analysis Cockpit; alternatively: + + * Elasticsearch Cluster Node for ASGARD Analysis Cockpit -.. code:: console - - nextron@asgard-ac:~$ sudo nextronInstaller -cockpit +- ASGARD Security Center, in the following variants: -After the installer has completed its operations successfully, the -system is ready to be used. + * ASGARD Security Center (Backend Only) + * ASGARD Security Center (Frontend Only) + * ASGARD Security Center (All-in-one, unrecommended) -.. figure:: ../images/nextron_installer_cockpit.png - :alt: Message upon successful completion +.. note:: + You can only install one product on one server, since the + products are not designed to coexist on the same server. + The exception being the ASGARD Security Center (All-in-one). - Message upon successful completion +The installation takes roughly between 5-15 minutes, depending +on your internet connection and the server you are installing +the product on. -Note that the FQDN shown after ``https://`` has to be resolvable by the -connected ASGARD Management Centers and users that try to access the -Analysis Cockpit. +If you encounter problems during your installation, please see +:ref:`setup/components:diagnostic pack` for further instructions. +Requirements +~~~~~~~~~~~~ + +The installation of the ASGARD Analysis Cockpit requires +the following: + +- A valid license file for the ASGARD Analysis Cockpit +- A configured FQDN (with some exceptions, see :ref:`setup/components:valid fqdn`) +- Internet access during installation (see :ref:`setup/components:connectivity check`) + +Installation +~~~~~~~~~~~~ + +After the ISO installer is finished with the setup, +you will be greeted at the console login prompt with +the following message: + +.. figure:: ../images/setup_nextronInstaller.png + :alt: Login prompt ASGARD Server + +Follow the instructions and navigate to the webpage +displayed on your console. You will most likely get +a browser warning when you connect the first time to +the page. This is due to the page using a self signed +certificate, since it will only be used to install the +ASGARD Analysis Cockpit. You can safely ignore this +warning and proceed to the page. + +You will be greeted with a small introduction as to what +the Nextron Universal Installer is and what it does. After +you click ``Next``, you will be presented with the landing +page of the Nextron Universal Installer. + +.. figure:: ../images/setup_nextronInstaller-landing.png + :alt: landing page of the Universal Installer + +Enter the Installation Code from the terminal and click +``Next``. The Installer will now guide you through the +installation. + +Connectivity Check +~~~~~~~~~~~~~~~~~~ + +The Nextron Universal Installer will try to connect to our +update server in order to download all the necessary packages +once the installation starts. Make sure you can reach the +update servers (see :ref:`requirements/network:internet access during installation`). + +Please configure your proxy settings if you are behind a +proxy (see :ref:`setup/components:proxy and ntp settings`). + +Valid FQDN +~~~~~~~~~~ + +The Nextron Universal Installer will prompt you to verify the +FQDN which you configured during the installation of the base +system (see :ref:`setup/network:network configuration`). This +is needed in order for your ASGARD Management Center to communicate +via a HTTPs connection with the ASGARD Analysis Cockpit. The Management +Center will use the FQDN of your Analysis Cockpit to connect to +it and also verify the Common Name of the certificate to verify its +authenticity. If there is a mismatch the Management Center will +not be able to sync events with the Analysis Cockpit. + +If the displayed FQDN is not correct, you can change it by +clicking on the ``View FQDN Change Instructions`` button. +This will open a dialog with instructions on how to change +the FQDN of your server. Once you have changed the FQDN, +you can continue with the installation. + +.. figure:: ../images/setup_nextronInstaller-fqdn.png + :alt: FQDN Verification of the Universal Installer + +Proxy and NTP Settings +~~~~~~~~~~~~~~~~~~~~~~ + +If you need to configure a proxy or change the NTP settings +of your system, you can do so by clicking on the ``Settings`` +button in the left menu of the Nextron Universal Installer. + +.. figure:: ../images/setup_nextronInstaller-settings.png + :alt: Settings of the Universal Installer + +If you configured a proxy during the ISO installation, those +settings will be carried over into the Universal Installer. +The settings will also be carried over into your ASGARD +Analysis Cockpit. The same goes for NTP. + +Diagnostic Pack +~~~~~~~~~~~~~~~ + +In case of errors or problems during the installation, you can +download a diagnostic pack by navigating to the ``Diagnostics`` +tab in the left menu of the Nextron Universal Installer. Click +on the ``Download Diagnostic Pack`` button to download the +diagnostic pack. You can then send the diagnostic pack to our +support team for further analysis. + +.. figure:: ../images/setup_nextronInstaller-diagnostics.png + :alt: Diagnostics of the Universal Installer \ No newline at end of file