Linux Desktop Agent 1.2.1 Installation guide on Azure

Prev Next

Prerequisites: 

  • Make sure template VM is having unmanaged disk. 

  • The same name of the VM cannot be used for template registration. 

  • Tags should be added to VM, if tags are not added template cannot be register in Workspot control. 

  • Only Ubuntu 20.04, Debian 10, Red hat 7.9 and CentOS 7.9 are supported for now. 

Creating Linux VM on Azure:  

  • Follow the Azure VM creation steps as like Windows OS, only make sure to choose image based on your requirement. We support Ubuntu 20.04, Debian 10, Red Hat 7.9, and CentOS 7.9 for now. 

  • Administrator account: Choose Administrator account either SSH or Password. If SSH public key option selected, please enter Username, or go with default name. 

  • If you choose SSH public key option for Administrator account, you will get a pop-up to download PEM file, download private key. 

  • If password selected, please enter Username and password through which we can be able to login further. 

  • In Disks tab, Choose HDD and Unselect “Use managed disks” checkbox. 

  • In the Networking tab, select required Virtual Network, subnet and select public IP as None. 

  • In Tag tab, please add WorkspotTemplate name and give value as 1. 

  • Finally in review and create tab, Create VM. 

  • Go to resource > Search for created VM and Copy Private IP of it. 

Install Linux agent in VM: 

To Install the Linux agent in VM, we should access that VM terminal through Putty. As the VM has only private IP, the VM can’t be accessible directly over the internet. So, first access any Windows machine through the Remote Desktop gateway or through the Utility server and install putty in that machine.   

  • RDP windows and install putty software. 

  • Login to Linux VM from putty 

  • If you created Linux VM through “Password” administrator account – then directly click on Open button in above step and enter Username/Password in terminal. 

  • However, if you created Linux VM through SSH public key. Convert pem file to ppk file using PuTTYGen installed with putty software. Copy that ppk file to windows RDP machine to access Linux VM though putty. After giving Private IP in putty. Go to SSH > Auth > Browse ppk file location. Then click on the Open button.  

  • Give Username as Login in terminal. 

  • After login to Linux VM terminal, change root password to default password that was used for administrator using command – “sudo passwd root” and enter new/confirm password. 

  • Below is the confirmation that password is updated successfully. 

  • Download installer script from URL using below command based on Linux distributor, 

  • For Ubuntu: “curl -O https://workspotbuilds.blob.core.windows.net/product/focal/workspot_installer.sh” 

  • For Debian: “curl -O https://workspotbuilds.blob.core.windows.net/debian/dev/workspot_installer.sh” 

  • For CentOS/RHEL: “curl -O https://workspotbuilds.blob.core.windows.net/product/el7/workspot_installer.sh” 

  • Once downloaded check the script is available or not. 

  • Give executable permission to script  

Command – chmod +x workspot_installer.sh 

  • Run the script using the command below. 

Command - “sudo ./workspot_installer.sh” or “sudo bash workspot_installer.sh” 

  • Enter DNS IP if you have any -  

  • Choose Domain Join “Yes or No”

 

  • After installing some dependencies, we can see Registration screen 

  • You can choose any method of registration.  

  • Credential Based - 

  • Enter Control account.  

  • Enter Password  

  • If you choose Token Based - 

  • Enter Token ID which we can get from Control > Setup > Configuration tab 

  • You can see registration status in terminal based on registration type. 

  • For Credential based  

  • For Token based 

  • If Domain Join option selected as “Yes”, the below screen prompt to enter domain details 

  • Enter domain name – like indevqa.com 

  • Enter OU details of domain. <<format>> 

  • Enter Domain admin account. 

  • Enter Domain admin account password. 

  • After entering domain details, we can see below lines in terminal 

  • Finally, the installer script will complete execution and ends with the below message “system restart required”. 

  • Restart the VM. 

  • Then stop the template VM from Azure portal. 

  • Go to Control > Setup > Cloud > Azure Cloud and click on Register template. Choose respective resource group and give respective VM name, click on Search button. 

  • Select the Template VM and Click on Save button. 

  • Azure Linux Template should successfully be added to the Workspot Control.