AC Express: Customer Onboarding Process

Table of Contents:

1. Credentials and Network Setup

1. Verify Bastion Credentials:

   • Once you receive the Bastion from Connectria, log in and verify the credentials.

2. Network Security Configuration:

   • Allow Adeptia office IP in the virtual machine network security group inbound rules.

2. Prerequisite Software Installation

3. Download Prerequisites:

   • Download required software from Google Drive (ACExpress pre-required software).

4. Install Software:

   • Install all required software on the Bastion.

5. Install CLI for Windows:

   • Open PowerShell and run the following command to install Chocolatey:

     bash

     Copy code

     Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

3. Database Configuration

6. Database Setup:

   • Create the connection from the workbench.

   • Verify the DB user provided by Connectria.

   • Create the database and users. Example command:

     Copy code

     create user '<<customer_name>>productionuser'@'%' IDENTIFIED BY 'password'; GRANT ALL PRIVILEGES ON <<customer_name>>_backend.* TO '<<customer_name>>productionuser'@'%' WITH GRANT OPTION;

4. YAML and Cluster Setup

7. Prepare YAML Configuration:

   • Prepare the YAML file as per the client’s license and details provided via email.

8. AKS Cluster Setup:

   • Add the Bastion IP in the AKS cluster network security settings.

5. Helm and Adeptia Connect Installation

9. Install Helm:

   • Install Helm in the Bastion:

     Copy code

     choco install kubernetes-helm

10. Disable SSL Setting:

    • Disable the SSL setting from the database server.

11. Install Adeptia Connect:

    • Install Adeptia Connect using Helm:

      Copy code

      helm install <<release name>> <<adeptia connect helmcharts path>>/ --timeout 10m --debug -n <<namespace>>

6. NGINX and Ingress Setup

12. Install NGINX:

    • Download NGINX v9.3.32 and apply the ingress rules:

      Copy code

      kubectl apply -f ingress.yaml

7. EAR Setup and License Deployment

13. Create EAR Folder:

    • Create an EAR folder in the shared path and place the EAR file.

14. Deploy the Latest License:

    • Deploy the latest license provided by the support team and restart the license microservice.

8. Environment Configuration

15. Configure Client Environment:

    • Log in to the environment and configure the following:

      • EAR Settings

      • SMTP Configuration

      • AI MAP Settings

      • Logging Level (Set to Error)

      • Application Password: Default password is changeit.

9. Monitoring and Backup Setup

16. Install EFK:

    • Download and install the EFK stack:

      Copy code

      helm install efk efk-stack/ -n logs

17. Install Grafana:

    • Download and install Grafana using Helm:

      Copy code

      helm install grafana-prometheus kube-prometheus-stack -n monitoring

10. Velero Backup Configuration

18. Velero Backup Configuration:

    • Create a namespace velero and a container in Azure Blob Storage.

    • Install Velero using the command:

      Copy code

      velero install --provider azure --plugins velero/velero-plugin-for-microsoft-azure:v1.5.0 --bucket <<BLOB_CONTAINER>> --secret-file <<file path>>/credentials-velero.txt

11. Final Generative AI Configuration

19. Generative AI Configuration:

    • Go to Account > Settings > Microservice Settings > AIMap and configure AI settings.

Summary

he AC Express installation process involves several stages to ensure a smooth setup. First, you begin by verifying the Bastion credentials provided by Connectria and configuring network security to allow Adeptia's office IP in the virtual machine’s security group. Once this is set up, the required software is downloaded from Google Drive and installed on the Bastion, including installing the CLI for Windows using Chocolatey.

Next, the database is set up by creating the necessary databases and users with the appropriate privileges. After that, the YAML configuration is prepared based on client-specific details, and the Bastion IP is added to the AKS cluster network security. Once these steps are completed, Helm is installed on the Bastion, SSL settings on the database server are disabled, and Adeptia Connect is installed using Helm.

Following the Helm installation, NGINX v9.3.32 is installed, and ingress rules are applied. An EAR folder is created in the shared path, the EAR file is uploaded, and the latest license provided by the support team is deployed. The environment is then configured, which includes enabling EAR settings, setting up SMTP, enabling the AI MAP feature, and adjusting the logging level.

For monitoring and backup, the EFK stack is installed for log management, and Grafana is installed with Prometheus for monitoring. Additionally, Velero is set up for backup, using Azure Blob Storage as the storage location. Finally, the setup is completed by configuring the AI Map properties for generative AI functionality within the system, ensuring all components are properly integrated and configured. This process ensures a fully functional AC Express system, ready for use.