Configure Orange Cloud Flexible Engine for Cloud Bursting

Create the necessary components in Orange Cloud Flexible Engine that are required for cloud bursting and then create a cloud bursting scenario.

Purchase an Orange Business Services account and use your Orange ID and password to access the Flexible Engine console. For more information visit Orange Cloud.

Create an Orange Cloud Flexible Engine User Account

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

You must already have signed up for an Orange Cloud account. You should be able to login to the Orange Cloud Customer space (https://selfcare.cloud.orange-business.com/) with the credentials provided to you with your Orange Cloud account. You will also be provided with a Domain name when you sign up for your Orange Cloud account.
An Orange Cloud user account must be created to add an Orange Cloud Flexible Engine account to Control. Once this task is complete, you should have the following information stored in a file:
  • Username and password
  • API password
This information is necessary to 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.

    Orange Cloud Customer Space 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.

Select a Region

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

A region is a geographic area where resources used by your ECSs are located. ECSs in the same region can communicate with each other over an intranet, but ECSs in different regions cannot. Before setting up the infrastructure for cloud bursting, it is important to ensure that all the resources are defined in the same region. An Authorization URL is required for adding the Orange Cloud Flexible Engine cloud account in Control. This is based on the region selected.
  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.

    Select a region from the drop down menu.
    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 Orange Cloud Flexible Engine Account

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

You must have:
  • Created an Orange Cloud Flexible Engine user account.
  • Obtained the Domain name for the Orange Cloud Flexible Engine account.
  • Obtained the API password for the user.
  • Defined the region where you will deploy your cloud infrastructure.
  • Obtained the Auth (IAM) URL based on the selected region.

This information is necessary to create a cloud account in Control. If you do not have this information see Create an Orange Cloud Flexible Engine User Account and Select a Region.

  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.

Check Orange Cloud Flexible Engine Account Service Quota

View your account resource usage and limits from the console.

Quotas are used to limit the number of resources available to users. It is important to ensure you are not exceeding your quota while setting up the resources for cloud bursting. If the existing resource quota cannot meet your service requirements, you can submit a work order to increase your quota. Once your application is approved, your resource quota is updated accordingly and you will be sent a notification.

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

    Check Available and Used Resources.
    Figure 3. Check Quotas for Resources
    Information about resources usage and availability is displayed.

    Resource Quotas Listed.
    Figure 4. Resources Quotas Table

Create a Virtual Private Cloud

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

Orange Cloud Flexible Engine documentation for VPC can be found at:Virtual Private Cloud Documentation
  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.

Creating a Virtual Machine

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

You must have already created a Virtual Private Network with a subnet and assigned a Security Group. If you do not have this information, see Create a Virtual Private Cloud.
  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.

Installing and Configuring the PBS MoM on the VM

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

Log into the VM using the default user "cloud" and the .pem generated during the creation of the VM. For more information about logging into the Linux ECS, refer to the Elastic Cloud Server User Guide.

A startup script is provided during the creation of the bursting scenario. This script is ran after a cloud node is burst and is used to set up the system environment so that nodes burst in the cloud can communicate with the PBS Server. A service specifically designed for cloud instance initialization is cloud-init and is utilized by Control when booting cloud nodes, therefore it must be installed on the VM. For more information about installing cloud-init, refer to the Cloudinit Documentation.

  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 OS Image

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

You must have already created a ECS (VM), installed the PBS MoM on the VM and configured it per your site's environment.
Orange Cloud Flexible Engine documentation can be found at Creating a Linux Private Image Using an ECS. Before creating the Image from the ECS, you must have.
  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.
You can now delete the virtual machine so that you are no longer charged for it.

Create a Orange Cloud Cloud Bursting Scenario

Create an Orange Cloud Flexible Engine bursting scenario so that PBS execution nodes can be burst in the cloud.

Open a browser window and login to the Orange Cloud Flexible Engine console. Open a second browser window and login to Control.

A startup script is provided during the creation of the bursting scenario. This script is ran after a cloud node is burst and is used to set up the system environment so that nodes burst in the cloud can communicate with the PBS Server. Use a cloud-init script for the startup script. For more information about writing cloud-init scripts, refer to the Cloudinit Documentation and Cloud Bursting Startup Script.

  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.

      Virtual Machine Availability Domain
      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.

    Orange Cloud Flexible Engine Console
    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.

    Orange Cloud Flexible Engine Console
    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.

    Key-Value Tag
    Figure 8. Key-Value Tag
  37. Repeat the previous step to add more tags.

    Additional Tags
    Figure 9. Additional Tags
    Tip: To remove a tag click on the 'x' located within the tag bubble.
  38. Click Next.
  39. 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.
    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.

    Tip: Deselect an instance type by disabling the Enabled checkbox.
  40. Click Instantiate scenario.
Once the scenario created, it is recommended to Add a Token and Add Quotas and Alerts. When adding a token, an API key is generated that is required for bursting. Quotas define bursting limits such as the maximum number of cloud nodes to burst.