Configure Oracle Cloud Platform Cloud Bursting

Create an Oracle Cloud user account so that you can later create a cloud account in Control.

1. Login to the Oracle Cloud Infrastructure console.
2. Click located in the upper left-hand corner of the web page.
3. Click Identity & Security > Users.
4. Click Create User.
5. Enter the following to create the user:
   1. For User Type select, Oracle Identity Cloud Services (IDCS - Recommended).
   2. Provide Username, Email, First Name and Last Name.
6. Click Create.
7. Click the profile icon in the top navigation bar and click the username.
   The User Details page is opened.
8. Click the Show link next to the OCID field.
9. Click Copy to copy the OCID.
10. Store the OCID to a file.
    The OCID is used later to create a cloud account in Control.
11. Click Group from the menu located on the left-hand side of the web page.
12. Click Create Group.
13. Enter the following:
    1. For Name, enter Administrators.
    2. For Description, enter a description for the group.
    3. Click Submit.
    The group is created and is displayed in the Groups list.
14. Click on the name of the group.
15. Click Add User to Group.
    1. For User, select the user that was previously created (e.g., pc_clouduser).
    2. Click Add.
16. Click located in the upper left-hand corner of the web page.
17. Click Identity > Policies.
18. Click Create Policy.
    1. For Name, enter a name for the policy.
    2. For Policy Versioning, enable Keep Policy Current.
    3. For Policy Statements, enter: ALLOW GROUP Administrators to manage all-resources IN TENANCY
    4. Click Create.

Use OpenSSL to create a private and public key in a PEM format for the previously created Oracle Cloud user.

1. Login to the Oracle Cloud Infrastructure console.
2. Click the profile icon in the top navigation bar and click the username.
   The User Details page is opened.
3. Click the API Keys link.
4. Click Add API Key.
5. Select Generate API Key Pair.
6. Download the Private Key.
7. Download the Public Key.
8. Click Add.
   A fingerprint is generated.

   
   
   Figure 1. Public Key Fingerprint

9. Copy the fingerprint.
10. Store the fingerprint to a file.
    The fingerprint is used later to create a cloud account in Control.

Obtain the Oracle Cloud identifier of the root compartment so that you can later create a cloud account in Control.

1. Login to the Oracle Cloud Infrastructure console.
2. Click located in the upper left-hand corner of the web page.
3. Click Identity & Security > Compartments.
4. Click Show located under the name of the root compartment.
   The compartment's OCID is displayed.
5. Click Copy to copy the OCID.
6. Store the OCID to a file.
   The OCID is used later to create a cloud account in Control.

Obtain the Oracle Cloud identifier of the tenancy that you can later create a cloud account in Control.

1. Login to the Oracle Cloud Infrastructure console.
2. Click the profile icon in the top navigation bar and click the Tenancy information link.
   The Tenancy Details page is opened.
3. Under Tenancy Information, click Show located to the right of OCID:

   
   
   Figure 2. Tenancy OCID

   The tenancy's OCID is displayed.
4. Click Copy to copy the OCID.
5. Store the OCID to a file.
   The OCID is used later to create a cloud account in Control.

Add an existing Oracle Cloud account to Control so that you can create a cloud bursting scenario or an appliance.

1. Login to Control.
2. Click the Cloud tab.
3. Click Cloud from the Infrastructure menu located on the left-hand side of the web page.
4. Click .
5. Enter the following to add a cloud account:
   1. For Account name, enter any name for the cloud account.
      The name can be anything meaningful to your organization, e.g., oracle_cloudaccount.
   2. For User OCID, enter the user OCID generated when creating the Oracle cloud user.
   3. For Tenant OCID, enter the tenancy OCID .
   4. For Compartment OCID, enter the root compartment OCID.
   5. For Fingerprint, enter the fingerprint generated when adding the public SSH key for the Oracle user.
   6. For Private Key, enter the generated RSA private key.
6. Click Create account.

Create a Virtual Cloud Network (VCN) so that you can perform cloud bursting.

1. Login to the Oracle Cloud Infrastructure console.
2. Click located in the upper left-hand corner of the web page.
3. Click Networking > Virtual Cloud Networks.
4. Choose a region based on the geographical location of your users.

   
   
   Figure 3. Select a Region

5. Click Create VCN.
6. Enter the following to create a VNC:
   1. For CREATE IN COMPARTMENT, select the root compartment.
   2. For NAME, enter a name for the VNC.
      The name can be anything meaningful to your organization, e.g., bursting_vnc.
   3. For IPV4 CIDR BLOCK, specify the CIDR for the VCN. e.g. 10.0.0.0/16
7. Click Create VCN.
   A summary of the VNC, internet gateway, default route table and subnets is displayed.
