Installing Platform

Introduction

vuLauncher is a specialized application designed to facilitate the installation of vuSmartMaps™ within a Virtual Machine (VM) based environment. It offers a user-friendly graphical user interface (UI) through which users can input essential details about the target environment.

Link to Build: https://download.vunetsystems.com/_Downloads_/_vuDocker_/vuSmartMaps.tar.gz

Prerequisites

Installation Steps

Starting Launcher

Follow these steps to initiate SiteManager:

1. Download the tar file and extract it in the main VM (by default Node1) Build
2. Command to download the build –

   wget https://download.vunetsystems.com/_Downloads_/_vuDocker_/vuSmartMaps.tar.gz --user=<username> --password=<password> --no-check-certificate

   • Extract the tar file: tar xvzf vuSmartMaps.tar.gz
   • Once you extract you should see the following :
     launcher/static-files/
     build/launcher_linux_x86_64 binary
   • To start execute : ./build/launcher_linux_x86_64
3. Access the launcher via:

   http://<your_server_ip>:8080/

   You will be redirected to the Welcome Page.

4. Welcome Page
   • This will be the starting page.
   • Click the Proceed to Install button, to move to the next stages.

License Upload

1. Here you need to provide a valid license. This license file will contain the services that will be installed and its required resources.
2. Drag and drop on the selected area or click the area that will open File Explorer.
3. Once it finds the license is valid, then click Continue. If the license is invalid, please check the license format and retry.

Installation Environment

VM Selection

1. Here you will be prompted with your installation environment choice selection.
2. Currently we only support Virtual Machine Environment Types. Others are coming in the next phases.
3. Click on Virtual Machine and Continue Button.

Configure

VM SSH Credentials

Upon redirection, provide VM SSH credentials. Currently, one shared username and password/private key are assumed for all VMs, with plans for future enhancement. Add each VM’s internal IP, and then click on Continue. On clicking, following events will take place:

1. Validation of Credentials: Backend validation is triggered
2. Reachability Check: An error will appear if the VMs are not reachable.
3. Data Retrieval: Successful validation fetches Core, Memory, and Disk data from VMs.
4. Intelligent Allocation: The system intelligently allocates services to available VMs based on this data and license details, following a backtracking algorithm.

Once service-to-VM mapping succeeds, the Button loader stops. Click Continue to proceed. This ensures efficient service distribution based on resources.

Customize

Service – VM Mapping

Verify and confirm the service-to-VM mapping:

Customization of this mapping, if required, can be done.

Mapping

Port Configuration

Once the customization of VM  mapping is done, click on Continue and you will be redirected to the port configuration page, where you can override the default port of a service.

Deploy

Summary Page

Review credentials and configuration on the summary page:

1. Verify details.
2. Click on Start deployment to initiate the installation process.

Installation Process

The installation process commences, with communication between frontend and backend facilitated through a WebSocket connection. In case of errors, installation halts and an error window is displayed.

After the successful installation access the vuSmartMaps using the provided access details.

Upcoming Enhancements

 Anticipate the following improvements in future releases:

1. Enhanced UI experience.
2. Log downloading in case of installation failure.
3. Provision of an executable build instead of a tar file.
4. Support for different authentication keys for each VM.
5. Implementation of HTTPS security.
6. Integration of fasthttp for improved performance.

Troubleshooting

1. Configuration Failed : mountPath /data not present in VM

To fix this issue, perform the steps below.

• Login to VM
• Create /data directory using below command
          sudo mkdir -p /data
          sudo chown vunet:vunet -R /data