Welcome Page

• This will be the starting page for Installation.
• Click on Proceed to install button, to start with the actual NG installation.

Upload License

1. Here you need to provide a valid license. This license file will contain the services that are going to be installed along with its required resources.
2. Upload the valid license and click on Continue.

💡Note: Please get the updated license file from [email protected]

Installation Environment

1. Here, you will be prompted to select your installation environment choice
2. Select the installation environment as Virtual Machine.
3. Click the Continue button to proceed further.

Configure VM

1. Here you need to provide the VM Credentials, along with either private key or password-based authentication details.
2. Under the IP Address section. Add the Public IP address of the VM where you want to install the vuSmartMaps.
3. After providing the credentials, the metrics for the VM will be displayed on the right-hand side.
4. Verify the VM details and click on Continue.

💡Note: The VM Credentials will be shared, along with the VM details.

Configure Data Store

For Hyperscale data tier configuration, we have below options:

1. Hot: Most frequently used data will be stored here, so preferably choose a storage class that has high Disk IOPS.
2. Warm: The data that is not mostly accessed will be stored in warm disk space. So a default storage class would be sufficient.
3. Cold: This is where we will store data for Archival purposes. We store this data in S3 bucket (Minio).
4. In this step, we need to select the Nodes where we have the Hot, Warm, and Cold mounts available. And based on this section, the storage classes will be configured and used for storing data in the Hyperscale database.
5. Based on the requirements, choose the disk(s) required for the installation and click on Continue.

💡Note: HOT Disk should always be selected.

Configure Disk

1. Based on the previous step, 3 storage classes will be configured for each type of storage. Accordingly, we need to assign the storage class and encryption setting for each disk.
2. Along with the disk storage, select the Encrypted option here for the Hyperscale disk settings and click on Continue.

💡Note: Since we’ve only one mount point, we’re going with only Hot disk configuration. Select Warm as Longhorn-hdd and Cold as Longhorn-archive in case 2 more mount points are added.

Mapping

VM to Service Mapping (with advanced Configuration)

1. Here you can override the Service mapping to VM
2. By default, the vulauncher installation script will allocate resources to the available VM in the best possible way. Click on Continue if you’re fine with the default allocation.
3. If the user wishes to override, they can click the ‘Edit’ button. This will prompt them with a list of VMs, where they can increase or decrease the count as needed.
4. In the Advanced Configuration section, choose the set of VMs for a service. If a VM goes down, then kubernetes will choose the given set of VMs to bring up this service.  By default, all the nodes are chosen.

Customize

1. Here users can override the port that the service is running on.
2. There may be cases where your enterprise requires you to run standard services on non standard ports. Please configure the port for these services here.
3. To override, click the edit button of the respective service, and then write the required port number
4. Click Continue to proceed.

Install

1. Here this page shows the summary of the information that the user provided.
2. You can click the edit button on the details page, to move back to their respective section and override the change.
3. You can also click the name of the stepper window to move.
4. Then click Continue, to start the deployment procedure.

💡Note: Once you start the deployment, you cannot edit the configuration you provided.

Installation Process

1. The installation displays each event that will be performed.
2. Users can click Cancel Installation to stop the ongoing installation. Additionally, they can retry if the process is halted or if the installation stops.

💡Note: If for some reason, your browser or laptop closes and you lose this page, please execute this command and restart your configuration deployment. Please restart launcher using ./build/launcher_linux_x86_640

3. Once the installation is successful, a prompt will open. Here, users can click Go to vuSmartMaps, and it will redirect to the vuSmartMaps login page.

4. Use the login credentials displayed here to access the UI.

Post Deployment Steps

Once the deployment is successful, run the following command in the master node to own the kube config file and to list the storage classes

• sudo chown -R vunet:vunet /etc/kubernetes/admin.conf
• kubectl get sc

Along with the above, please verify the below scenarios

Default Timezone 

Each vuSmartMaps installation will have a default timezone configured in the About page. By default, this is set to UTC. This time zone serves as the base timezone for the platform and can only be updated by the Admin. The default timezone is used for:

• The user interface (observability): viewing Alerts, Dashboards, Reports, Log Analytics, and downloading Reports and Dashboards as PDFs with a Global time selector.
• Scheduling: The timezone for the scheduled time for Alerts and Reports.
• Distributed channels: Timezone of the content sent via Emails, SMS, WhatsApp, ITSM, etc.

User-specific Timezone

User-specific timezones can also be configured by each user from the Profile page, allowing customization of the timezone settings for individual preferences while the platform-wide operations adhere to the default timezone.

To specify the user-specific timezone, navigate to the User-Specific Timezone icon at the top right, which displays the timezone set by the user in their profile.

You can change this timezone by navigating to the profile section.

Select your desired timezone from the User Specific Timezone dropdown menu, and the system will update to reflect the chosen timezone.

Default Retention Settings

Each vuSmartMaps installation will have default data retention settings available under Platform Settings -> Data Retention -> Hyperscale DataStore.

Update the default settings accordingly as per the requirements

Multi-Node Installation

You must have access to the VM with the minimal configuration mentioned in the prerequisites below. You should have the ‘ssh’ credentials/key to be able to ssh to the virtual machine.

In the case of vuSmartMaps multi-node cluster installation, it is recommended to have a separate node apart from all vuSmartMaps nodes where we will run vuLauncher and vuSiteManager.

A dedicated VM for SiteManager with a minimum configuration of 200GB disk space, 16 cores, and 64GB RAM. This VM must have connectivity to all other nodes where vuSmartMaps will be installed. The OS of the VM should be linux.

License configuration will be different for multi node installation, please check with [email protected] for getting the license according to the installation environment.

A  user with passwordless sudo privilege to be present on all the VMs in the case of multi node deployment.

Ensure uniform credentials across all VMs i.e. same password or private key across all VMs

💡Note: For a multi node deployment, ports should be opened internally on all the nodes including sitemanager and launcher VMs. Apart from Traefik, other services can’t switch to other ports if there is a conflict with default ports. So, for this release, the default service ports will be used.