1.3. Set up the Solution

After completing the steps in Subscribe to inoQulate from the Azure Marketplace, the deployment should complete in about 20 minutes.

1.3.1. Connect to the Azure File Share

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

1.3.1.1. 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.

1. In the Azure portal, enter Kubernetes Services in the search box. Select Kubernetes Services.

2. Click inoQulate.

3. Click Connect.

4. 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.

5. You are presented with an option to mount a storage account. Select Mount Storage Account.

6. Select the subscription that inoQulate is deployed into.

7. Click Apply.

8. Click Select existing storage account.

9. Select the Subscription inoQulate is deployed into.

10. 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 the subscription process.

11. For Storage account name, select the only option.

12. For File Share, select storage.

    

13. Allow some time for the terminal to connect.

14. If the commands under Step 2 of the Set cluster context section is not run, run them.

1.3.1.2. 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.

1.3.1.3. Access the Azure File Share from the Azure Portal

1. Go to the Azure Portal.

2. 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 the subscription process above resource group.

3. Click on the resource group.

4. In the list of resources in the resource group, click on the Storage Account.

5. In the left panel, expand Data Storage and click on File shares.

6. Click on storage.

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

1.3.1.4. Connect the File Share to your terminal

1. From the File Share page, click Connect.

2. Follow the instructions for your Operating System.

1.3.2. Download and install setup files

1. 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.

   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
   

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

   ./setup.sh
   

3. 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 File Share in your support request.

4. The installation completed successfully when you see the message:

   inoQulate is now ready to be used!
   

   

1.3.3. Install the inoQulate PDF Verifier

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

1.3.3.1. Download from the Azure Cloud Shell

Download the installer directly from your Azure Cloud Shell.

1. In the Azure Cloud Shell panel, click Manage Files and then Download.

2. Paste the following text in the required field.

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

3. Click the notification to download the file.

1.3.3.2. Download from the Azure Portal

Download the installer from the Azure Portal.

1. On the Azure Portal, access the File Share page.

2. On the left panel, click Browse.

3. Click the config directory.

4. Click inoQulate.PDF.Verifier_1.0.0_x64_en-US.msi.

5. Click Download.

1.3.3.3. Install the verifier

1. Run the inoQulate.PDF.Verifier_1.0.0_x64_en-US.msi the installer. You need administrative privilege to run the installer.

2. 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.

3. Uncheck Launch inoQulate PDF Verifier.

4. Click Finish.