Prerequisites

The setup script creates all the resources in an Azure account. In your Azure subscription, your account must have the following permissions.

Azure Subscription Permissions

• Your account must have the role of an Owner.
• If your account has the role of a Contributor, you do not have adequate permissions. Contact your Azure Account Administrator for getting the required permissions.

To check the permissions of your Azure subscription, follow these steps:

1. In the Azure Portal, select your account from the upper right corner, and then select My permissions.
   
2. From the drop-down list, select Subscription, and then click Click here to view complete access details for this subscription.
   
3. View the roles that are assigned to you. In the following image, the user has the role of the Owner, which means that the user has adequate permissions.
   

Azure Active Directory Permissions

You must have the role of a Global Administrator. If you do not have this role, contact your administrator to assign this role to you.

To check your Azure AD permissions, follow these steps:

1. From the left navigation pane of the Azure portal, select Azure Active Directory.
   
2. In Azure Active Directory, select Overview, and then view your user information.
   

The Quantum Fabric Containers on Azure Solution does not need any pre-installed software.

The following prerequisite packages are downloaded and installed as part of the installation scripts.

• azure-cli
• kubectl
• jq
• sponge.

NOTE: To make sure that the script is able to download all the necessary software, you might need to open outbound connections to the respective sites. For more information, refer to Appendices → Prerequisite Packages.

You can use the SSH protocol to connect and authenticate to remote servers and services. The Quantum Fabric setup requires an SSH key pair for authentication. The SSH public key is used for creating an Azure Virtual Machine and to install the Quantum Fabric Setup. You need to specify the SSH Public Key in the properties file.

On an Ubuntu terminal, use the ssh-keygen command to generate SSH public and private key files. The files are created by default in the ~/.ssh directory. The command can be executed from your local (Ubuntu) machine. The generated key must be named id_rsa.

For example, the following command is used to generate the SSH key pair using RSA encryption and a bit length of 2048:

ssh-keygen -t rsa -b 2048

You must create and configure a key pair as you need to provide them in the Configuration settings.

You can have any Domain Name for the solution, which you can purchase from any third-party organizations.

You must have a proper DNS, which you must map to the public DNS of the Application Gateway. For more information, refer to Appendices → Hosting your domain with Azure DNS.

For secure communication, you must acquire the SSL certs and provide them during the Installation process. The Azure Application Gateway requires certificates in the .pfx format. The SSL certs must be associated with the Domain Name that you have procured. For more information, refer to Appendices → Generate a PFX file from PEM .

Ensure that you place the SSL certificate (in the .pfx file format) in the ssl-cert folder, and then provide the Server Domain Name and AppGateway SSL Cert Password.

To enable HTTPS at the back end of the app gateway, follow these steps:

1. The SSL certificates with the cert data and key data must be in separate files (both in a .pem file format).
2. Save the Cert file as ingress.pem.
3. Save the Key file as ingress_key.pem.
4. Place the ingress.pem and ingress_key.pem files in the certs folder of the installation directory.