Linux-Desktop-Agent 1.2.1-Installation on GCP-Cloud

Prev Next

Prerequisites: 

  • Make sure template VM is having unmanaged disk. 

  • The same name of the VM cannot be use 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. 

Creation of Linux VM: 

  • Under VM instance page, click on create Instance option. 

  • Enter Instance name with small letters and choose desired region/zone. 

  • Choose Machine configuration based on your requirements. 

  • Choose Image based on your requirements. We support Ubuntu 20.04 LTS, Debian 10 Bluster, CentOS 7.9 and RedHat 7.9. 

  • Choose Networking settings based on your requirements. 

  • After all, select your choice of settings and click on the create button.  

  • Meanwhile Open the PuTTY Gen application and follow the below steps -  

  • Click on the Generate button. 

  • Move the mouse to generate the key fast. 

  • Rename the key comment – to a name that you remember (This key will be used to login to the VM) and Click on the Save private key button.   

  • Make sure we understand that the Key comment is going to be the username needed to log on to the desktop via SSH.  

  • Ignore the warning message ‘are you sure you want to save this key without a passphrase to protect it’ and just save the file to a location, the file save creates a .ppk file.   

  • Copy the whole Pubic key  

  • By now VM instance in GCP might create successfully. Go to that instance. In top we have edit option click on that. 

  • Once VM is in edit mode, Go to SSH keys and click on Show and edit link 

  • We can see empty SSH keys 

  • Paste public key which we copied from PuTTYgen. 

  • The final step is, Save the changes. 

Installation of Linux agent in VM:   

  • RDP windows and install putty software. 

  • Login to Linux VM from Putty 

  • Copy the private key generated before (under Create VM in GCP) to the RDP Windows machine. 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 the terminal. 

  • After login to Linux VM terminal, Change the root password to default password we use for admin using command – “sudo passwd root” and enter new/confirm password. 

  • Below is the confirmation that the password is updated. 

  • 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 - We can add multiple DNS IP addresses by separating with commas. 

  • Choose Domain Join “Yes or No” in this screen 

  • 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, installer script will complete execution and end with the below message “system restart required”. 

  • As this is template VM, Stop the VM directly from GCP portal. 

Image creation 

  • Create an image under the images tab in GCP portal using respective VM instance disk. 

  • Select source disk of VM instance where we installed Linux agent. 

  • Go to instance template and click on Create Instance Template. Give same name as VM instance. Same machine configuration like VM instance 

 

  • Under Boot disk, choose Custom image which we created in above Step 

  • Same network configuration like VM instance 

  • Create Instance Template. 

  • 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. 

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