Installing Platform >

Installing Platform


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:


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 --user=<username> --password=<password> --no-check-certificate
    • Extract the tar file: tar xvzf vuSmartMaps.tar.gz
    • Once you extract you should see the following :
      build/launcher_linux_x86_64 binary
    • To start execute : ./build/launcher_linux_x86_64
  3. Access the launcher via:

    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.


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.


Service – VM Mapping

Verify and confirm the service-to-VM mapping:

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


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.


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.


  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


Browse through our resources to learn how you can accelerate digital transformation within your organisation.

Unveiling our all powerful IBMB Observability ExperienceCenter. Click Here