How To Add Custom Operating System Images for Rimo3 Workspace360 Task Runner Provisioning

Rimo3 supports custom OS images to be used for the automated analysis and modernization.

Introduction

There are 4 stages to configuring a custom image for use in Rimo3 Cloud:

1. Create and configure a VM in Azure
2. Sysprep the configured VM
3. Capture the VM as a Managed Image
4. Configure the custom image in Rimo3

Prerequisites

• To use custom images in Rimo3 Workspace360 the Rimo3 Gateway device requires Reader Role on the Azure Managed Image
• Rimo3 Workspace360 does not support Trusted Launch VM Type

Create and configure a VM in Azure

Before you can create a Manage Image in Azure you need to create and configure a VM to represent the build that you want to use for testing.

More Information:

• Quickstart - Create a Windows VM in the Azure portal - Azure Virtual Machines | Microsoft Docs
• Prepare a Windows VHD to upload to Azure - Azure Virtual Machines | Microsoft Docs

Sysprep the configured VM

Once the VM has been configured as required it needs to be Sysprepped to remove all personal information and prepare the VM to be used as an image

To generalize your Windows VM, follow these steps:

1. Sign in to the configured VM.

2. Open an elevated Command Prompt.

3. Delete the C:\Windows\Panther folder

4. Change to the %windir%\system32\sysprep folder and run sysprep.exe.

5. For System Cleanup Action select Enter System Out-of-Box Experience (OOBE) and then select the Generalize check box.

6. For Shutdown Options, select Shutdown.

   

7. Select OK.

8. When Sysprep completes, it will shut the VM down.

9. To optionally optimize your image to improve the first boot experience:

   • Detach the disk from the configured VM
   • Mount it as a data disk to another VM
   • From the other VM run DISM with the /optimize-image parameter, where D: is path to the disk of the configure VM:
   
   
   
   

10. Detach the configured VM’s disk and reattach it to the configured VM

Once Sysprep has finished, set the status of the configured VM to Generalized.

Capture the VM as a Managed Image

1. Find the configured VM in the Azure Portal and select it.

2. On the Virtual machine page select Capture.

3. The Create image page appears, enter a name for the Managed Image or accept the pre-populated name.

4. For Resource group, select the resource group that hosts the Rimo3 customer tenant linking components.

   1. If you do not select the Resource Group where the Rimo3 components are hosted then you will need to explicitly configure access to the VM, in the Access Settings below.

5. To delete the source VM after the managed image has been created, select Automatically delete this virtual machine after creating the image.

6. If you want the ability to use the image in any availability zone, select On for Zone resiliency.

7. Select Create to create the managed image.

Access Settings

If you are using an exiting managed image or you created the managed image in a resource group other than the one hosting the Rimo3 tenant linking components then complete the following step to ensure appropriate access to the managed image.

1. Find the managed image under Images in the Azure Portal
2. Select the managed image and then select Access Control (IAM) from the menu on the left hand side.
3. Under Grant access to this resource select Add role assignment
4. Select Reader on the Role tab and click next
5. On the Members tab select Managed Identity
6. Select + Select Members
7. In the Select managed identities pane ensure that the correct Subscription is selected and under Managed Identity seklect Virtual Machines.
8. In the Select text box search for the Rimo3 Gateway device, this typically starts with r3 and ends in -gw-vm.
9. Select the Gateway VM from the search results and click on on Select
10. Click on Next
11. On the Review + assign tab click on the Review + assign button
    • nter the Resource ID saved in step 2 above.
    • Click on Save
12. The customer image will now be available to select as an Operating System for testing.
13. Ensure that there are no sequences running or queued and restart the Gateway VM for the the changes to take effect.
    
    
    

    Configure the custom image in Rimo3 Workspace360

    In this stage you will select a managed image to be used for creating Task Runners in Rimo3 Cloud.

    1. Once the image has been created find it under Images in the Azure Portal. Select the managed image and then select properties from the menu on the left hand side.
    2. Copy the Resource ID and save it for use in step 5.
    3. Login to your Rimo3 Tenant, you must be at least an Admin for the tenant to complete the following steps.
    4. From the Advanced menu select Custom Images under the Test Environments section
    5. On the Customer Images page, select Add
       1. Give the Image a meaningful name as this is the name that will be displayed when selecting the custom image to use for testing.
       2. Select the OS that the image uses
          
          
          
          
       3. Enter the Resource ID saved in step 2 above.
       4. Click on Save
          
          
    6. The customer image will now be available to select as an Operating System for testing