Cisco Content Security Virtual Appliance Installation Guide

Last Updated: October 25, 2013

Contents

About the Cisco Content Security Virtual Appliance, page 1 Set Up the Virtual Appliance, page 3 Managing Your Cisco Content Security Virtual Appliance, page 7 Where to Find More Information, page 9

About the Cisco Content Security Virtual Appliance

The Cisco Web and Email Security virtual appliances are virtual machines that you can host on your own network. These Cisco Content Security virtual appliances function the same as the physical hardware appliances, with only a few minor changes, which are documented in Managing Your Cisco Content Security Virtual Appliance, page 7. This guide covers the Cisco Web and Email Security virtual appliances.

Cisco Content Security Virtual Appliance Models

The Cisco Content Security virtual appliance models have similar disk layouts, queue and cache sizes, and configurations as their physical hardware appliance counterparts. The virtual security appliances have been pre-configured with the following parameters:

Cisco Systems, Inc. www.cisco.com

About the Cisco Content Security Virtual Appliance

Virtual Appliance
C100V C300V C600V S000V S100V S300V

Disk Space 200 GB 500 GB 500 GB 250 GB 250 GB 1024 GB

Queue/Cache Space 10 GB 70 GB 70 GB 50 GB 50 GB 200 GB

Memory 6 GB 8 GB 8 GB 4 GB 6 GB 8 GB

Processor Cores 2 4 8 1 2 4

Supported AsyncOS Releases

You can run the following AsyncOS releases on the virtual security appliances:

Virtual Email Security appliance: AsyncOS 8.0 for Email Security Virtual Web Security appliance: AsyncOS 7.7.5 for Web Security

You can manage the configuration of the virtual Cisco Web Security appliance using a Cisco Security Management appliance running Cisco AsyncOS 8.0 or later for Security Management.

System Requirements
Hardware and Virtualization Hypervisor
Cisco UCS servers (blade or rack-mounted) are the only supported hardware platform for the virtual appliance. VMware ESXi version 4.x and 5.0 are the only supported virtualization hypervisors. Any other hardware platform or VMware hypervisor will be supported on a Best Effort basis: we will try to help you, but it may not be possible to reproduce all problems, and we cannot guarantee a solution. No other virtualization hypervisor is supported. Cisco recommends that the server hosting your virtual appliances meets the following minimum requirements: two 64-bit x86 processors of at least 1.5 GHz each, 8 GB of physical RAM, and a 10k RPM SAS hard drive disk.

VMware ESXi 4.x File System Settings

VMware ESXi version 4.x comes with a file system that has a default block-size of 4 MB, which supports a virtual disk image of up to 1 TB. However, the larger Cisco virtual security appliances (e.g., S300V) require more than 1 TB of disk space. In order to run these models, you will need to create a new datastore and format it with an 8 MB or larger block size. For information on block size and instructions on how to create a new datastore, see VMwares technical documentation at http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId =1003565.

Cisco Content Security Virtual Appliance Installation Guide

Set Up the Virtual Appliance

The Management Interfaces IP Address and DHCP

When the virtual appliance is first powered on, the Management port gets an IP address from your DHCP host. If the virtual appliance is unable to obtain an IP address from a DHCP server, it will use 192.168.42.42 as the Management interfaces IP address. The CLI displays the Management interfaces IP address when you run the System Setup Wizard on the virtual appliance.

Set Up the Virtual Appliance

Action
1.

More Information In addition to allowing you to run the appliance, this license file includes all the feature keys for your virtual appliance. The Virtual Appliance License File, page 7. You will need the MD5 hash to check the data integrity of the appliance image. Download the Cisco Content Security Virtual Appliance Image, page 4.

Obtain a virtual appliance license from Cisco.

2.

Download the virtual appliance image and MD5 hash from Cisco.

3. 4. 5.

(Optional) Clone the image if you want to run multiple virtual appliances on your network.

Clone the Virtual Appliance, page 4.

Deploy the virtual appliance on your ESX host or Deploy the Virtual Appliance, page 4. cluster. Configure synchronization on the virtual machine Important! Prevent Random Failures, page 5 to avoid random failures on your Cisco Content Security virtual appliance. If DHCP is disabled, integrate the appliance into your network. If DHCP Is Disabled, Set Up the Appliance on the Network, page 5

6. 7.

