Configure Orange Cloud Flexible Engine for Cloud Bursting

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

1. Go to the Orange Cloud Customer space login page.
2. Enter your Orange Cloud credentials.
3. Click Your services.

   
   
   Figure 1. Orange Cloud Customer Space Services

4. In the navigation bar on the top click Users
5. Click Add user.
6. Enter the following user details:
   1. For Civility, choose Mrs or Mr
   2. For Last name, enter the user's last name.
   3. For First name, enter the user's first name.
   4. For Login, enter a login name for the user.
   5. For Email, enter the user's email address.
   6. For Phone number, enter the user's phone number.
   7. For Mobile phone, enter the user's mobile phone number.
   8. For Preferred language, choose the language in which the application should be displayed.
   9. Click next.
7. In the Roles section enter these details
   1. For Billing, choose Visitor.
   2. For Contracts, choose Account Manager.
   3. For Dashboard, choose Visitor.
   4. For Documents, choose Visitor.
   5. For Orders, choose Visitor.
   6. For Services, choose Visitor.
   7. For Subscriptions, choose Visitor.
   8. For Support, choose Visitor.
   9. For Users, choose Manager.
   10. For Flexible Engine Console, choose admin.
   11. Click next.
8. In the Summary section review your choices.
   Click previous to edit your choices entries.
9. Click finish.
   The new user account is created and displayed in the list of users. Emails are sent to the email address you specified. The emails will contain:

   1. Orange ID (Domain Name).
   2. Link to set Orange Password.
   3. Link to access Cloud Customer Space.
   4. Link to log in to the Flexible Engine Console.
   5. Link to define your API password.
10. Click the link in the email to set your Orange Password.
11. Click the link in the email to set your API Password.
12. Store the API Password to a file.
    The API Password is used later to create a cloud account in Control.

Define a region in the Orange Cloud Flexible Engine console to set up the infrastructure for cloud bursting.

1. Login to the Orange Cloud Flexible Engine console.
2. In the navigation bar on the top select the region for setting up your infrastructure.

   
   
   Figure 2. Select a Region

   Note: For Auth (IAM) URL (Authorization URL), enter the url in the following format based on the region you chose in the Orange Cloud Flexible Engine console.

   https://iam.<orange region>.<console link> 
   e.g. https://iam.eu-west-0.prod-cloud-ocb.orange-business.com

3. Store the region and Auth (IAM) URL in a file. You will use this to register the account in Control.

Add an existing Orange Cloud Flexible Engine 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., orange_cloudaccount.
   2. For Auth (IAM) URL, enter the url in the following format based on the region you chose in the Orange Cloud Flexible Engine console.

      https://iam.<orange region>.<console link> 
      e.g. https://iam.eu-west-0.prod-cloud-ocb.orange-business.com

   3. For Domain name, enter the Domain Name you used to login to your Orange account. It is the same as your Customer ID.
   4. For User name, enter the username of the user account you created in the Orange Cloud Customer space.
   5. For Password, enter the API password you generated after creating the user.
6. Click Create Account.

View your account resource usage and limits from the console.

1. Login to the Orange Cloud Flexible Engine console.
2. In the navigation bar on the top right hand side, click .

   
   
   Figure 3. Check Quotas for Resources

   Information about resources usage and availability is displayed.

   
   
   Figure 4. Resources Quotas Table

Create a Virtual Private Cloud (VPC) so that you can perform cloud bursting.

1. Login to the Orange Cloud Flexible Engine console.
2. In the top navigation bar select the region where you wish to deploy your cloud infrastructure.
3. Under Network, click Virtual Private Cloud.
4. Click + Create VPC.
5. In the Basic Information section:
   1. For Region, ensure the VPC is the same region as the other resources.
   2. For Name, enter a name for the VPC.
   3. For CIDR Block, enter an address range for the network using CIDR notation.
6. In the Subnet Settings section:
   1. For the Subnet Settings, choose the AZ (Availability Zone) as the same as the region.
   2. For Subnet Name, enter a name for the subnet.
   3. For CIDR, enter an address range for the subnet using CIDR notation.
   4. For Advanced Settings, click Default.
7. Click Create Now.
8. Once the VPC is created, click Back to VPC List.
9. Click Security Group located on the left-hand side of the web page.
10. Click + Create Security Group.
11. For Name, enter a name for the Security Group.
12. For Description, enter a suitable description.
13. Click OK
    Note: By default, the Outbound and Inbound traffic over IPv4 is open. You can add firewall rules to this security group if required.

Create a Elastic Cloud Server (ECS) using a public image provided by Orange Cloud Flexible Engine for cloud bursting.

1. Login to the Orange Cloud Flexible Engine console.
2. Under Computing, click Elastic Cloud Server.
3. Click Key Pair from the menu located on the left-hand side of the web page.
4. Click + Create Key Pair.
5. For Name, enter a name for the key pair.
6. Click OK.
7. Save the key pair (.pem) file to your local disk in a secure location.
   The information in this .pem file is used later to SSH into the VM.
