Skip to end of metadata
Go to start of metadata

Use this section to configure the embedded Policy Server (ePSX) as a Virtual Machine (VM) application using the vmApplication object.

The ePSX is installed as an additional package and replaces ERE functionality when running. The ePSX is delivered as an OVF (Open Virtualization Format) package. OVF is an emerging standard for the distribution of virtual machines, and provides mechanisms for defining the guest resource requirements and for tailoring applications to their target environment. Before the ePSX package can be installed, the ePSX option must be enabled during SBC software installation. See Installing SBC 5000 Series Application (ePSX Configuration) for details.

The ePSX shares the host’s network interfaces, but uses a separate internal VM IP address. This is accomplished by linking the physical and virtual interfaces via a Linux bridge device, which is a layer 2 software switch that allows multiple logical interfaces to reside on the same physical interface. Network processor (NP) enhancements to support multiple virtual interfaces are needed to maintain network performance and security.

The core technology of virtualization is the hypervisor. A hypervisor manages virtual machines, allocates resources and provides hardware emulation to the guest systems. A type 1 hypervisor runs directly on the hardware, providing services for all running systems. A type 2 hypervisor runs under a native operating system and provides services to all but the host system. KVM (Kernel-based Virtual Machine) is a type 2 hypervisor for Linux systems and is used to provide SBC virtualization services. The ePSX application executes as a completely independent machine from the host SBC.

The vmApplication object is only visible from the CLI when the SBC system is configured for ePSX during software installation.

Command Syntax

% set vmApplication <VM app. name> 
	admin <hostname>
	mgmtStaticRoute <hostname> <destination IP address> <IP prefix> <IP address of next system en route to destination> <mgt0 | mgt1> preference <1-99>
	packetStaticRoute <destination IP address> <IP prefix> <IP address of next system en route to destination> <pkt0 | pkt1 | pkt2 | pkt3> preference <1-99>
	ports 
		mgmtAdmin <hostname> <mgt0 | mgt1> 
			ipAddress <port IP address> 
			macAddress <MAC address of network interface>
			prefix <IP subnet prefix>
		packetPortAdmin <pkt0 | pkt1 | pkt2 | pkt3>
			ipAddress <port IP address> 
			macAddress <MAC address of network interface>
			prefix <IP subnet prefix>
			vlanTag <VLAN tag assigned to this IP interface>

% request vmApplication <VM app. name> admin <active_host_name> vmUpgrade package <ePSX package>
% request vmApplication <VM app. name> admin <active_host_name> revertSoftwareUpgrade

% show vmApplication <VM app. name> 
% show vmApplication <VM app. name> admin <hostname>
% show vmApplication <VM app. name> mgmtStaticRoute <hostname>
% show vmApplication <VM app. name> packetStaticRoute <hostname>
% show vmApplication <VM app. name> ports

% delete vmApplication <VM app. name> admin <hostname>
% delete vmApplication <VM app. name> mgmtStaticRoute <hostname>
% delete vmApplication <VM app. name> packetStaticRoute <hostname>
% delete vmApplication <VM app. name> ports

Command Parameters

Table : set vmApplication Parameters

ParameterLength/RangeDescription
vmApplication1-255VM application name.
adminN/A<hostname> – Enter the hostname to associate with vmApplication administrative data.
mgmtStaticRoute N/A

<hostname> – Hostname of Management Static IP route. Attributes include:

  • <destination IP address> <IP prefix>
  • <IP address of next system en route to the destination>
  • <mgt0 | mgt1> – Management port to associate with this management static route.

  • preference – Route preference value (range: 1-99 / default = 10).
packetStaticRouteN/A

Static IP routes for this address context. Attributes include:

  • <destination IP address> <IP prefix>
  • <IP address of next system en route to the destination>
  • <pkt0 | pkt1 | pkt2 | pkt3> – Packet port to associate with this packet static route.
  • preference – Route preference value (range: 1-99 / default = 10)
portsN/A