(Optional) FTP into the virtual appliance to upload Or you can copy and paste the license file into the the license file. appliances CLI when running the loadlicense command. See Install the Virtual Appliance License File, page 6 for more information. Install the license file. Log into the web UI (http://<IP address>:8080) and:

8. 9.

Install the Virtual Appliance License File, page 6.

Run the System Setup Wizard Upload a configuration file that has been specially modified for virtual appliances Manually configure features and functionality.

To run the System Setup Wizard, see instructions in the user guide for your Cisco Security appliance for more information. To migrate settings from a physical appliance, see the Release Notes for the Configuration Migration Tool for Cisco Content Security Virtual Appliances. To manually configure features and functionality, see the online help or User Guide for your AsyncOS release.

Cisco Content Security Virtual Appliance Installation Guide

Set Up the Virtual Appliance

Download the Cisco Content Security Virtual Appliance Image

Before You Begin

Obtain a license from Cisco for your virtual appliance.

Step 1

Go to the Cisco Download Software page for your virtual appliance:

For Email security: http://software.cisco.com/download/release.html?mdfid=284900944&flowid=41782&softwareid= 282975113&release=8.0.0&relind=AVAILABLE&rellifecycle=GD&reltype=latest For Web security: http://software.cisco.com/download/release.html?mdfid=284806698&flowid=41610&softwareid= 282975114&release=7.7.5&relind=AVAILABLE&rellifecycle=GD&reltype=latest

Step 2 Step 3

Click Download for the virtual appliance model image you want to download. Save the image to your local machine.

Clone the Virtual Appliance

If you will run multiple virtual security appliances in your environment:

Cisco recommends that you clone the virtual security appliance before you run it the first time. Cloning a virtual security appliance after the license for the virtual appliance has been installed forcefully expires the license. You will have to install the license again. You must shut down the virtual appliance before cloning it. If you want to clone a virtual appliance that is already in use, see Clone a Virtual Appliance Already in Use, page 6 for more information.

For instructions on cloning a virtual machine, see VMWares technical documentation at http://www.vmware.com/support/ws55/doc/ws_clone.html.

Deploy the Virtual Appliance

Before You Begin

Set up the ESX host or cluster on which you will deploy the virtual appliance. See System Requirements, page 2 for more information. Install the VMware vSphere Client on your local machine. Download the image as described in Download the Cisco Content Security Virtual Appliance Image, page 4.

Step 1 Step 2 Step 3 Step 4

Unzip the .zip file for the virtual appliance in its own directory; e.g., C:\vESA\C100V or :\vWSA\S300V. Open the VMware vSphere Client on your local machine. Select the ESX host or cluster to which you want to deploy the virtual appliance. Choose File > Deploy OVF template.

Cisco Content Security Virtual Appliance Installation Guide

Set Up the Virtual Appliance

Step 5 Step 6 Step 7

Enter the path to the OVF file in the directory you created. Click Next. Complete the wizard.

Important! Prevent Random Failures

Virtual machines have inherent timing quirks that you must address in order to avoid random failures on your Cisco Content Security virtual appliance. Enable exact time stamp counter synchronization on your virtual machine to prevent these issues.
Before You Begin

For more information on timekeeping basics, virtual time stamp counters, and exact synchronization, see VMWares Timekeeping in Virtual Machines PDF at http://www.vmware.com/files/pdf/techpaper/Timekeeping-In-VirtualMachines.pdf.
Step 1 Step 2 Step 3 Step 4 Step 5

Select a virtual appliance from the list of machines in the vSphere Client. Right-click the appliance and select Edit Settings. Click the Options tab and select Advanced > General. Click Configuration Parameters. Edit or add the following parameters:
monitor_control.disable_tsc_offsetting=TRUE monitor_control.disable_rdtscopt_bt=TRUE timeTracker.forceMonotonicTTAT=TRUE

Step 6

Close the settings window and run appliance.

If DHCP Is Disabled, Set Up the Appliance on the Network

Note

If you cloned the virtual security appliance image, perform the following steps for each image. From the vSphere client console, run interfaceconfig. Write down the IP address of the virtual appliances Management port.

Step 1 Step 2

Note

The Management port obtains its IP address from your DHCP server. If the appliance cannot reach a DHCP server, it will use 192.168.42.42 by default.

Step 3 Step 4

Configure the default gateway using the setgateway command. Commit the changes.

Cisco Content Security Virtual Appliance Installation Guide

Set Up the Virtual Appliance

Install the Virtual Appliance License File

Note

If you cloned the virtual security appliance image, perform the following steps for each image. Using SSH or telnet in a terminal application, log into the appliances CLI as the admin/ironport user.

Step 1

Note Step 2 Step 3

You cannot paste the contents of the license file into the CLI using the vSphere client console.

Run the loadlicense command. Install the license file using one of the following options:

Select option 1 and paste the contents of the license file into the terminal. Select option 2 and load the license file in the configuration directory, if you have already uploaded the license file to the appliances configuration directory using FTP.

Step 4 Step 5

Read and agree to the license agreement. (Optional) Run showlicense to review the license details.

What to Do Next

For more information on the Management interfaces IP address, see The Management Interfaces IP Address and DHCP, page 3. See remaining setup steps in Set Up the Virtual Appliance, page 3.

Migrate Your Virtual Appliance to Another Physical Host

Cisco supports the use of VMWares vMotion to migrate your virtual appliance to another physical server. The following requirements must be followed in order to migrate your virtual appliance:

Both physical hosts must have access to the same defined network to which the appliance's interfaces are mapped. Both physical hosts must have access to the datastore that the virtual appliance uses. Make sure that your Email Security virtual appliance has no mail in its queue.

You can migrate your virtual appliance while it is online. Refer the VMWares technical documentation for instructions on migrating virtual machines using vMotion.

Clone a Virtual Appliance Already in Use

Before You Begin

For instructions on cloning a virtual machine, see VMWares technical documentation at http://www.vmware.com/support/ws55/doc/ws_clone.html. For information on how to manage your appliances network settings and security features, see the user guide for your release of Cisco AsyncOS for Web or Cisco AsyncOS for Email.

Cisco Content Security Virtual Appliance Installation Guide

Managing Your Cisco Content Security Virtual Appliance

Step 1

If you are cloning an Email Security virtual appliance, suspend the appliance using the suspend command in the CLI and enter a delay period long enough for the appliance to deliver all messages in the queue. Shut down the Email or Web virtual security appliance using the shutdown command in the CLI. Clone the virtual appliance. Start the cloned appliance using the VMware vSphere Client and perform the following:

Step 2 Step 3 Step 4

Install the license file for the virtual appliance. Modify its network settings. For Email Security virtual appliances:
Delete all messages in the quarantines. Delete the message tracking and reporting data.

For Web Security virtual appliances:

Clear the proxy cache. Clear the proxy authentication cache using the authcache > flushall command in the CLI. Remove reporting and tracking data with the diagnostic > reporting > deletedb command

in the CLI.
For Authentication Realms, rejoin the domain. For Authentication Settings, modify the redirect hostname. If the original virtual appliance was managed by an Security Management appliance, add the

cloned appliance to the Security Management appliance.

Step 5 Step 6

Start the original virtual appliance using the VMware vSphere Client and resume operation. Make sure that it is running properly. Resume operation on the cloned appliance.

Managing Your Cisco Content Security Virtual Appliance

The Virtual Appliance License File
The Cisco Content Security virtual appliance requires an additional license to run the virtual appliance on a host. You can use this license for multiple, cloned virtual appliances. For information on installing the license file, see Install the Virtual Appliance License File, page 6. Feature keys are included as part of the license. The feature keys expire at the same time as the license, even if the feature has not been activated. Purchasing new feature keys will require downloading and installing a new virtual appliance license file.

Note

You cannot open a Technical Support tunnel before installing the virtual appliance license. Information about Technical Support tunnels is in the User Guide for Cisco AsyncOS for Web or Cisco AsyncOS for Email.

Cisco Content Security Virtual Appliance Installation Guide

Managing Your Cisco Content Security Virtual Appliance

Altering the Virtual Appliances Hardware Configuration

Cisco does not support the alteration of the Cisco Content Security virtual appliances hardware configuration, such as removing IP interfaces or changing the appliances CPU cores or RAM size. The appliance may send alerts if such changes are made.

CLI Commands on the Virtual Appliance

The Cisco Content Security virtual appliances include updates to existing CLI commands and includes a virtual appliance-only command, loadlicense. The following CLI command changes have been made: Command
loadlicense

Information This command allows you to install a license for your virtual appliance. You cannot run System Setup Wizard on the virtual appliance without installing a license using this command first. The Pairing option is not included on virtual appliances. This command will return all the information about the virtual appliance except for the UDI, RAID, and BMC information. Running this command leaves the virtual appliance license and the feature keys on the appliance. Running this command removes the virtual appliance license and all the feature keys on the appliance. This command is available only for the Web Security appliance. The following diagnostic > raid submenu options will not return information:
1. 2. 3. Run disk verify Monitor tasks in progress Display disk verify verdict

etherconfig version

resetconfig

reload

diagnostic

This command is only available for the Email Security appliance.

SNMP on the Virtual Appliance

AsyncOS on virtual appliances will not report any hardware-related information and no hardware-related traps will be generated. The following information will be omitted from queries:

powerSupplyTable temperatureTable fanTable raidEvents raidTable

Cisco Content Security Virtual Appliance Installation Guide

Where to Find More Information

Where to Find More Information

Information sources for Cisco Content Security products include the following:

Cisco Notification Service, page 9 Documentation, page 9 Knowledge Base, page 10 Cisco Support Community, page 10 Customer Support, page 10 Registering for a Cisco Account, page 10 Cisco Welcomes Your Comments, page 11

Cisco Notification Service

Sign up to receive notifications relevant to your Cisco Content Security Appliances, such as Security Advisories, Field Notices, End of Sale and End of Support statements, and information about software updates and known issues. You can specify options such as notification frequency and types of information to receive. You should sign up separately for notifications for each product that you use. To sign up, visit http://www.cisco.com/cisco/support/notifications.html A Cisco.com account is required. If you do not have one, see Registering for a Cisco Account, page 10.

Documentation
The documentation set for Cisco Content Security virtual appliances includes the following documents and books (not all types are available for all appliances and releases

Cisco AsyncOS for Web User Guide Cisco AsyncOS CLI Reference Guide Cisco AsyncOS for Email User Guide Release Notes for the above products and for the Configuration Migration Tool.

This and other documentation is available at the following locations: Documentation For Cisco Content Security Products Email Security appliances Web Security appliances Content Security Management appliances

Location http://www.cisco.com/en/US/products/ps10154/tsd_products_s upport_series_home.html http://www.cisco.com/en/US/products/ps10164/tsd_products_s upport_series_home.html http://www.cisco.com/en/US/products/ps10155/tsd_products_s upport_series_home.html

Cisco Content Security Virtual Appliance Installation Guide

Where to Find More Information

Documentation For Cisco Content Security Products CLI reference guide for Content Security appliances Cisco IronPort Encryption

Location http://www.cisco.com/en/US/products/ps10154/tsd_products_s upport_series_home.html http://www.cisco.com/en/US/partner/products/ps10602/tsd_pro ducts_support_series_home.html

Knowledge Base
To access the Knowledge Base for information about Cisco Content Security products, visit: http://www.cisco.com/web/ironport/knowledgebase.html

Note

You need a Cisco.com User ID to access the site. If you do not have a Cisco.com User ID, see Registering for a Cisco Account, page 10.

Cisco Support Community

Cisco Support Community is an online forum for Cisco customers, partners, and employees. It provides a place to discuss general content security issues, as well as technical information about specific Cisco products. You can post topics to the forum to ask questions and share information with other users. Access the Cisco Support Community at the following URLs:

For email security and associated management: https://supportforums.cisco.com/community/netpro/security/email For web security and associated management: https://supportforums.cisco.com/community/netpro/security/web

Customer Support
Use the following methods to obtain support: International: http://www.cisco.com/en/US/support/tsd_cisco_worldwide_contacts.html Support Site: http://www.cisco.com/en/US/products/ps11169/serv_group_home.html

Registering for a Cisco Account

Access to many resources on Cisco.com requires a Cisco account. If you do not have a Cisco.com User ID, you can register for one here: https://tools.cisco.com/RPF/register/register.do
Related Topics

Cisco Notification Service, page 9 Knowledge Base, page 10

Cisco Content Security Virtual Appliance Installation Guide

10

Where to Find More Information

Cisco Welcomes Your Comments

The Technical Publications team is interested in improving the product documentation. Your comments and suggestions are always welcome. You can send comments to the following email address: contentsecuritydocs@cisco.com Please include the title of this book and the publication date from the title page in the subject line of your message.

Cisco Content Security Virtual Appliance Installation Guide

11

Where to Find More Information

Cisco Content Security Virtual Appliance Installation Guide

12