How to Install on Windows

Pre-requisites

This installation guide assumes that you have already set up a Windows VM on Azure and are ready to install the agent.

Before installing the agent on a Windows VM, ensure you have the latest version of PowerShell installed. Check out Installing PowerShell on Windows for more information.

You will need administrative privileges to install the agent.

Installing the Agent

Follow along with the below instructions to install and configure the Loome Agent on an Azure Windows VM.

Complete the Agent configuration wizard

On the agent slide-out, click the Download Agent Installer button to download the PowerShell installation script.

Agent name

Use the copy button to copy the PowerShell command to execute the installation script.

Also, take note of the installation location and service name for future reference.

Agent name

Installing on Windows

Open PowerShell as an Administrator in the folder that contains the new Loome agent installer.

Copy and run the following command in this PowerShell Window.

powershell –ExecutionPolicy Bypass .\InstallAgent.ps1

Agent name

The agent installer will pause for a few minutes while it downloads the agent.

Agent name

If prompted to install SnowSQL or Microsoft Genomics, enter N and press enter. These feature are not required for Loome Assist, they are used by other Loome modules.

Agent name

Once completed, you should see a green message indicating that the service has started. You will also see the agent installation location and service name, take note of these for your own reference.

Agent name

Completing additional configuration in the Azure Portal

Before we can use the Agent, we need to complete additional configuration on the Azure Windows VM containing the Agent.

We will configure the Agent with a Managed System Identity, and then provide it permissions to provision and manage resources within the Subscription.

Browse to portal.azure.com and locate the Resource Group where you provisioned the Azure VM and then click on it.

Azure Portal Open Container Instance

Locate the Identity menu option and click on it.

Azure Portal Agent

Under the System Assigned (preview) tab, click the On toggle for the Status.

Click the Save button above.

Azure Portal Agent Identity

When prompted, click Yes to the confirmation.

Azure Portal Agent Identity Confirm

Now click on the Azure Role Assignments button.

Azure Portal Agent Identity Confirmed

Click the Add Role Assignment (preview) button to add a new Role Assignment.

Azure Portal Agent Identity No Roles

Select Subscription for the Scope, Select your Subscription, and then select Contributor for the Role.

Click Save to add this Role Assignment.

Azure Portal Agent Identity Assign Role

Repeat this step until you have all of the Roles in the below table assigned.

Scope Subscription Role
Subscription Your Subscription Contributor
Subscription Your Subscription User Access Administrator
Subscription Your Subscription Resource Policy Contributor

Your Role Assignments should look like this once completed.

Click on the Agent name near the top left of the screen.

Azure Portal Agent Identity Assign Role Completed

Now lets restart the Azure VM so the Agent can connect to Loome Assist.

Click on the Restart button near the top.

Azure Portal Restart Agent

Click Yes to the confirmation message.

This process can take several minutes, you can remote in to the VM after 5 minutes and verify that the VM is running.

Azure Portal Check Status

You should now be able to go back to the Loome Assist Agent page and confirm that the Agent is connected.

The Agent will display a green status if everything has been configured successfully.

Loome Assist Agent Status

Additional Agent Configuration

You can optionally configure additional agent settings based on your needs.