8. Open the VCN and click the Internet Gateways link.
9. Click Create Internet Gateway.
10. For NAME, provide a name for the Internet Gateway.
11. For CREATE IN COMPARTMENT, choose the compartment allocated to you.
12. Click Create Internet Gateway.
13. Open VCN > Subnet > Default Route Table.
14. Click Add Route Rules.
15. For TARGET TYPE, choose Internet Gateway.
16. For DESTINATION CIDR BLOCK, choose 0.0.0.0/0.
17. Choose the TARGET INTERNET GATEWAY.
18. Click Add Route Rules.
19. Open the VCN, click Security Lists link.
20. Open the default security list and click Add Ingress Rules.
21. For SOURCE TYPE, choose CIDR.
22. For SOURCE CIDR, 0.0.0.0/0.
23. For IP PROTOCOL: All Protocols.
24. Click Add Ingress Rules.
25. Add Egress Rules with same security.

Create a CentOS 7 virtual machine (VM) in Oracle Cloud.

1. Login to the Oracle Cloud Infrastructure console.
2. Click located in the upper left-hand corner of the web page.
3. Click Compute > Instances.
4. Choose the region where the previously created VNC is hosted.

   
   
   Figure 4. Select a Region

5. For COMPARTMENT, select the compartment allocated to you.

   
   
   Figure 5. Choose Compartment

6. Click Create Instance.
7. Enter the following to create a virtual machine:
   1. For NAME, enter a name for the VM.
      The name can be anything meaningful to your organization, e.g., bursting_vm.
   2. For AVAILABILITY DOMAIN, choose one of the region's availability domains.

      The virtual machine is hosted in the chosen availability domain (data center). Choose the availability domain that best suits your site's cloud bursting requirements based on the machine type of the virtual machine (VM shape) and service limits.

   3. For BOOT VOLUME, enable ORACLE-PROVIDED OS IMAGE.
   4. For IMAGE OPERATING SYSTEM, choose CentOS 7.
   5. For SHAPE TYPE, enable VIRTUAL MACHINE.
   6. For SHAPE, select a VM shape.
      Choose the VM shape that best suits your site's cloud bursting requirements based on number of CPUs, memory, disk space, and network bandwidth.
   7. For IMAGE VERSION, select the latest available one.
   8. For BOOT VOLUME CONFIGURATION, enable CUSTOM BOOT VOLUME SIZE and enter a boot volume size in GBs.
   9. Enable PASTE SSH KEYS and copy the SSH public key (i.e., id_rsa.pub) of a user account that exists on your site's PBS Server and paste it.
      This user will have sudo rights and will be able to SSH into the VM to install the PBS MoM.
   10. For VIRTUAL CLOUD NETWORK, choose the VCN that was created for cloud bursting.
   11. For SUBNET, choose the subnet associated with the previously chosen availability domain.
8. Click Create Instance.
   Creating the virtual machine may take some time. It is done when the state is "Running".

   
   
   Figure 6. Running Virtual Machine

Check the service limit for your tenancy before creating the components necessary for cloud bursting.

1. Login to the Oracle Cloud Infrastructure console.
2. Choose the region where the previously created VNC is hosted.

   
   
   Figure 7. Select a Region

3. Click located in the upper left-hand corner of the web page.
4. Click Governance > Service Limits.
5. Scroll down to the Service Limits section.
6. Click Compute.

   Availability domains (data centers) for the region are displayed. For each resource (VM shape) the number of nodes that can be burst in the corresponding availability domains are displayed. In the below example, three nodes can be burst in each data center in the us-phoenix-1 region for the VM Standard1.1 shape.

   
   
   Figure 8. Virtual Machine Type Limits

7. Verify that the appropriate service limits are set for your tenancy based on the VM shape chosen for the virtual machine and the region's availability domains.

Install the PBS MoM on the virtual machine and configure the VM per your site's environment.

1. Login to your site's PBS Server as the user account provided during the creation of the VM.
2. SSH into the virtual machine using the default user "opc", the private SSH key of the user account provided during the creation of the VM and the External IP assigned to the VM.

   ssh -i PRIVATE_KEY_PATH opc@PUBLIC_IP_ADDR

   Where PRIVATE_KEY_PATH is the path to the file that contains the private SSH key of the user account provided during the creation of the VM and PUBLIC_IP_ADDR is the public IP address of the VM.

   
   
   Figure 9. Bursting Virtual Machine

3. Enter the command:

   sudo -i

4. Copy the PBS Professional installation package to the VM.
5. Using the PBS Professional Installation and Upgrade Guide, install and configure the PBS Professional MOM.
6. Configure the VM for your site's environment such as mounting file systems, connecting it to the authentication service, installing any applications, etc.
7. Install cloud-init.
8. Connect the VM to your PBS Professional server and submit a job to ensure it is working as expected.

Create an image of the virtual machine configured per your site's requirements.

1. Login to the Oracle Cloud Infrastructure console.
2. Click located in the upper left-hand corner of the web page.
3. Click Compute > Instances.
   A list of virtual machines is displayed.
