In this section:
The following procedures are provided to launch the SBC virtual machine (VM) on the VMware vCenter using the OVA package and Guest OS customization. The Customization Specification and the Day-0 config drive ISO are used to customize the SBC VM.
Prerequisites
- Download the SBC OVA software bundle.
- Download the createConfigDrive-1.0.0.tar.gz tool.
Workflow
Step | Action | System |
---|---|---|
1 | Create the Customization Specification | vSphere Client |
2 | Create the SBC VM Template | vSphere Client |
3 | Create the SBC VM from the Template | vSphere Client |
4 | Create the SBC Config Drive ISO | SBC VM |
5 | Apply the VM Specific Config to the SBC VM | SBC VM |
Create the Customization Specification
This procedure is based on VMware documentation. For more details, see VMware Docs.
Start
- In the vSphere Client, select the Policies and Profiles option from the drop-down Menu.
- Select New to create a new customization specification.
- Create a name for the customization specification and select Linux as the Target guest OS. Click Next.
- Select the option Use the virtual machine name in the Computer Name Window and provide the domain name. Click Next.
- Select the appropriate time zone. Click Next.
- In the Network window, select the Manually select custom settings option, add four NICs for the SBC, and edit the settings. Click Next.
For the first NIC, select the Prompt the user for an IPv4 address when the specification is used option. - Provide the DNS settings if applicable.
- Click Finish in the Ready to Complete window to create the customization specification.
Create the SBC VM Template
Create a virtual template from the OVA package.
Start
- Select the Deploy OVF Template option in vCenter.
- Select the SBC OVA package via the URL or Local File as downloaded in Step 1.
- Enter the virtual machine template name, host information, other details, and then click Finish.
- When the Deploy OVF template task (virtual machine creation) is complete, right-click on the virtual machine, select Edit Settings to edit the guest OS version, and select Ubuntu Linux (64-bit) in the VM Options tab.
- Click the Power On icon to power on the virtual machine.
Log in to the SBC VM and run the/opt/sonus/sbx/scripts/configureSystemForCustomSpec.shscript to configure the SBC system to apply customization specifications as shown below:
NoteThis step is needed with the VMware vSphere 6.7 version as the Customization Script option is only available in the VMware vSphere 7.0 version.
- Power off the virtual machine by clicking the Shut Down Guest OS icon.
- When the virtual machine shuts down, right-click on the the virtual machine and select Template > Convert to Template.
Create the SBC VM from the Template
After creating the template, follow the steps below to create the SBC virtual machine.
Start
- Create a new virtual machine from the template. Right-click on the template name and select New VM from this Template.
- Follow the steps in the template to create a virtual machine.
- Specify the Virtual Machine Name. Click Next.
- Select the host and datastore as applicable. Click Next.
- For Select clone options, click Customize the operating system > Next.
- For the Customize guest OS section, select SBCSpec .
- For User Settings, select Network Adaptor 1 and provide the IP address/netmask/gateway for the management interface of the SBC as shown below:
- Click Finish to create the SBC virtual machine.
- Specify the Virtual Machine Name. Click Next.
- When the virtual machine is created, right-click on the virtual machine name and select Edit Settings to add an additional disk for the virtual machine.
- In the Edit Settings window, select Add New Device > Hard Disk at the top right part of the window.
Edit the New Hard Disk size to change it to 40 GB and click OK to close the window.
Note40 GB is the minimum accepted disk size. Larger disk sizes can be selected based on client storage requirements for logs, CDRs etc.
- Power on the virtual machine by clicking the Power On icon.
- Check Events under the Monitor tab to apply customization specifications correctly.
- When the virtual machine boots up, log in using the linuxadmin user or try to SSH into the VM using the linuxadmin user and management IP address on port 2024. After logging in, change to the root user with the
sudo su-
command.
Create the SBC Config Drive ISO
Start
- Create the config drive ISO for the SBC VM using the tool: createConfigDrive-1.0.0.tar.gz. Refer to the README.md file inside the tarball for packages required to run the tool. The ISO file will be created inside the output directory as config_drive_<lower_case_ce_name>.iso (For example: output/config_drive_sbcvmwithcustomspec.iso).
- The tool can be run in two modes:
--cli
and--file
mode.- The
--cli
option provides screen prompts to enter the configuration data for the deployment. - The
--file
option requires you to provide a file, sbx.json, to the script. The file must contain all the necessary configuration data in JSON format. A sample input file for reference is available in the tarball input/sbx.json.
- The
Apply the VM Specific Config to the SBC VM
Start
- When the ISO file is created in the output directory, copy the ISO file (.iso) to the VM and save the file to this path inside the VM: /mnt/sbxConfigDrive.iso.
- Reboot the VM, and the SBC application will automatically configure with the configuration provided in the ISO file.