Skip to main content
  1. AVRL
  2. General Documentation
Accessing a Linux Virtual Machine and Running a Bot Manually
Accessing a Linux Virtual Machine and Running a Bot Manually

Accessing a Linux Virtual Machine and Running a Bot Manually

  • Updated

Use this guide to access your Linux virtual machine through the Windows Bastion VM, start AVRL-Fit if needed, and run a bot manually for testing or troubleshooting.

 

This guide applies when AVRL has deployed your infrastructure within your organization’s Google Cloud Platform (GCP) account.

 

 

Linux virtual machines are accessed through a Windows Bastion VM.

Step 1: Connect to the Bastion VM

  1. On your Windows desktop, select Start and search for IAP Desktop.
  2. Open IAP Desktop.
  3. In the left navigation pane, expand your Project Name to view the available virtual machines.
  4. Locate the Windows Bastion VM. It is typically named bastion-vm and appears alongside the bot-vm instances.
  5. If the Bastion VM is powered off:
    1. Right-click the VM.
    2. Select Control > Start.
  6. Once the Bastion VM is running, double-click it or right-click and select Connect.

Step 2: Connect to the Linux Virtual Machine

 

After connecting to the Bastion VM:

  1. Select Start.
  2. Search for and open Remote Desktop Connection.
  3. Enter the IP address of the Linux virtual machine you want to access, such as bot-vm01 or bot-vm02.
  4. When prompted, enter the Linux VM username and password.
  5. Select Connect.

Note: AVRL will provide your team with the Linux VM IP address, username, and password when the virtual machine is created.

 

 

Step 3: Start AVRL-Fit Manually

AVRL-Fit typically runs on the Linux virtual machine. If the service is not running, you can start it manually using one of the methods below.

Method 1: Use File Explorer (Recommended)

  1. Select Activities in the top-left corner of the desktop.
  2. Select the Files icon from the dock at the bottom of the screen.
  3. In the left navigation pane, select Home.
  4. Open the AVRL_GENERATION folder.
  5. Open the AVRL-Fit folder for the instance you want to start.
  6. Locate the avrl-fit executable file.
  7. Double-click avrl-fit to launch the application.
  8. Wait for AVRL-Fit to finish launching before continuing.

Important: If the virtual machine contains multiple AVRL-Fit instances, confirm that you are opening the correct instance folder before launching the application.

 

Method 2: Use the Terminal

  1. Open Terminal.
  2. Navigate to the AVRL-Fit installation directory by running:
cd "AVRL_GENERATION"
cd AVRL-Fit
  1. Start AVRL-Fit by running:
./avrl-fit
  1. Wait for AVRL-Fit to launch successfully before continuing.

 

Step 4: Run a Bot Manually

After AVRL-Fit has started:

  1. Select the spotbot displayed in the center of the AVRL-Fit window.
  2. Press the Alt key to display the Developer Tools option.
  3. In the pop-up that appears in the top-left corner, select Open Main Page DevTools.
  4. Wait for the Developer Tools window to open.
  5. In AVRL-Fit, use the bot search box to locate the automation you want to run.
  6. Enter the tree name using the following format:
TREENAME:<treename>

Example:

TREENAME:lb_jda_pepsi
  1. Select the bot from the search results.

Selecting the bot will start the automation immediately.

Important: Once the bot is running, do not interact with the TMS page or make any changes until the automation has finished.

Note: Automations run automatically according to their configured schedules. Only run a bot manually when AVRL instructs you to do so for testing or troubleshooting.

Before disconnecting from the virtual machine, confirm that all required AVRL-Fit instances are still running.