Use the following procedures to install DSC SWe on OpenStack. It is recommended that you execute the procedures in the same order as they are presented. Otherwise, the system may not perform as expected.
WorkflowLog In to the OpenStack Dashboard
For the list of supported Web Browsers, see Accessing the Web UI. Make sure that the JavaScript and cookies are enabled.
StartLaunch a supported Web browser.
In the address bar, enter the host name or IP address for the dashboard.
- On the OpenStack dashboard login page, enter your username and password.
Click Connect.
At the top right side of the window, your username appears. At the top left side of the window, the default project name created by OpenStack Appears.
Perform the following procedure to configure VM Identity (create a project).
Start
- Log on to the OpenStack Dashboard as admin user.
- From the OpenStack Dashboard, click Identity.
- Click Projects.
- Click Create Project.
- Enter the required information.
- Name is the appropriate project name (for example, sonusDSCcloud)
- Enabled is the action to activate the project.
- Click Create Project.
The Project screen is displayed showing the project you created.
Manage Users
The following table lists and describes the user roles supported when creating a new user onOpenStackdashboard.
Possible User Access Details
Create a User
Start- Log on to the OpenStack Dashboard as admin user.
- From the OpenStack Dashboard, click Identity.
- Click Users.
- Click Create User.
- Enter the required information.
- User Name is the appropriate name for this user (for example, dscuser).
- Password is the password for this user.
- Use the Primary Project drop-down list to associate this user with a project (for example, SonusDSCcloud).
Role is the user access level [(see Supported Users) (for example, _member_)]. - Enabled is to confirm all parameters for this user.
Click Create User.
The Users screen is displayed showing the user you created.
Change a Password, Disable or Delete One/Multiple Users
Start- Log on to the OpenStack Dashboard as admin user.
- From the OpenStack Dashboard, click Identity.
- Click Users.
- Do one of the following:
- To change a password, disable, or delete one user, click the Edit drop-down list and select the required action.
- To change a password, disable, or delete more than one user, click the checkbox for the users as required and select the required action.
Manage Project Members
Perform the following procedure to manage the members for the project you created.
View Project Members
Start- Log on to the OpenStack Dashboard as admin user.
- From the OpenStack Dashboard, click Identity.
- Click Projects.
- Click the required project name (for example, SonusDSCcloud).
- Click Manage Members.
The dscuser is listed on the screen as a member of this project.
Click the drop-down list and select the role of heat_stack_owner and the role of admin for the dscuser if a shared management IP is required for the DSC VMs.
Add a New Member
Start- Log on to the OpenStack Dashboard as admin user.
- From the OpenStack Dashboard, click Identity.
- Click Projects.
- Click the required project name, for example, SonusDSCcloud.
- Click Manage Members.
- Click the + (plus) sign that is to the right of the username (for example, dscuser2).
- Click the drop-down list and select the required role for this member.
- Click Save.
- Repeat steps 6 and 8 for each user whom you want to add as amembertothisproject.
Delete a Member
Start- Log on to the OpenStack Dashboard as admin user.
- From the OpenStack Dashboard, click Identity.
- Click Projects.
- Click the required project name (for example, SonusDSCcloud).
- Click Manage Members.
- Click the - (minus) sign that is to the right of the username (for example, dscuser2).
- Click Save.
- Repeat steps 6 to 7 for each user whom you want to delete a member from this project.
Upload an Image
Perform the following procedure to upload the DSC SWe/Cloud QCOW2 image to cloud storage (Image Service).
Upload the DSC SWe/Cloud QCOW2 image to Cloud Storage
Start- Log on to the OpenStack Dashboard as admin user or a project user (for example, dscuser).
- From the OpenStack Dashboard, click Project.
- Click Compute.
- Click Images.
- Click Create Image.
- Enter the required information.
- Image Name is the file you want to upload to the Image Service (for example, dsc_swe_<rel>_<nb>)
- File is the name of the QCOW2 file that you downloaded from SalesForce (see Downloading Installation Files).
Format is the QCOW2 file format (QUEMU Emulator).
The term Public means that this image can be shared by projects.
The Images screen is displayed showing the Image you created.
Delete an Image
Start- Log on to the OpenStack Dashboard as admin user or a project user (for example, dscuser).
- From the OpenStack Dashboard, click Project.
- Click Compute.
- Click Images.
- To delete one or more images, click the checkbox beside the image or images that you want to delete.
- Click Delete Images.
The Flavor represents the VM container size QEMU/KVM (Linux). For more information, see Software Requirements.
Create a Flavor
Start- Log on to the OpenStack Dashboard as admin user.
- On the navigation pane, click Admin.
- Click Flavors.
- Click Create Flavor.
- Enter the required information.
- Name is the name for this Flavor (for example, dsc.standard).
- VCPUs, RAM, Root Disk are the resource requirements [(same as DSC SWe (with KVM hypervisor)] software requirements; see Software Requirements.
Click Create Flavor.
The Flavors screen is displayed showing the Flavor you created.
Delete a Flavor
Start- Log on to the OpenStack Dashboard as admin user.
- On the navigation pane, click Admin.
- Click Flavors.
- Click the checkbox beside the Flavors or Flavor that you want to delete.
- Click Delete Flavors.
Create and Launch a Stack
The OpenStack templates allow you to create the required resources for cloud applications such as a project, flavor, users and so on. These resources are referred to as a Stack or system in the context of this document.
For security purposes, an SSH key is required by OpenStack prior to Stack creation.
SSH keys are pushed to the DSC VMs at the creation of such a VM and are applied to the root user on the VMs.
Prepare the SSH Keys
Start- Log onto a Linux machine.
- Generate an SSH key pair (private and public) for the root user by entering the following:
ssh-keygen -t rsa -f cloud.key
Two files are created /root/.ssh: cloud.key and cloud.key.pub.
Import an SSH Key Pair (Example)
Start- Log on to the OpenStack Dashboard as projectuser (for example, dscuser).
- Click Compute.
- Click Access & Security.
- Click Key Pairs.
- Click Import Key Pair.
- Enter the required information.
- Key Pair Name is for this SSH key pair (for example, dsc-cloud-keypair).
- Public Key is for the SSH public key file (for example, cloud.key.pub).
- Click Import Key Pair.
The created SSH key pair appears on the Key Pairs screen. This SSH key pair can be downloaded and stored as required.
If you now SSH to the DSC VM from the Linux machine as root (> ssh root@DSC VM mgmt. IP), you are not prompted for a password.
Create a Stack
Start- Log on to the OpenStack Dashboard as a project user (for example, dscuser).
- From the OpenStack Dashboard, click Project.
- Click Orchestration.
- Click Stacks.
- Click Launch Stack.
Click Browse and select a HOT template for the DSC SWe (for example, dsc_hot_2vm_SHmgt_AVzone_SSHkey_2pkt_0imf).
This example template file is carried in the dsc_swe_<rel>_<nb>_HOT.tgz, which can be downloaded from the Global Support Portal.
No entry is required for the Environment Source drop-down menu.
- Click Next.
Enter the required information.
VM Base Image is the uploaded QCOW2 (for example, dsc_swe_<rel>_<nb>.qcow2).
VM Flavour is the container size (for example, dsc.standard).
Network mgt0/1 Direct is the name of the network that provides the management connections.
Network pkt0 Direct is the name of the network that provides the packet connections.
Network pkt1 Direct is the name of the network that provides the packet connections.
The preceding list and the entered information depends on the YAML file content.
- Click Launch.
The VMs boot and then reboot as the DSC SWe (on OpenStack) software is installed. The time required for this reboot depends on the Host (approximately five minutes).
After you perform the Executing the Initial Configuration Procedure on the DSC SWe (on OpenStack) using the shared Management IP, you can log in to the DSC SWe (on OpenStack) Web UI (see Accessing the DSC SWe (on OpenStack) Web UI).
After Stack creation and deployment, the YAML files automatically create a Security Group with permissive rules that are applied to the VM Ports (see Creating an IP Plan on OpenStack).