4. Click the name of the virtual machine created for cloud bursting.
5. Click Create Custom Image.
6. Enter the following to create a custom image:
   1. For CREATE IN COMPARTMENT, select the root compartment.
   2. For NAME, enter a name for the image.
      The name can be anything meaningful to your organization, e.g., bursting_image.
7. Click Create Custom Image.
   It may take some time to create the image. Do not proceed until the image is created.

Create an Oracle bursting scenario so that PBS execution nodes can be burst in the cloud.

1. Navigate to the Control browser window.
2. Click the Cloud tab.
3. Click Bursting from the Infrastructure menu located on the left-hand side of the web page.
4. Click Add Bursting Scenario.
5. Enter information about the bursting scenario such as name, cloud provider, cloud account, and geographic location.
   1. For Name, enter a name for the cloud bursting scenario.
   2. For Description, enter a description.
   3. For Cloud Account, choose a previously created Oracle cloud account from the list.
   4. For Region, select the availability domain where the cloud bursting virtual machine is hosted.

      
      
      Figure 10. Virtual Machine Availability Domain

6. Click Next.

Enter information about the Oracle resources necessary to burst in the cloud.

7. For Domain name, provide the domain name of your organization for the cloud bursting network.
   altair.com, burst.altair.com
8. For Hostname prefix, enter a prefix for the names of the burst nodes.
   If "node" is entered , the cloud bursting nodes will be available to PBS Professional as node1, node2, node3, etc.
9. Navigate to the cloud provider browser window.
10. Click located in the upper left-hand corner of the web page.
11. Click Networking > Virtual Cloud Networks.
12. Click the name of the VCN create for cloud bursting.
13. Locate the subnet associated with the availability domain where the cloud bursting virtual machine is hosted.

    
    
    Figure 11. Subnet and Associated Availability Domain

14. Click Show located under the name of the subnet.
    The subnet's OCID is displayed.
15. Click Copy to copy the OCID.
16. Navigate to the Control browser window.
17. For Subnet OCID, paste the subnet's OCID copied from Oracle.
18. Navigate to the cloud provider browser window.
19. Click located in the upper left-hand corner of the web page.
20. Click Compute > Custom Images.
    A list of custom images is displayed.
21. Locate the custom image created from the cloud bursting virtual machine.
22. Click the Show link below the name of the image to view the OCID.
23. Click Copy to copy the OCID of the image.
24. Navigate to the Control browser window.
25. For OS Image URI, paste the link copied from Oracle.
26. Enable Add public IP to VMs if you need to connect to the cloud bursting nodes from the internet.
    It is recommended to leave this disabled.
27. For Cloud-init script, click Browse, browse for the startup script file and select it.
    This script will run after a cloud node is burst.
28. Add public SSH keys for any users that you want to have access to the burst nodes:
    1. Login to the PBS Professional Server.
    2. Copy the public SSH key for the user.
       Public key files are usually stored in /.ssh in the user's home directory.
    3. Navigate to the Control browser window.
    4. Click Add to add the public key.
    5. For Public SSH keys, paste the public SSH key.
    6. Repeat steps a through e to add additional public SSH keys.
    The public keys are copied to each burst node for secure connectivity.
29. For Idle time before unbursting, enter the minimum time that a cloud node can be idle before it is unburst.

    It is expressed as an integer whose units are in seconds.

30. For Tags, enter a key-value pair to add a label to the cloud node and press ENTER.
    A tag is a label that is assigned to a cloud node. Tags enable cloud nodes to be categorized in different ways, for example, by purpose, owner, or environment.
    The key-value pair must be entered as key:value. The key must be less than 36 characters and the value must be less than 43 characters. The length of both the key + value should be less than 80 characters. Valid values are alphanumeric, dash (-) and an underscore ( _ ).
    Once the tag is added, it will appear within its own bubble.

    
    
    Figure 12. Key-Value Tag

31. Repeat the previous step to add more tags.

    
    
    Figure 13. Additional Tags

    Tip: To remove a tag click on the 'x' located within the tag bubble.
32. Click Next.
33. Click the Select instance types for bursting link.
34. Select the instance types to enable for the bursting scenario by clicking the Enabled checkbox located to the far right of the instance type name.
35. Click Save.
36. Click the Create an API Key/ Token link.
37. For Name, enter a name for the token.
38. For Expiration date, use the calendar widget to specify the expiration date.
39. Click Add Token.
    An API key is generated and displayed.
40. Copy and save this API key.
    The API key is only displayed once. It is pasted in the configuration file used to configure the cloud bursting hook.
41. Click Close.
42. Enable the bursting scenario by clicking the slider at the top next to the scenario title.
    If an attempt is made to burst nodes with a disabled instance type, the node is not burst and the below message is displayed in the PBS Server logs (if bursting through PBS), the Cloud logs and through the Cloud component user interface.

    TYPE is not enabled

    Where TYPE is the instance type used when attempting to burst the node.