8. Click OK to confirm that you have downloaded the key pair file.
9. Click Elastic Cloud Server from the menu located on the left-hand side of the web page.
10. Click + Create ECS.
11. For Region, click the region you selected for setting up the infrastructure.
12. For AZ (Availability Zone), select the AZ related to the region.
13. In the Specifications section:
    1. For ECS type, click one of the flavor names.
       Note: Orange Cloud Flexible Engine provides a set of predefined ECS types for specific requirements. Click a flavor name to get the list of available configurations.
    2. Review the specifications you have selected.
14. In the Image section:
    1. Click Public image.
    2. From the drop down menu select CentOS.
    3. From the version drop down menu select Select OBS_U_CentOS_7.2(40GB).
15. In the Disk section, select the defaults.
16. In the VPC section:
    1. For VPC, select the VPC you created from the drop down menu.
    2. For NIC, choose the default primary NIC.
    3. For Security Group, select the Security Group you created for the VPC.
    4. For EIP, click Automatically assign.
    5. For Bandwidth, specify it as 5 Mbit/s.
17. For Login Mode, select the Key Pair you generated earlier from the drop down menu.
18. For Auto Recovery, click Enable.
19. For Advanced Settings, click Do not configure.
20. For ECS Name, enter a name.
21. For Quantity, specify 1.
22. Review the Current Configuration.
23. Click Create Now.
24. Review the Specifications.
25. Click Submit.
    The ECS (Virtual Machine) is created and displayed in the list of ECS.

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

1. Login to the Orange Cloud Flexible Engine console.
2. Under Computing, click Elastic Cloud Server.
3. In the search box above the upper right corner of the ECS list, enter the ECS name, IP address, or ID, and click .
4. Click the name of the target ECS.
5. The page providing details about the ECS is displayed.
6. Copy the Public IP address (External IP) of the ECS.
7. Login to your site's PBS Server.
8. SSH into the VM using the default user "cloud", the .pem file you generated when creating the VM and the External IP assigned to the VM.

   ssh -i /path/my-key-pair.pem cloud@IPV4PublicIP

   where /path/my-key-pair.pem is the path to the .pem file downloaded while creating the virtual machine and IPV4PublicIP is the public IP address of the virtual machine.
9. Enter the command:

   sudo -i

10. Copy the PBS Professional installation package to the VM.
11. Using the PBS Professional Installation and Upgrade Guide, install and configure the PBS Professional MOM.
12. Configure the VM for your site's environment such as mounting file systems, connecting it to the authentication service, installing any applications, etc.
13. Install cloud-init.
14. 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 Orange Cloud Flexible Engine console.
2. In the Computing section, click Image Management Service.
3. On the Image Management Service page, click + Create Private Image.
4. In the Image Type and Source section, .
   1. For Type, click System disk image
   2. For Source, click ECS
   3. Select the target ECS from the ECS list.
5. Set the required information, such as Name and Description.
6. Click Create Now.
7. Confirm the parameters and click Submit.
8. Switch back to the Image Management Service page to view the image status.
   The time required for creating an image varies depending on the image file size. Generally, it takes about 20 minutes to create an image. The image is successfully created when its image status changes to Normal.
   Note: Do not perform any operation on the selected ECS or its associated resources during image creation.

Create an Orange Cloud Flexible Engine 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 Orange Cloud Flexible Engine account from the list.
   4. For Region, select the availability domain where the cloud bursting virtual machine is hosted.

      
      
      Figure 5. Virtual Machine Availability Domain

6. Click Next.
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 Service List.

    
    
    Figure 6. Orange Cloud Flexible Engine Console

11. Under Network, click Virtual Private Cloud.
12. Click Virtual Private Cloud from the menu located on the left-hand side of the web page.
13. Click the name of the VPC you created for cloud bursting.
14. Click the name of the VPC's subnet.
15. Copy the Subnet ID.
16. Navigate to the Control browser window.
17. For Subnet ID, paste the subnet's ID copied from the Orange Cloud Flexible Engine console.
18. Navigate to the cloud provider browser window.
19. Click Security Groupfrom the left hand side menu.
20. Click the name of the security group you created for the VPC.
21. Copy the ID of the security group.
22. Navigate to the Control browser window.
23. For Security Group ID, paste the security group's ID you copied from the Orange Cloud Flexible Engine console.
24. Navigate to the cloud provider browser window.
25. Click Service List.

    
    
    Figure 7. Orange Cloud Flexible Engine Console

26. Under Computing, click Image Management Service.
27. Click the Private Images tab.
28. Click the name of the VM image you created for cloud bursting.
29. Copy the Image ID of the image.
30. Navigate to the Control browser window.
31. For OS Image URI, paste the image ID you copied from the Orange Cloud Flexible Engine console.
32. 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.
33. 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.
34. 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.
35. 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.

36. 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 8. Key-Value Tag

37. Repeat the previous step to add more tags.

    
    
    Figure 9. Additional Tags

    Tip: To remove a tag click on the 'x' located within the tag bubble.
38. Click Next.
39. Click the Select instance types for bursting link.
40. 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.
41. Click Save.
42. Click the Create an API Key/ Token link.
43. For Name, enter a name for the token.
44. For Expiration date, use the calendar widget to specify the expiration date.
45. Click Add Token.
    An API key is generated and displayed.
46. 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.
47. Click Close.
48. 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.