Set up the Solution
================================================================================
After completing the steps in :doc:`subscribe_to_inoqulate`, the deployment
should complete in about 20 minutes.

.. image:: ./images/inoQulate_deployed.png


.. _connect-to-file-share:

Connect to the Azure File Share
--------------------------------------------------------------------------------
Choose one of the two ways to connect to the Azure File Share deployed for the
inoQulate solution.


Using Azure Cloud Shell (recommended)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. warning:: Azure Cloud Shell Configuration Change

   This section changes the configuration of your Azure Cloud Shell to mount the
   Azure File Share for the inoQulate solution. When the setup is complete, you
   may wish to change your configuration back to your preferred settings through
   **Settings** > **Reset User Settings**.

#. In the Azure `portal <https://portal.azure.com/>`_, enter ``Kubernetes Services`` in the search box. Select **Kubernetes Services**.
#. Click ``inoQulate``.
#. Click ``Connect``.
#. Under the **Set cluster context** section, click **Open Cloud Shell**.

   - If this is your first time using the Cloud Shell, you may need to go through an initial setup process.
   - If you are taken straight to a terminal (and have not mounted it to the Azure File Share yet), click **Settings** and then **Reset User Settings**.
   - If you are prompted to choose between **Bash** and **Powershell**, pick **Bash**.

#. You are presented with an option to mount a storage account. Select **Mount Storage Account**.
#. Select the subscription that inoQulate is deployed into.
#. Click **Apply**.
#. Click **Select existing storage account**.
#. Select the **Subscription** inoQulate is deployed into.
#. Filter the resource group with ``MC_``, and select the resource group ``MC_<Managed Resource Group>_inoQulate_<location>``, where ``<Managed Resource Group>`` is the Managed Resource Group name configured in :ref:`the subscription process <subscribe-to-inoqulate-basics>`.
#. For **Storage account name**, select the only option.
#. For **File Share**, select ``storage``.

   .. image:: ./images/connect_cloud_shell.png

#. Allow some time for the terminal to connect.
#. If the commands under Step 2 of the **Set cluster context** section is not run, run them.
   

Using your own Bash terminal
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Alternatively, you may choose not to use the Azure Cloud Shell but your own
bash terminal. To do so, the requirements are as follows:

- ``sudo`` to have permissions to mount the drive
- ``cifs-utils`` to connect to the File Share using CIFS protocol
- ``az`` to get the cluster credentials
- ``kubectl`` and ``helm`` to interact with the cluster
- java ``keytool`` to create a Java keystore
- ``jq`` to manipulate JSON output
- ``curl`` to download configuration files and make health check requests to the services.


.. _access-file-share:

Access the Azure File Share from the Azure Portal
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
#. Go to the `Azure Portal <https://portal.azure.com>`_.
#. In the search bar, search for the resource group ``MC_<Managed Resource Group>_inoQulate_<location>``, where ``<Managed Resource Group>`` is the Managed Resource Group name configured in :ref:`the subscription process <subscribe-to-inoqulate-basics>` above resource group.
#. Click on the resource group.
#. In the list of resources in the resource group, click on the **Storage Account**.
#. In the left panel, expand **Data Storage** and click on **File shares**.
#. Click on ``storage``.

You can browse the files in the File Share from this page by clicking **Browse**
in the left panel.


Connect the File Share to your terminal
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
#. From the File Share page, click **Connect**.
#. Follow the instructions for your Operating System.


Download and install setup files
--------------------------------------------------------------------------------
#. In your terminal, run the following commands.

   .. note::

      If using your own Bash terminal, please change directory to the ``config`` directory inside your mount point instead.

   .. code-block:: bash
   
      cd clouddrive/config
      curl -O https://raw.githubusercontent.com/pqcee/public/38dd8b77caa47348667b668c99bd9a9b4fdb5c0f/inoQulate-v1.2.0-config.zip
      unzip inoQulate-v1.2.0-config.zip

#. If there are no errors, continue by running.

   .. code-block:: bash

      ./setup.sh

#. Allow about 20 minutes for the setup to complete. The console output is also written to ``log.txt`` in the same directory. If you encounter any issues with the setup, download and include ``config/log.txt`` from the :ref:`File Share <access-file-share>` in your support request.
#. The installation completed successfully when you see the message:
 
   .. code-block:: text
 
      inoQulate is now ready to be used!

   .. image:: ./images/inoQulate_ready.png


.. _install-verifier:

Install the inoQulate PDF Verifier
--------------------------------------------------------------------------------
The inoQulate PDF Verifier installer is available for the Windows platform. The
installer is included in the File Share.

Download from the Azure Cloud Shell
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Download the installer directly from your Azure Cloud Shell.

#. In the Azure Cloud Shell panel, click **Manage Files** and then **Download**.
#. Paste the following text in the required field. 

   .. code-block:: text

      clouddrive/config/inoQulate.PDF.Verifier_1.0.0_x64_en-US.msi

#. Click the notification to download the file.

Download from the Azure Portal
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Download the installer from the Azure Portal.

#. On the Azure Portal, access the :ref:`File Share <access-file-share>` page.
#. On the left panel, click **Browse**.
#. Click the ``config`` directory.
#. Click ``inoQulate.PDF.Verifier_1.0.0_x64_en-US.msi``.
#. Click Download.


Install the verifier
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
#. Run the ``inoQulate.PDF.Verifier_1.0.0_x64_en-US.msi`` the installer. You need administrative privilege to run the installer.
#. Go through the installer wizard to the **Completed** page by clicking **Next** and **Install**. You do not need to change any settings in the wizard.
#. Uncheck **Launch inoQulate PDF Verifier**.
#. Click **Finish**.