The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This section contains the following topics:
Registering service VMs with Prime Network Services Controller ensures that Prime Network Services Controller recognizes and can communicate with the VMs.
For Cisco service VMs, see Registering Cisco VMs Deployed on OpenStack KVM.
For third-party service VMs, see Registering Third-Party VMs.
This procedure describes how to register CSR 1000V VMs with Prime Network Services Controller. This procedure applies only to those edge routers that have been installed directly on the hypervisor. Edge routers that are instantiated on the hypervisor by using Prime Network Services Controller are automatically registered with Prime Network Services Controller upon instantiation.
Complete the tasks described in Performing OpenStack KVM Post-Installation Tasks.
Install the CSR 1000V VM on the hypervisor.
Confirm that the VM is installed and powered on.
Make sure that a network path exists between the VM management IP address and the Prime Network Services Controller management IP address.
Step 1 | On OpenStack,
configure the edge router so that it supports remote management by
Prime Network Services Controller.
For more information, see the Cisco CSR 1000V Series Cloud Services Router Software Configuration Guide. |
Step 2 | In OpenStack, navigate to the edge router VM to be registered with Prime Network Services Controller. |
Step 3 | Open a console window for the VM. |
Step 4 | In the CLI,
register the edge router VM by entering the following commands:
Router> enable Router# configure terminal Router(config)# remote-management Router(config-remote-mgmt)# pnsc host n.n.n.n local-port number shared-secret string Router(config-remote-mgmt)# end Router# show remote-management status |
Registering third-party VMs that are installed on OpenStack with Prime Network Services Controller involves installing the Prime Network Services Controller Device Adapter on OpenStack and then instantiating and registering the third-party VMs with Prime Network Services Controller.
Complete the following tasks to instantiate a Citrix NetScaler load balancer on OpenStack and register the load balancer with Prime Network Services Controller.
Task | Related Topic |
---|---|
1. Confirm that the prerequisites are met. |
Prerequisites for Citrix NetScaler Load Balancers on OpenStack |
2. Install Prime Network Services Controller Device Adapter. |
Installing the Prime Network Services Controller Device Adapter on OpenStack |
3. Configure OpenStack. |
|
4. Instantiate a Citrix NetScaler load balancer. |
Instantiating a Citrix NetScaler VPX Load Balancer in OpenStack |
5. Register the Citrix NetScaler instance with Prime Network Services Controller. |
Registering a Citrix NetScaler Load Balancer with Prime Network Services Controller |
The following table lists the prerequisites for instantiating Citrix NetScaler load balancers on OpenStack and registering the load balancers with Prime Network Services Controller.
Requirement | Notes |
---|---|
Prime Network Services Controller has been installed and is accessible from OpenStack. |
|
A project has been created in OpenStack. |
|
The network requirements are met. |
|
The Prime Network Services Controller Device Adapter enables third-party VMs (such as Citrix NetScaler load balancers) to register with Prime Network Services Controller.
Prime Network Services Controller Device Adapter must be installed before you can deploy and register third-party service nodes, such as Citrix NetScaler load balancers.
Adding or editing policies from the Prime Network Services Controller Device Adapter is not supported. All configuration must be performed using the Prime Network Services Controller GUI.
You need to install the Prime Network Services Controller Device Adapter only once for each Prime Network Services Controller instance.
If you reinitialize Prime Network Services Controller, you must also reinitialize Prime Network Services Controller Device Adapter.
For more information about OpenStack, see docs.openstack.org.
Creating an initialization shell script.
Creating a flavor.
Uploading a Citrix NetScaler load balancer image.
Creating the required subnet.
For more information about OpenStack and the commands included in this procedure, see the OpenStack documentation at docs.openstack.org.
The prerequisites have been met as described in Prerequisites for Citrix NetScaler Load Balancers on OpenStack.
The Prime Network Services Controller Device Adapter has been installed on OpenStack and is registered with Prime Network Services Controller. For more information, see Installing the Prime Network Services Controller Device Adapter on OpenStack.
Step 1 | In OpenStack,
create an initialization shell script as follows:
| ||
Step 2 | In the OpenStack dashboard, create a flavor with the following attributes: | ||
Step 3 | Upload a
Citrix
NetScaler load balancer image using the
following command:
# glance image-create --name image-name --disk-format raw --container-format=bare --is-public=true --file=/home/localadmin/images/image-name.raw # glance image-create --name NSVPX-KVM-10.1-120.13 --disk-format raw --container-format=bare --is-public=true --file=/home/localadmin/images/NSVPX-KVM-10.1-120.13_nc.raw | ||
Step 4 | After the
image is uploaded, note the UUID of the image. Use the UUID instead of the
image name to ensure that a unique value is specified.
| ||
Step 5 | Create a private
subnet by entering the following command. The
Citrix
NetScaler data interface must be in a
different subnet than the management interface.
# quantum net-create SubnetName |
This procedure describes how to instantiate a Citrix NetScaler VPX load balancer in OpenStack.
For more information about OpenStack and the commands included in this procedure, see the OpenStack documentation at docs.openstack.org.
Make sure that you have configured OpenStack as described in Configuring OpenStack for Citrix NetScaler Load Balancers.
Confirm that anti-spoofing has been disabled on OpenStack. For information on disabling anti-spoofing in OpenStack, see Removing Anti-Spoofing Rules for CSR 1000V Data Interfaces. If you do not disable anti-spoofing in OpenStack, service VMs will not work.
Step 1 | Obtain the
following UUIDs:
| ||
Step 2 | Enter the
following command to create the
Citrix
NetScaler instance:
# nova boot --flavor=flavorID --image=imageID --security-groups=securityGroup --nic net-id=netID1, v4-fixed-ip=ipAddress1--nic net-id=netID2 ,v4-fixed-ip=ipAddress2 vmName For example, your command might resemble the following: # nova boot --flavor=99 --image=4c5716cd-eef9-4947-8bce-d2d1432d5ccd --security-groups=open_network --nic net-id=645683e7-0b66-4c96-8f71-0edee35f1408,v4-fixed-ip=172.25.117.220 --nic net-id=39f7b506-b7f5-4bcd-b475-0e49b21da759,v4-fixed-ip=10.11.25.10 m-vpx-220
| ||
Step 3 | Note the IP address assignments. You must use the same IP address later in this procedure when you configure the load balancer. | ||
Step 4 | After the load balancer instance starts, access the instance console by clicking Instances in the dashboard and then choosing the Console tab. | ||
Step 5 | After the instance boots and the console displays a State UP message, press Enter twice to obtain the login prompt. | ||
Step 6 | Log in to the Citrix NetScaler load balancer. | ||
Step 7 | At the command prompt, enter shell. | ||
Step 8 | In the shell,
enter the following command:
root@ns# vi /nsconfig/na.conf | ||
Step 9 | Modify the na.conf file as follows: | ||
Step 10 | Save the file and exit the editor. | ||
Step 11 | Reboot the load balancer instance. |
After a Citrix NetScaler load balancer VM starts, you can register it with Prime Network Services Controller.
Deploy a Citrix NetScaler load balancer VM in the hypervisor. For more information, see:
For OpenStack, see Instantiating a Citrix NetScaler VPX Load Balancer in OpenStack.
For VMware, see Citrix product documentation at http://support.citrix.com/proddocs/topic/infocenter/ic-how-to-use.html.
Create a tenant in Prime Network Services Controller if one does not exist.
Configure a virtual server profile in Prime Network Services Controller.