Configuration of VM management, packet, and field-service HA Ethernet ports. Attributes include:

  • mgmtAdmin <hostname> – Management port configuration.
    • <mgt0 | mgt> – Management port.
    • ipAddress  – Management port IP address.
    • macAddress – MAC address of network interface (range: 6-6 octets).
    • prefix – IP subnet prefix of this IP interface (range: 0-128).
  • packetPortAdmin – Packet port configuration.
    • <pkt0 | pkt1 | pkt2 | pkt3> – Packet port.
    • ipAddress  – Packet port IP address.
    • macAddress – MAC address of network interface (range: 6-6 octets).
    • prefix – IP subnet prefix of this IP interface (range: 0-128).
    • vlanTag – VLAN tag assigned to this IP interface (range: 2-4094)

Table : request vmApplication admin Parameters

ParameterLength/RangeDescription
admin <active host name>
revertSoftwareUpgrade Use to revert the last Live Software Upgrade (LSWU) of the VM application.
When prompted, enter "yes" to continue.
vmUpgrade  

Use this object to upgrade the VM application on the specified node.

  • package – Enter ePSX package name.

See Upgrading the ePSX for details.

Command Examples

% show vmApplication ePSX
admin SBC01a;
admin SBC01b;
mgmtStaticRoute SBC01a 0.0.0.0 0 10.54.19.1 mgt0 {
    preference 10;
}
mgmtStaticRoute SBC01b 0.0.0.0 0 10.54.19.1 mgt0 {
    preference 10;
}
ports {
    packetPortAdmin pkt0 {
        macAddress 86:45:96:32:63:6f;
    }
    packetPortAdmin pkt1 {
        macAddress 36:75:d3:35:5e:ca;
    }
    packetPortAdmin pkt2 {
        macAddress 16:bb:2e:30:47:fe;
    }
    packetPortAdmin pkt3 {
        macAddress 96:aa:c4:c8:64:e4;
    }
    mgmtAdmin SBC01a mgt0 {
        ipAddress  10.54.19.74;
        prefix     24;
        macAddress e6:32:7d:70:95:21;
    }
    mgmtAdmin SBC01a mgt1 {
        ipAddress  10.54.19.75;
        prefix     24;
        macAddress 66:e5:73:bb:fd:ad;
    }
    mgmtAdmin SBC01b mgt0 {
        ipAddress  10.54.19.76;
        prefix     24;
        macAddress 06:37:72:14:4a:85;
    }
    mgmtAdmin SBC01b mgt1 {
        ipAddress  10.54.19.77;
        prefix     24;
        macAddress d6:22:8c:52:55:af;
    }
}
> show table vmApplication ePSX status
                                                                             PACKAGE        INSTALLED      INTERNAL IP
CE NAME    STATE    REASON  OS VERSION                        APP VERSION    VERSION        CONFIGURATION  ADDRESS
-------------------------------------------------------------------------------------------------------------------------
SBC01b     startup  na      Linux_2.6.32-279.11.1.el6.x86_64  V09.01.00A020  V09.01.00A008  epxMaster      169.254.77.2 
> show table vmApplication ePSX upgradeStatus
CE NAME    STATE
------------------
SBC01a  none
SBC01b  none
> show status vmApplication ePSX
status SBC01b {
    state                  startup;
    reason                 na;
    osVersion              Linux_2.6.32-279.11.1.el6.x86_64;
    appVersion             V09.01.00A020;
    packageVersion         V09.01.00A008;
    installedConfiguration epxMaster;
    internalIpAddress      111.222.33.4;
}
upgradeStatus SBC01a {
    state none;
}
upgradeStatus SBC01b {
    state none;
}
ports {
    packetPortStatus pkt0 {
        state portUp;
    }
    packetPortStatus pkt1 {
        state portUp;
    }
    packetPortStatus pkt2 {
        state portUp;
    }
    packetPortStatus pkt3 {
        state portUp;
    }
    mgmtPortStatus SBC01b mgt0 {
        state portUp;
    }
    mgmtPortStatus SBC01b mgt1 {
        state portUp;
    }
    haPortStatus SBC01b bond0 {
        ipAddress  169.254.66.202;
        macAddress 66:3a:6f:c8:33:cc;
        state      portDown;
    }
}

 

 

  • No labels