Oracle Netra Server X5-2 Installation Manual

Oracle Netra Server X5-2 Installation Manual

Communications session border controller. platform preparation and installation
Hide thumbs Also See for Netra Server X5-2:
Table of Contents

Advertisement

Quick Links

Oracle® Communications Session
Border Controller
Platform Preparation and Installation Guide
Release S-Cz8.3.0 - for Service Provider and Enterprise
F20276-07
June 2021

Advertisement

Table of Contents
loading

Summary of Contents for Oracle Netra Server X5-2

  • Page 1 Oracle® Communications Session Border Controller Platform Preparation and Installation Guide Release S-Cz8.3.0 - for Service Provider and Enterprise F20276-07 June 2021...
  • Page 2 Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.
  • Page 3: Table Of Contents

    Introduction to Platform Preparation and Software Deployment Acme Packet Engineered Platforms Virtual Machines Netra and COTS Netra Server X5-2 Platform Preparation Cable the Netra X5-2 for Communications Available Connections Cable the Local Console Connect ILOM to the Netra X5 for Communications...
  • Page 4 Host Hypervisor CPU Affinity (Pinning) Configuration Overview VLAN Support Provisioning Entitlements Virtual Machine Platforms Create and Deploy on Oracle VM Manager Create and Deploy on KVM Create and Deploy on VMware® Create and Deploy on Hyper-V® OpenStack Heat Template 6-11...
  • Page 5 Deploying the Azure Instance 7-33 Create Networking for Additional Interfaces 7-37 Set the User and Administrative Passwords on the OCSBC 7-38 Boot Management Boot Loader Overview Boot Parameters Boot Parameter Definitions Boot Flags Changing Boot Parameters Change Boot Parameters from the ACLI Change Boot Parameters by Interrupting a Boot in Progress Formatting the Disk Volume 40GB or Less Format Plan...
  • Page 6 Upload the Stage 3 Boot Loader and System Image 12-5 Software Upgrade Procedure 12-6 HA Upgrade 12-7 HA Upgrade Procedure 12-7 HA Backout Procedure 12-10 Physical Interfaces on Acme Packet Platforms Acme Packet 1100 Physical Interfaces Acme Packet 3900 Physical Interfaces SNMP Hardware Reporting Acme Packet 3900 MIBS Paths Acme Packet 4600 Physical Interfaces...
  • Page 7: About This Guide

    Whereas platform documentation for physical installation is provided by Oracle and the respective vendors, this guide addresses those details in between physical installation and service configuration. For service configuration, see the applicable Configuration Guide for your product.
  • Page 8: My Oracle Support

    A representative at Customer Access Support (CAS) can assist you with My Oracle Support registration. Call the CAS main number at 1-800-223-1711 (toll-free in the US), or call the Oracle Support hotline for your local country from the list at http://www.oracle.com/us/support/...
  • Page 9 For non-technical issues such as registration or assistance with My Oracle Support, select 2. You are connected to a live agent who can assist you with My Oracle Support registration and opening a support ticket. My Oracle Support is available 24 hours a day, 7 days a week, 365 days a year.
  • Page 10 To download a file to your location, right-click the PDF link, select Save target as (or similar command based on your browser), and save to a local folder. Access to Oracle Support Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/ lookup?ctx=acc&id=info...
  • Page 11: Revision History

    Adds recommendation for using Azure Regional subnets • Updates port numbers in the table in "Acme Packet 4600 Physical Interfaces." November 2019 • Updated with Oracle X8-2 platform for S- cZ8.3.0m1p2 • Updates forwarding cores on OCI Standard2.x shapes. February 2020 •...
  • Page 12: Introduction To Platform Preparation And Software Deployment

    Preparation procedures that apply to all VM platforms include the following steps: Make the VM template available to the VM manager. Configure the VM manager to apply the template correctly for Oracle Communications Session Delivery software. Power-on the VM. If the deployment is using a VM template, the system uses that template to automatically install onto the virtual drive, after which the server reboots.
  • Page 13: Netra And Cots

    Chapter 1 Netra and COTS user navigate the deployment and perform tasks that are specifically related to Oracle Communications Session Delivery software. Netra and COTS You must provision Netra (and COTS) hardware before installing software. This includes platform-specific configuration, such as BIOS, and platform management access.
  • Page 14: Netra Server X5-2 Platform Preparation

    Netra Server X5-2 Platform Preparation Oracle Communications produces a variety of software products that run on the Netra X5-2 for Communications platform, including Oracle session delivery applications. Use your Hardware documentation to install and establish system management by way of ILOM.
  • Page 15: Cable The Netra X5-2 For Communications

    Chapter 2 Cable the Netra X5-2 for Communications To decrease boot up time, Oracle recommends disabling Intel PXE Boot Agent for both onboard and NIC ethernet ports. To disable the Boot Agent for the onboard ethernet ports, navigate to the OpROM option for NET0, NET1, NET2, and NET3 interfaces (for example, IO, Internal Devices) and set it to disabled.
  • Page 16 Chapter 2 Cable the Netra X5-2 for Communications Figure 2-1 Netra X5-2 for Communications Configuration A (4 Onboard 10 GigE Ports) Figure 2-2 Netra X5-2 for Communications Configuration B (4 Onboard 10 GigE Ports & 1 Quad GigE NIC)
  • Page 17: Available Connections

    Netra 5-2 for Communications Configuration C (4 Onboard 10 GigE Ports & 2 Quad GigE NICs) Oracle recommends using Category 6 (or better) for all Ethernet connections. You do not need to use every port for proper operation. You can install and remove Ethernet and 1000BASE-T cables while the Netra X5-2 for Communication runs, but when you disconnect a cable the link is lost and the system generates an alarm.
  • Page 18: Cable The Local Console

    6 meters (19.7 feet) Cable the Local Console You can connect the Administration console to either the Oracle Integrated Lights Out Manager (ILOM) (NET MGT), the local VGA+USB console ports, or the local SER MGT (COM1) serial console port.
  • Page 19 Chapter 2 Cable the Netra X5-2 for Communications • To cable a USB and Video Connection: – DB-15 video cable with a maximum cable length of 6 meters (19.7 feet) – USB cable with a maximum cable length of 6 meters (19.7 feet) –...
  • Page 20: Connect Ilom To The Netra X5 For Communications

    Use the following procedure to make a connection to the Netra X5-2 for Communications Oracle Integrated Lights Out Manager (ILOM) port. For a remote permanent connection to the Service Processor over the ILOM connection, use the rear panel NET MGT port.
  • Page 21 Type packet, and press ENTER. The system prompts you to enter the password that you want for the Admin account. Type the Admin account password, and press ENTER. The system logs you in as Admin. First Steps after Software Installation Oracle recommends the following steps after installation on the Oracle X7-2 platform.
  • Page 22: Known Issues

    Communications onboard interfaces. The command does work with PCI interfaces installed on the platform. The Onboard Ethernet ports of the Oracle X-series servers (X3-2, X5-2, and so on.) run natively at 10GBASE- T, which requires the use of Category 6a cabling. These ports negotiate down to 1000BASE-T or 100BASE-T, but the negotiation might not succeed when you use incompatible cables.
  • Page 23: Oracle Server X7-2 Platform Preparation

    Oracle Communications produces a variety of software products that run on the Oracle Server X7-2 platform, including Oracle session delivery applications. Use your Hardware documentation to install and establish system management via ILOM. Then use the steps below to prepare the Oracle X7-2 for session delivery software installation. Note: ILOM Cable Connection procedure also displays ILOM cabling.
  • Page 24 "ENERY_PERF_BIAS_CFG" mode to "PERF". (Navigation: Advanced / CPU Power Management Configuration, Energy Performance) To decrease boot up time, Oracle recommends disabling Intel PXE Boot Agent for both onboard and NIC ethernet ports. Press F2 and navigate to Advanced, Network Stack Configuration. Then disable IPv4 PXE support.
  • Page 25 Chapter 3 Figure 3-2 Begin RAID Configuration Clear the configuration, regardless of the initial state. Figure 3-3 Clear Any Existing RAID Configuration...
  • Page 26 Chapter 3 Access the menu from which you create a virtual drive. Figure 3-4 RAID - Create Virtual Drive Set the RAID level to RAID-1. Figure 3-5 Set Drive to RAID1...
  • Page 27 Chapter 3 Select your drives. Figure 3-6 RAID - Select Drives It is common to select all drives at this point.
  • Page 28 Chapter 3 Figure 3-7 Select All Drives Save your RAID configuration. Figure 3-8 Save RAID Configuration The system allows you to Confirm your configuration and continue with initialization.
  • Page 29 Chapter 3 Figure 3-9 Initialize RAID Configuration After initialization is complete, return to the Main Menu to Save and Exit. Figure 3-10 Exit RAID Configuration...
  • Page 30: Cable The Oracle X7-2

    Perform a cold shutdown by removing all system power. Cable the Oracle X7-2 After mounting the Oracle X7-2 in an equipment rack and installing all components, use the following instructions to connect all appropriate data cables to the ports before powering the system up and beginning the configuration.
  • Page 31: Available Connections

    (Wancom0) (Wancom2) Caution: Please review your Oracle X7-2 Product Notes. Notes for release 1.1.2 describes physical issues with some optical transceivers installed into an SFP28 port. Oracle recommends using Category 6 (or better) for all Ethernet connections. You do not need to use every port for proper operation.
  • Page 32 Chapter 3 Cable the Oracle X7-2 Port Description You Need: NET (0-2) From left to right: A Category 6 (or better) Ethernet cable to connect to • 1 GigE ports - Net 0 the NET 0 port to your network •...
  • Page 33: Cable The Local Console

    When configuring boot loader parameters, set the Console Device to COM1. Never use COM2 or VGA. The Oracle X7-2 server cannot boot the system when set to the default of VGA. You must change this bootparameter when deploying over this platform.
  • Page 34: Connect Ilom To The Oracle X7-2

    Software Installation - Oracle X7-2 Platforms Connect ILOM to the Oracle X7-2 Use the following procedure to make a connection to the Oracle X7-2 Oracle Integrated Lights Out Manager (ILOM) port. For a remote permanent connection to the Service Processor over the ILOM connection, use the rear panel NET MGT port.
  • Page 35 Remove the USB media when prompted by the Oracle X7-2. Allow the Oracle X7-2 complete its installation process and boot to the newly installed OCSR software. Log On to the System The OCSR requires you to set passwords for the Admin and User accounts the first time you power up a new or factory reset system by way of local access.
  • Page 36: Known Issues

    Communications onboard interfaces. The command does work with PCI interfaces installed on the platform. The Onboard Ethernet ports of the Oracle X-series servers (X3-2, X5-2, X7-2 and so on.) run natively at 1GBASE- T or 10GBASE- T, which requires the use of Category 6a cabling.
  • Page 37: Oracle Server X8-2 Platform Preparation

    Server X8-2 platform, including Oracle session delivery applications. Use your Hardware documentation to install and establish system management by way of Oracle Integrated Lights Out Manager (ILOM). Then use the steps below to prepare the Oracle X8-2 for session delivery software installation.
  • Page 38 "ENERY_PERF_BIAS_CFG" mode to "PERF". (Navigation: Advanced / CPU Power Management Configuration, Energy Performance) To decrease boot up time, Oracle recommends disabling Intel PXE Boot Agent for both onboard and NIC ethernet ports. Press F2 and navigate to Advanced, Network Stack Configuration. Then disable IPv4 PXE support.
  • Page 39 Chapter 4 Figure 4-2 Begin RAID Configuration Clear the configuration, regardless of the initial state. Figure 4-3 Clear Any Existing RAID Configuration...
  • Page 40 Chapter 4 Access the menu from which you create a virtual drive. Figure 4-4 RAID - Create Virtual Drive Set the RAID level to RAID-1. Figure 4-5 Set Drive to RAID1...
  • Page 41 Chapter 4 Select your drives. Figure 4-6 RAID - Select Drives It is common to select all drives at this point.
  • Page 42 Chapter 4 Figure 4-7 Select All Drives Save the RAID configuration. Figure 4-8 Save RAID Configuration The system allows you to Confirm your configuration and continue with initialization.
  • Page 43 Chapter 4 Figure 4-9 Initialize RAID Configuration After the initialization completes, return to the Main Menu to Save and Exit. Figure 4-10 Exit RAID Configuration...
  • Page 44: Available Connections

    The NET MGT port provides (required from DHCP or a support connections to the SP static address) using the Oracle Integrated Lights Out Manager (ILOM) CLI and Web interface. By default, the NET MGT port is configured to use DHCP to automatically obtain an IP address.
  • Page 45: Cable The Oracle X8-2

    Cable the Oracle X8-2 After mounting the Oracle X8-2 in an equipment rack and installing all components, use the following instructions to connect all appropriate data cables to the ports before powering the system up and beginning the configuration.
  • Page 46 SFP+ port, network connectivity is disabled on the 10GBASE-T RJ-45 GbE (NET 1) Ethernet port. Figure 4-11 Oracle X8-2 Configuration A (4x10 GigE NIC) Figure 4-12 Oracle X8-2 Configuration B (Two 4x10 GigE NICs) Figure 4-13 Oracle X8-2 Configuration B (One QSFP and One 4x10 GigE NICs) 4-10...
  • Page 47: Cable The Local Console

    When configuring boot loader parameters, set the Console Device to COM1. Never use COM2 or VGA. The Oracle X8-2 server cannot boot the system when set to the default of VGA. You must change this bootparameter when deploying over this platform.
  • Page 48: Connect Ilom To The Oracle X8-2

    Plug in the cables to their respective destination components. Connect ILOM to the Oracle X8-2 Use the following procedure to make a connection to the Oracle X8-2 Oracle Integrated Lights Out Manager (ILOM) port. For a remote permanent connection to the Service Processor over the ILOM connection, use the rear panel NET MGT port.
  • Page 49: Next Steps After The Software Installation

    Remove the USB media when prompted by the Oracle X8-2. Allow the Oracle X8-2 complete the installation process and boot to the newly installed OCSR software. Next Steps After the Software Installation Oracle recommends the following steps after installation on the Oracle X8-2 platform on the OCSR.
  • Page 50: Session Delivery Products As Virtual Machines

    Session Delivery Products as Virtual Machines You can deploy version S-Cz8.3.0 of Oracle's Session Delivery Products as Virtual Machine (VM). This document refers to Session Delivery Products generically. See your software version's Release Notes to verify your product's support for deployment as a virtual machine.
  • Page 51: Host Hypervisor Cpu Affinity (Pinning)

    Chapter 5 Host Hypervisor CPU Affinity (Pinning) • The OCSBC displays sibling CPUs in lower-case letters: – A signaling core with signaling sibling appears as "Ss". – There can be no combination of SBC core types, such as "Fd" (Forwarding with DoS).
  • Page 52: Configuration Overview

    The user can learn how to pin CPUs via their hypervisor documentation. Configuration Overview Oracle Communications Session Border Controller Virtual Machine (VM) deployments require configuration of the VM environment and, separately, configuration of the OCSBC itself. VM- specific configuration on the OCSBC includes boot parameter configuration, enabling functionality and performance tuning.
  • Page 53: Vlan Support

    OCSBC. Note that when you configure a VLAN, the OCSBC requires VLAN tags to be included in the packets delivered to and from the VM. Oracle recommends that you evaluate the VLAN support of your deployment's hypervisor and interface I/O mode before implementation to ensure secure support for the transmission and receiving of VLAN-tagged traffic.
  • Page 54: Virtual Machine Platforms

    VM resource and management setup, is complete. For information on Oracle OVM, including server and manager documentation, refer to the following links. The bottom link opens the page specifically to Oracle OVM version 3.4.2. http://www.oracle.com/technetwork/documentation/vm-096300.html http://docs.oracle.com/cd/E64076_01/ Once hardware, VM resources and VM management are in place, the user prepares the VM management environment.
  • Page 55 • Start your virtual machine Use the Oracle VM Manager to deploy your VMs. Browsing the manager displays the management application, with tabs across the top for VM Manager configuration and display, and two panes providing access to controls and components for specific VM management.
  • Page 56: Create And Deploy On Kvm

    The system applies your settings to your VM. Click the Console icon from the menu bar. Oracle VM Manager displays a terminal screen with the serial CLI operational. Highlight the target and click the Start button. Oracle VM Manager starts your VM, displaying the startup sequence and, ultimately, providing ACLI access in the console.
  • Page 57 Chapter 6 Create and Deploy on KVM Provision a new virtual machine. # virt-install \ --name SBC739 \ --description "nnSCZ739 KVM" \ --os-type=Linux \ --os-variant=rhel7 \ --ram=8192 \ --vcpus=4 \ --disk path=/opt/nnSCZ739.64-img- vm_kvm.qcow2,bus=virtio,size=10,format=qcow2 \ --network bridge=br-Mgmt \ --network bridge=br-Mgmt \ --network bridge=br-Mgmt \ --network bridge=br-Mgmt \ --network network=media1 \...
  • Page 58: Create And Deploy On Vmware

    Create and Deploy on VMware® This section provides detail on deploying Oracle Communications Session Delivery products over the ESXI hypervisor and assumes VMware 6. The section also assumes the user understands deployment in these environments and that the majority of deployment tasks, from hardware installation and startup to VM resource and management setup, is complete.
  • Page 59 Chapter 6 Create and Deploy on VMware® On the Disk Format screen, select Thick Provisioned Lazy Zeroed, and click Next. On the Network Mapping screen, map the networks used in this template to networks in your inventory, and click Next. The OCSBC enumerates and binds network interfaces in the order presented by the hypervisor to the virtual machine.
  • Page 60: Create And Deploy On Hyper-V

    • Confirm your .vhd (Virtual Hard Drive) file is available to Hyper-V in a permanent location. Keeping this Oracle distribution on the same physical server as the Hyper-V manager ensures the best access to it during OCSBC operation. The following procedure describes an example that provides basic deployment guidelines.
  • Page 61 Chapter 6 Create and Deploy on Hyper-V® wizard. In addition, the Hyper-V Manager provides access to its controls and wizards from multiple entry points. Instances of Hyper-V Manager may display the Actions dialog in the upper-right pane of the manager's main window, but you may find your Actions controls elsewhere in your manager.
  • Page 62 Chapter 6 Create and Deploy on Hyper-V® wancom0 wancom1 wancom2 spare s0p0 s1p0 s0p1 s1p1 Click New, Virtual Machine Hyper-V displays the introductory page of the New Virtual Machine Wizard. Click Next. Hyper-V advances through the New Virtual Machine Wizard pages each time you click Next.
  • Page 63 Chapter 6 Create and Deploy on Hyper-V® Select the first adapter after wancom0 that you configured for your Virtual Machine from the drop-down listbox and click the Apply, then the OK buttons. Repeat the previous step for the rest of your adapters, referring to the order described above.
  • Page 64: Openstack Heat Template

    HA pairs. Extract the Environment File After downloading the compressed TAR file from Oracle, extract the contents on the machine from which you will deploy virtual machines. Extract the compressed HOT file bundled with your software package.
  • Page 65 Chapter 6 OpenStack Heat Template Entitlement files are passed to the openstack command when deploying a virtual machine. For complete instructions on deploying a Heat template, see the README. Set Parameters in Environment File The following parameters can be configured in the environment file. Note that some parameters are only available in the HA environment file and not in the standalone environment file.
  • Page 66 Chapter 6 OpenStack Heat Template – snmpCommunityName—Specify the name of the SNMPv2 community to use for SNMP management. – snmpIpAddress—Specify the IP address to add to the SNMPv2 community for SNMP management. • wancom0VLAN—(Only available on Pike and newer) Specify the bootparameter VLAN value for the wancom0 interface.
  • Page 67: Public Cloud Platforms

    Oracle distributes machine templates, each containing a virtual disk image and default configuration for the supported profile of each public platform. Public Cloud platform support is dependent on your Oracle product version. Refer to your Oracle Communications Session Border Controller (OCSBC) Release Notes to confirm the public clouds supported and important detail on that software version's support.
  • Page 68: Deploying The Ocsbc On Cloud Infrastructures In Ha Mode

    Deploying the OCSBC on Cloud Infrastructures in HA Mode The Oracle Communications Session Border Controller (OCSBC) supports High Availability (HA) deployments on public clouds using the redundancy mechanisms native to those clouds. You configure the cloud to recognize the OCSBC. The REST...
  • Page 69 Chapter 7 Deploying the OCSBC on Cloud Infrastructures in HA Mode VIPs every 300 seconds until it succeeds. Upon success, the OCSBC suspends these re- requests and begins to send address verification requests every 300 seconds. These requests verify that the SDN continues to associate this OCSBC with these VIPs. When moving from Active to any other state, the OCSBC gracefully abandons any outstanding REST client operations.
  • Page 70 Chapter 7 Deploying the OCSBC on Cloud Infrastructures in HA Mode Public Subnets Private Subnets Wancom0 s0p0 10.100.1.0 10.100.2.0 UAC1 Wancom1 10.100.4.0 Router Wancom2 10.100.5.0 Primary OCSBC External Endpoints Secondary OCSBC s1p0 10.100.3.0 Translation VIP (Sec. Priv IP) Reserved Public IP 10.200.2.107 18.215.103.73 The minimum number of subnets is four:...
  • Page 71: Cloud-Based Ha Report Data

    • A management subnet is typically a public subnet. Each instance that requires management access from outside the cloud needs a public IP assigned. Oracle recommends you use a Reserved Public IP instead of Ephemeral Public IP. HA subnets are private subnets.
  • Page 72: Cloud-Specific Ha Deployment Considerations

    • Create both OCSBC instances in the same Availability Domain • Oracle recommends that you create OCSBC instances in separate Fault Domains. As you configure, follow these guidelines: • Do not configure and use more that 4 secondary private IP addresses per HA deployment.
  • Page 73: Create And Deploy Ocsbc Instances On Ec2

    API. As you deploy, follow these guidelines: Create both OCSBC instances in the same Availability Zone. Oracle recommends that you use Place Groups of type Spread for launching both OCSBC instances. As you configure, follow these guidelines: On the primary instance of OCSBC, and through the AWS console, configure Secondary Private IPs to be used as OCSBC virtual IPs.
  • Page 74: Generate An Ec2 Ami From The Vsbc Image

    Generate an EC2 AMI from the vSBC Image You perform this procedure to convert the Oracle Communications Session Border Controller (OCSBC) image provided by Oracle into an AMI, from which you can create vSBC machines. This procedure requires that you, from the EC2 system, create a Linux machine, attach a new disk to it, and put the OCSBC image on your machine.
  • Page 75 Chapter 7 Create and Deploy OCSBC Instances on EC2 Install the KVM image conversion utility. sudo yum install qemu-img Convert the image to raw format. qemu-img convert -p nnSCZ830-img-vm_kvm.qcow2 nnSCZ830-img-vm_kvm.raw When you attach the disk to the VM, choose the disk symbol, for example sdf. You can check this by navigating to Image/Volumes/Attachment information.
  • Page 76: Ec2 Deployment Procedure

    Check your interface assignments using the OCSBC ACLI interface- mapping commands, shown below, after OCSBC startup and correct interface assignment, if necessary. See the Oracle® Communications Session Border Controller Platform Preparation and Installation Guide for further instructions on using these commands.
  • Page 77 Chapter 7 Create and Deploy OCSBC Instances on EC2 Configure an IAM Role Create an IAM role for use by HA OCSBC instances deployed for high availability. (This is not required for standalone OCSBCs.) Attach the policy AmazonVPCFullAccess to this IAM role.
  • Page 78 Chapter 7 Create and Deploy OCSBC Instances on EC2 Navigate to the My AMIs link to choose the image for your instance, and click Select. Chose the desired instance type. See your software version's release notes for tables of supported machine sizing. Click Next: Configure Instance Details.
  • Page 79 Chapter 7 Create and Deploy OCSBC Instances on EC2 After launching the instance, SSH to the VM with the -i argument. ssh -i .ssh/my_new_keypair.pem admin@<Public IP address> Click Launch Instances. EC2 creates your instances. Return to the EC2 Dashboard and click the Running Instances link. Select your new instances and name them.
  • Page 80 Chapter 7 Create and Deploy OCSBC Instances on EC2 Configure Secondary Private IPs (Virtual IPs) for all HA Deployments This procedure, which creates virtual addressing, applies only to HA deployments. Perform these steps on the Primary instance of the HA pair only. From the EC2 Dashboard, click Running Instances.
  • Page 81 Chapter 7 Create and Deploy OCSBC Instances on EC2 ** Only alphabetic (upper or lower case), numeric and punctuation ** characters are allowed in the password. ** Password must be 8 - 64 characters, ** and have 3 of the 4 following character classes : ** - lower case alpha ** - upper case alpha ** - numerals...
  • Page 82: Deploy Aws Ami With Terraform

    MAC address mapping. Reboot the virtual machine. # reboot Refer to the Oracle® Communications Session Border Controller Configuration Guide after you have completed this deployment for administrative and service configuration, including product setup, entitlement setup and HA configuration.
  • Page 83 Chapter 7 Create and Deploy OCSBC Instances on EC2 "s3:GetObjectAcl", "s3:GetEncryptionConfiguration", "dynamodb:TagResource", "dynamodb:DescribeTable", "s3:GetBucketRequestPayment", "dynamodb:GetItem", "dynamodb:DescribeContinuousBackups", "s3:DeleteBucket", "s3:PutBucketVersioning", "dynamodb:ConditionCheckItem", "dynamodb:UntagResource", "s3:GetBucketWebsite", "dynamodb:Scan", "dynamodb:Query", "s3:GetBucketVersioning", "dynamodb:DescribeTimeToLive", "s3:GetBucketAcl", "s3:GetReplicationConfiguration", "dynamodb:CreateTable", "s3:GetObject", "s3:GetBucketCORS", "dynamodb:DescribeBackup", "s3:GetBucketLocation", "s3:GetObjectVersion", "dynamodb:GetRecords" "Resource": [ "arn:aws:dynamodb:MY-REGION:ACCOUNT-ID:table/MY- DYNAMODB-TABLE", "arn:aws:dynamodb:MY-REGION:ACCOUNT-ID:table/MY- DYNAMODB-TABLE/backup/*", "arn:aws:dynamodb:MY-REGION:ACCOUNT-ID:table/MY- DYNAMODB-TABLE/index/*", "arn:aws:dynamodb:MY-REGION:ACCOUNT-ID:table/MY-...
  • Page 84 Chapter 7 Create and Deploy OCSBC Instances on EC2 Paste the following JSON into the JSON editor. "Version": "2012-10-17", "Statement": [ "Sid": "VisualEditor0", "Effect": "Deny", "Action": [ "ec2:TerminateInstances", "ec2:RunInstances" "Resource": "arn:aws:ec2:MY-REGION:ACCOUNT- ID:instance/*", "Condition": { "StringNotEquals": { "ec2:InstanceType": "t2.micro" "Sid": "VisualEditor1", "Effect": "Allow", "Action": [ "ec2:DeregisterImage",...
  • Page 85 Chapter 7 Create and Deploy OCSBC Instances on EC2 "Resource": [ "arn:aws:ec2:*:ACCOUNT-ID:network-interface/*", "arn:aws:ec2:*:ACCOUNT-ID:security-group/*", "arn:aws:ec2:MY-REGION::snapshot/*", "arn:aws:ec2:*:ACCOUNT-ID:subnet/*", "arn:aws:ec2:MY-REGION:ACCOUNT-ID:volume/*", "arn:aws:ec2:*:ACCOUNT-ID:instance/*", "arn:aws:ec2:MY-REGION:ACCOUNT-ID:key-pair/*", "arn:aws:ec2:*::image/*" "Sid": "VisualEditor3", "Effect": "Allow", "Action": [ "ec2:TerminateInstances", "ec2:RunInstances" "Resource": [ "arn:aws:ec2:MY-REGION:ACCOUNT-ID:subnet/*", "arn:aws:ec2:MY-REGION::image/ami-*", "arn:aws:ec2:MY-REGION:ACCOUNT-ID:instance/*", "arn:aws:ec2:MY-REGION:ACCOUNT-ID:volume/*", "arn:aws:ec2:MY-REGION:ACCOUNT-ID:network- interface/*", "arn:aws:ec2:MY-REGION:ACCOUNT-ID:key-pair/*", "arn:aws:ec2:MY-REGION:ACCOUNT-ID:security-group/*" "Sid": "VisualEditor4", "Effect": "Allow", "Action": [ "s3:PutObject", "s3:GetObject",...
  • Page 86 -t rsa -b 4096 -f aws-acme-key chmod 400 aws-acme-key Download the OCSBC image from the Oracle Software Delivery Cloud. The zip file contains both the terraform stack builder and the qcow2 image. Copy the terraform stack builder file and the qcow2 image to your EC2 instance.
  • Page 87 Chapter 7 Create and Deploy OCSBC Instances on EC2 Navigate to the awk/AMI/s3 directory. cd aws/AMI/s3 Initialize terraform. terraform init Get terraform packages and validate the templates. terraform get terraform validate Plan and apply to create an S3 bucket DynamoDB table. terraform plan terraform apply -auto-approve Note:...
  • Page 88: Create And Deploy On Oci

    Create and Deploy on OCI You can deploy the Oracle Communications Session Border Controller (OCSBC) on Oracle Cloud Infrastructure (OCI) in either standalone or High Availability (HA) mode. When deployed on this platform, you configure and operate the OCSBC as you would on any other platform.
  • Page 89 • RTP —UDP or TCP port 5004 and 5005 Oracle recommends using a private subnet for HA and a basic security list that allows all local traffic. However, there are some deployments where this is not possible. In these cases, create a security list with a port open for the port you've selected in redundancy-config, which is typically port 9090.
  • Page 90: Create Dynamic Group And Policy Statements

    IP standalone Oracle recommends creating regional subnets, which means the subnet can span across availability domains within the region. With this primary and secondary OCSBC instances can be deployed in two different Availability Domains thereby making use of OCI infrastructure level high availability.
  • Page 91 Create Dynamic Group To create a Dynamic Group: From the Oracle Cloud VCN Compartment dialog, click the Hamburger menu icon to display its drop-down menu and click Identity, Dynamic Groups. Name—Enter a name for your dynamic group. This name can be anything. You use this name when configuring policy statements.
  • Page 92: Deploying The Oci Instance

    The OCI workspace may present dialogs and fields that differ from this procedure. For full information on deploying OCI instances, see the Oracle OCI documentation. Upload Image The OCSBC is not available as a pre-packaged image on OCI. You must upload the OCSBC disk file to a Bucket and create a Custom Image that you can then use when creating an OCSBC instance.
  • Page 93 Native OCI image. This process may take 5-10 minutes, after which the Custom Image is available to deploy as an OCSBC instance. From the Oracle Cloud Hamburger menu select Compute, Custom Images. From the Import Image dialog, select the correct compartment from the CREATE IN COMPARTMENT drop-down.
  • Page 94 Chapter 7 Create and Deploy on OCI The subnet you select for this vNIC should be the one you created for management traffic. Select the ASSIGN A PUBLIC IP ADDRESS option. Boot Volume If a larger boot volume is desired, select Specify A Custom Boot Volume Size and enter the number in gigabytes.
  • Page 95 Chapter 7 Create and Deploy on OCI • HA uplink (wancom 1) • At least 2 Media Interfaces Navigate to Compute, and then Instances and open your instance. Click the Stop button to stop your instance. The infrastructure cannot add interfaces to an instance when it is running.
  • Page 96 Chapter 7 Create and Deploy on OCI > Set the administrative password by typing enable at the command prompt. The initial enable password is "packet" + the OCID. > enable Password: *ALERT* ***************************************************************** admin password has not been set. Please set password now. ***************************************************************** ** Only alphabetic (upper or lower case), numeric and punctuation ** characters are allowed in the password.
  • Page 97: Create And Deploy On Azure

    HA configuration. Create and Deploy on Azure You can deploy the Oracle Communications Session Border Controller (OCSBC) on Azure public clouds. Azure provides multiple ways of managing your environment(s), including via its web portal, using its powershell and its CLI interfaces. This document focuses on the portal.
  • Page 98 (subnet) during instance deployment. Deploying the OCSBC VHD File You acquire the OCSBC VHD file via your Oracle Support account. You deploy the OCSBC using the VHD supplied by Oracle, based on the OCSBC version. Create a Blob Container under your Storage Accounts .
  • Page 99: Deploying The Azure Instance

    Chapter 7 Create and Deploy on Azure Create Virtual Networks Virtual networks define the Azure cloud address space within which your interfaces reside. Virtual Subnets divide the virtual networks into segregated subsets in the same way as subnets that are not virtual. You can assign the actual interface address manually or use Azure's DHCP to acquire it.
  • Page 100 Chapter 7 Create and Deploy on Azure Basics Disks Networking Managment Guest Config Tags Review and Create Your Azure workspace may present dialogs and fields that differ from this procedure. For full information on deploying Azure instances, see the Azure documentation. Basics Azure instance deployment Basics configuration includes: •...
  • Page 101 Chapter 7 Create and Deploy on Azure 7-35...
  • Page 102 Azure instance deployment Disk configuration includes setting the OS disk type to Standard HDD. Despite the initial boot disk size provided by Oracle, you are free to create a boot disk that is a different size, as supported by Azure. Specifically, consider whether you need a disk that is larger than the initial size to allow for storing log files and other data.
  • Page 103: Create Networking For Additional Interfaces

    Chapter 7 Create and Deploy on Azure Review and Create Use the Review and Create to review your settings, then click the Create button to complete instance creation. Create Networking for Additional Interfaces OCSBC instance includes establishing networking to the primary management interface, wancom0.
  • Page 104: Set The User And Administrative Passwords On The Ocsbc

    Chapter 7 Create and Deploy on Azure Set the User and Administrative Passwords on the OCSBC This procedure turns to the OCSBC and performs the password procedures, which are required before any further OCSBC operations. For HA deployments, perform these procedures on both OCSBCs.
  • Page 105 MAC address mappings. Reboot the virtual machine. # reboot Refer to the Oracle® Communications Session Border Controller Configuration Guide after you have completed this deployment for administrative and service configuration, including product setup, entitlement setup and HA configuration.
  • Page 106: Boot Management

    Every new software release includes a system software image and a Stage3 boot loader. Oracle recommends you update this boot loader with every software upgrade, as described in the Software Upgrade section. Be sure to perform this update before booting the new system image.
  • Page 107: Boot Parameters

    Chapter 8 Boot Parameters Stage 3 boot loader upgrade procedure can be found in the Update the Stage 3 Bootloader section of this guide. Note: The OCSBC does not support uploading the boot loader by way of the Web GUI. Boot Parameters Boot parameters specify the information that your device uses at boot time when it prepares to run applications.
  • Page 108: Boot Parameter Definitions

    0x (these flags are hexadecimal). Target Name Name of the Oracle Communications Session Border Controller as it appears in the system prompt. For example, ORACLE> or ORACLE#. You need to know the target name if you are setting up an HA node.
  • Page 109: Boot Flags

    0x00000080 Use TFTP protocol (instead of FTP) enable - VM platforms only • 0x00000100 Bootloader ~1 seconds quick countdown - VM platforms only The following boot flags should only be used as directed by Oracle support: • 0x00000001 acme.ko network module security override •...
  • Page 110: Change Boot Parameters From The Acli

    Change Boot Parameters from the ACLI To access and change boot parameters from the ACLI: In Superuser mode, type configure terminal, and press Enter. ORACLE# configure terminal Type bootparam, and press Enter. The boot device parameters display. ORACLE(configure)# bootparam '.' = clear field;...
  • Page 111: Change Boot Parameters By Interrupting A Boot In Progress

    Chapter 8 Changing Boot Parameters If you configured boot parameters correctly, the system prompt displays and you can go ahead with configuration, management, or monitoring tasks. Note: If you configured the boot parameters incorrectly, the system goes into a booting loop and displays an error message. Press the space bar to stop the loop.
  • Page 112 Chapter 8 Changing Boot Parameters Note: If you have configured the boot parameters incorrectly, the system goes into a booting loop and displays an error message. Press the space bar to stop the loop. Correct the error, and reboot your system.
  • Page 113: Formatting The Disk Volume

    Formatting the Disk Volume After the system has booted the Oracle Communications product for the first time, the hard disk must be formatted from the application. Remember that, at the chassis level, the disk system must be presented as a single logical drive.
  • Page 114: Formatting Procedure

    In addition, ensure that your device is not passing traffic while you format any partition. The following example shows the format command process. ORACLE# format hard-disk WARNING: Please ensure device is not currently in use by any applications before proceeding...
  • Page 115 Chapter 9 Formatting Procedure the format process is complete. Continue [y/n]?: y Suspending logging to hard disk Stopping tLogCleaner task Relocating logging onto RAM drive Initializing /opt/ Cleaner Starting tLogCleaner task *** Removing previous system partitions - please wait *** *** Creating new system partitions - please wait *** *** Formatting partition /opt.
  • Page 116 Chapter 9 Formatting Procedure Create the data partitions and filesystems as configured above [y/n]?: y ****************************************************** WARNING: All non-system data on the disk will be permanently erased and unrecoverable. Are you sure [y/n]?: y The format process will take a few minutes. Once the format process begins, it cannot be stopped.
  • Page 117 Chapter 9 Formatting Procedure Power cycle the system after format is complete. You can re-enable any tasks that may have conflicted with the format, including local CDR and HDR generation, after the power cycle is complete. Note: If you find that, after the first reboot, the system has not created new partitions, perform another reboot to resolve this issue, which is created by an incorrect dynamic partition table refresh.
  • Page 118: Interface Considerations For Vm Platforms

    Guide. Media Interface Consideration The template Oracle provides for VM deployment selects the correct interface detail for both management and media interfaces during deployment. If you are using a manual deployment approach or you wish to change interface selection after deployment, Use either Paravirtual, PCI-pt or SR-IOV I/O mode for media interfaces.
  • Page 119: Cots Network Interfaces

    2 service ports for the common 4 on-board NIC configuration. The presence of additional NIC cards maps an additional management interface to the on- board NICs, leaving only a single service interface on the on-board NIC. The Oracle Communications Session Border Controller provides a means of testing and changing physical interface assignment.
  • Page 120: Working With The Interface-Mapping Branch

    Working with the interface-mapping branch Interface identification on the Oracle Communications Session Border Controller is based on a system-level file called MACTAB that maps interface MAC addresses to interface naming that can be applied within Oracle Communications Session Border Controller configuration.
  • Page 121: Serial Interfaces

    In lieu of IP management access, serial access provides the user with direct access to the Oracle Communications Session Border Controller ACLI. The user must identify how their system allows for serial access. The serial interface can be a critical...
  • Page 122 VM interface configuration as the user can make MACTAB changes via the serial interface without interrupting their own access during that management procedure. Access to the Oracle Communications Session Border Controller serial interface is dependent on platform. Familiarity with the platform is required to understand serial configuration.
  • Page 123: Flash Drive Installation Via Boot Media Creator

    Flash Drive Installation via Boot Media Creator The Boot Media Creator (BMC), is provided within Oracle Session Delivery software distributions. BMC is an application that allows the user to create a USB drive from which they can install software. Users identify the distribution that includes BMC by filename. These filenames start with the software version, appended with the text -img-usb.exe.
  • Page 124 Chapter 11 Creating a Build Image Figure 11-1 BMC - Step 3 Click Next. Select the embedded image. Figure 11-2 BMC - Step 4 Click Next. BMC detects and displays your USB stick. You can insert and reinsert your stick, if needed. 11-2...
  • Page 125 Chapter 11 Creating a Build Image Figure 11-3 BMC - Step 5 Highlight your stick and click Next. BMC displays a dialog allowing multiple options. Figure 11-4 BMC - Step 6 Note that the Include Preload tarfile and Generate installation logs options are typically used in a manufacturing or staging environment.
  • Page 126 Chapter 11 Creating a Build Image • Generate installation logs: unchecked Click Next. BMC confirms your settings. Figure 11-5 BMC - Step 7 Click Next. BMC confirms that it will delete all data on your USB. Figure 11-6 BMC - Step 8 Click Yes.
  • Page 127 Chapter 11 Creating a Build Image Figure 11-7 BMC - Step 9 Click Next after the write operation is complete. 11-5...
  • Page 128 Chapter 11 Creating a Build Image Figure 11-8 BMC - Step 10 Click Back to make another copy, or Finish to exit BMC. Remove the USB flash drive when complete to ensure that the computer does not attempt to install your software during the next boot cycle. 11-6...
  • Page 129: Software Upgrade

    Upgrade Checklist Before upgrading the Oracle Communications Session Border Controller software: Obtain the name and location of the target software image file from either Oracle Software Delivery Cloud, https://edelivery.oracle.com/, or My Oracle Support, https:// support.oracle.com, as applicable.
  • Page 130: Check Upgrade Readiness

    Oracle recommends examining the output of this command at least twice: Prior to upgrade—The command can display potential risks with the upgrade.
  • Page 131 Chapter 12 Check Upgrade Readiness Platform : NN4600 Validate Memory Usage: : Memory usage (Percent Free: 93) Validate CPU usage: : CPU Usage (Percent Usage:77) : CPU Core 00 (Percent Usage:89) WARNING : CPU Core 01 (Percent Usage:93) : CPU Core 02 (Percent Usage:44) : CPU Core 03 (Percent Usage:81)
  • Page 132: Download The Software

    Oracle Cloud Software Delivery website. With an account and a product license, you can download the software. Before You Begin Confirm that you have an account with Oracle and a license for the product that you want to download. Download the Media Pack, software, and License Document for the product and platform that you want.
  • Page 133: Stand-Alone Upgrade

    The stage 3 boot loader is backward compatible with application software. The Stage3 boot loader is generally backward compatible with previous releases, but Oracle recommends that the Stage3 boot loader be installed from the same Major.Minor version as the system image.
  • Page 134: Software Upgrade Procedure

    Software Upgrade Procedure The following procedure describes how to upgrade a Oracle Communications Session Border Controller with a new software image. In this procedure, the image file is located on the Oracle Communications Session Border Controller’s local file system in /boot.
  • Page 135: Ha Upgrade

    HA Upgrade In the descriptions and processes outlined below, ORACLE-1 is initially the active system and ORACLE-2 is initially the standby system. Please read the following procedures carefully before beginning the upgrade. If necessary, you can back out of the upgrade once during the upgrade procedure and once after you have completed the upgrade procedure.
  • Page 136 Chapter 12 HA Upgrade On ORACLE-1, show the current configuration version by using the ACLI display- current-cfg-version command. Then use the same command on ORACLE-2 and be sure that its current configuration version is the same as the one on ORACLE-1.
  • Page 137 /boot directory using an SFTP client. (See the instructions on updating the Stage 3 Bootloader.) As you did for ORACLE-2, configure the boot parameters on ORACLE-1 to boot from the new software image. Then reboot ORACLE-1. ORACLE-1# reboot...
  • Page 138: Ha Backout Procedure

    If you reach the point in your upgrade procedure where you have upgraded both Oracle Communications Session Border Controllers in the HA pair to a later release that you decide you no longer want to use, you can fall back to a previous release.
  • Page 139 ORACLE-1# notify berpd force At this point, ORACLE-1 becomes the active system running Release S-CZ7.2.0. ORACLE-2 is now the standby system running Release S-CZ7.3.0. On ORACLE-2, change the boot parameters as you did in Step 1 of this procedure. Reboot ORACLE-2. 12-11...
  • Page 140: Physical Interfaces On Acme Packet Platforms

    Logs sent from the Oracle Communications Session Border Controller • The boot file used to boot the Oracle Communications Session Border Controller from a remote file server The wancom0 interface does not require that the user perform physical or network interface branch configuration procedures within the ACLI.
  • Page 141: Acme Packet 1100 Physical Interfaces

    Figure A-1 Acme Packet 1100 - Rear View The Acme Packet 1100 NIU includes the following ports (from left to right). • USB—For use only by Oracle personnel. • SER MGT (Console)—Provides serial access for administrative and maintenance purposes. •...
  • Page 142: Acme Packet 3900 Physical Interfaces

    Appendix A Acme Packet 3900 Physical Interfaces • INT—The system uses this 10/100 Mbps port for signaling and media traffic that is outbound with respect to the Remote Office/Branch Office (ROBO). This traffic originates from the ROBO. • EXT—The system uses this 10/100 Mbps port for signaling and media traffic that is inbound with respect to the Remote Office/Branch Office (ROBO).
  • Page 143: Snmp Hardware Reporting

    Appendix A Acme Packet 3900 Physical Interfaces • SER MGT—For console access for administrative and maintenance purposes • MGMT0—For EMS control, RADIUS accounting, CLI management, SNMP queries and traps, and other network management functions • MGMT1 and MGMT2—For High Availability (HA), or for network management with no HA configuration •...
  • Page 144: Acme Packet 3900 Mibs Paths

    Appendix A Acme Packet 4600 Physical Interfaces • Updates the apevPowerSupply object to include the apevPowerSupply 500 W object. Acme Packet 3900 MIBS Paths Paths for Acme Packet 3900 MIBS. SNMPv2-SMI::mib-2.47.1.1.1.1.2.1 = STRING: "Acme Packet 3900 Chassis" SNMPv2-SMI::mib-2.47.1.1.1.1.2.2 = STRING: "Intel(R) Xeon(R) CPU D-1548 @ 2.00GHz" SNMPv2-SMI::mib-2.47.1.1.1.1.2.3 = STRING: "495 Watt Power Supply"...
  • Page 145: Acme Packet 6100 Physical Interfaces

    • Alarm—Dry contact alarm port. • USB—The USB port is reserved for use by Oracle support employees only. • Mgmt 0–Mgmt 2—The system uses these 10/100/1000 Base-T Ethernet ports are used for device management functions. The first interface, Mgmt 0, is for ssh access to the ACLI.
  • Page 146: Acme Packet 6300/6350 Physical Interfaces

    • Alarm—Dry contact alarm port. • USB—For use only by Oracle personnel. • Mgmt0 to Mgmt2—The system uses these 10/100/1000 Base-T Ethernet ports for device management functions. The first interface, Mgmt 0, is for ssh access to the ACLI. The other two interfaces are used for state replication for High Availability (HA).
  • Page 147: Signaling And Media Interfaces

    Appendix A Acme Packet 6300/6350 Physical Interfaces The console port is serial and the alarm is "dry contact". The USB port is reserved for use by Oracle personnel, only. The following illustration shows the ports. Figure A-5 Acme Packet 6300/6350 Management Interfaces The following table maps the reference numbers in the preceding illustration and the labeling on the management interfaces.
  • Page 148: Acme Packet 6300

    Appendix A Acme Packet 6300/6350 Physical Interfaces enables greater scaling capacity, and the use of DDR4 running at 1050MHz provides a memory performance boost. Note: When using the 4x10GbE NIU, you must put it in slot 0. Acme Packet 6300 Acme Packet 6300 Media Interface The Acme Packet 6300 contains three PHY card slots.
  • Page 149: Acme Packet 6350

    Appendix A Acme Packet 6300/6350 Physical Interfaces Acme Packet 6350 Acme Packet 6350 Media Interface The Acme Packet 6300 contains three PHY card slots. Slots 0 and 1 support network- facing media interface cards. Slots 1 and 2 support transcoding cards. The Acme Packet 6350 supports both the 2x10GbE NIU and 4x10GbE NIU.
  • Page 150: Dual Port And Quad Port Nius

    Appendix A Acme Packet 6300/6350 Physical Interfaces Dual Port and Quad Port NIUs The Acme Packet 6350 supports Dual 10 GbE and Quad 10 GbE Network Interface Units (NIU). The Dual NIU contains two 10G interfaces, while the Quad NIU contains four 10G interfaces to provide greater session scaling capacity and Packet Processing Module (PPM) support.
  • Page 151 Appendix A Acme Packet 6300/6350 Physical Interfaces A-12...
  • Page 152 Appendix A Acme Packet 6300/6350 Physical Interfaces Note: The Quad 10 GbE NIU must go in slot 0. A-13...

Table of Contents