Cisco Secure Email Virtual Gateway and Secure Email Installation Guide
Cisco Secure Email Virtual Gateway and Secure Email Installation Guide
Contents
• About Cisco Secure Virtual Appliances, page 2
• System Requirements, page 6
• Prepare the Content Secure Image and Files, page 10
• Deploy on Microsoft Hyper-V, page 11
• Deploy on KVM, page 12
• Deploy on VMWare ESXi, page 17
• Microsoft Azure Deployments, page 20
• Amazon Web Services (AWS) EC2 Deployments, page 20
• Manage Your Cisco Secure Virtual Appliance, page 22
• Increase RAM in Virtual Machine, page 25
• Troubleshoot and Support, page 25
• Additional Information, page 29
Recommended Processor
Product AsyncOS Release Model Disk Size Memory Cores
Cisco Secure Email AsyncOS 15.0 and C600V 500 GB 16GB 8
Virtual Gateway later
Recommended Processor
Product AsyncOS Release Model Disk Size Memory Cores
Cisco Secure Email AsyncOS 15.0 M600V 2032 GB 16 GB 8
and Web Manager and later
Virtual
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
2
Supported Virtual Appliance Models
Max Processor
Product AsyncOS Release Model Disk Size Memory Memory Cores
Cisco Secure AsyncOS 15.0 M600V 2032 GB 16 GB 16 GB 8
Email and Web and later
Manager Virtual
AsyncOS 14.1.0 M600V 2032 GB 8 GB 16 GB 8
and later
For information on increasing RAM in the virtual machine, see Increase RAM in Virtual Machine,
page 25.
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
3
Supported Virtual Appliance Models
Nutanix
Recommended Processor
Product AsyncOS Release Model Disk Size Memory Cores
Cisco Secure Email AsyncOS 16.0 and C600V 500 GB 16GB 8
Virtual Gateway later
Recommended Processor
Product AsyncOS Release Model Disk Size Memory Cores
Cisco Secure Email AsyncOS 16.0 M600V 2032 GB 16 GB 8
and Web Manager and later
Virtual
Note Except as explicitly stated in the AsyncOS documentation, modifications to the ESXi
configurations defined in the OVF are not supported.
[New Install Scenario]: Cisco Content Security virtual appliance OVF images allows you to use the
following pre-configured memory values:
• C100v model: 8 GB
• C300v and C600v model: 16 GB
• M600v model: 16 GB
Processor
Product Model Disk Space Memory Cores
Cisco Secure Email Virtual C100V 200 GB 8 GB 2
Gateway
C300V 500 GB 16 GB 4
C600V 500 GB 16 GB 8
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
4
Supported Virtual Appliance Models
Max Processor
Product Model Disk Space Memory Memory Cores
Cisco Secure Email and M100V 250 GB 6 GB 8 GB 2
Web Manager Virtual
M300V 1024 GB 8 GB 16 GB 4
M600V 2032 GB 16 GB 16 GB 8
[Before AsyncOS 15.0] Cisco Content Security virtual appliance OVF images allows you to switch from
the pre-configured memory values to the new maximum values as follows:
• M100v /C100v models: 6 GB to 8 GB
• M300v / M600v / C300v / C600v models: 8 GB to 16 GB
Max Processor
Product Model Disk Space Memory Memory* Cores
Cisco Secure Email Virtual C100V 200 GB 6 GB 8 GB 2
Gateway
C300V 500 GB 8 GB 16 GB 4
C600V 500 GB 8 GB 16 GB 8
Max Processor
Product Model Disk Space Memory Memory* Cores
Cisco Secure Email and M100V 250 GB 6 GB 8 GB 2
Web Manager Virtual
M300V 1024 GB 8 GB 16 GB 4
M600V 2032 GB 8 GB 16 GB 8
* The Maximum Memory column indicates the maximum memory configuration that is tested and qualified.
AsyncOS version requirements are described in Supported VMWare ESXi Hypervisors, page 8.
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
5
System Requirements
System Requirements
• Microsoft Hyper-V Deployments, page 6
• KVM Deployments, page 7
• VMWare ESXi Deployments, page 8
Supported Microsoft Hyper-V and Host Operating SystemsHardware Requirements for Microsoft
AsyncOS Version Hyper-V Version
AsyncOS 15.0 (Email) and later Microsoft Hyper-V Server 2019
AsyncOS 15.0 (Management) and later Microsoft Hyper-V Server 2019
Hyper-V Deployments
[Secure Email Virtual Gateway]
Hardware:
• Supported on Cisco UCS C-Series or B-Series servers, with Intel Xeon based CPUs
• Cisco Secure Email Virtual performance test labs use as minimum the following: Cisco Unified
Computing System™ (Cisco UCS®) C-Series M5 server with the Intel® Xeon® Gold 6126 CPU @
2.60GHz processor running at 2.6GHz
Note From AsyncOS 15.0 and later, Secure Email Virtual Gateway supports Generation 2 deployments.
Note From AsyncOS 15.0 and later, Secure Email and Web Manager Virtual supports only Generation 2
deployments.
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
6
System Requirements
KVM Deployments
The following are the qualified environments for KVM deployments. All deployments use thin
provisioning for disk storage.
Version Information:
• Linux : 4.18.0-372.9.1.el8.x86_64
• libvirt/QEMU:
Compiled against library: libvirt 8.0.0
Using library: libvirt 8.0.0
Using API: QEMU 8.0.0
Running hypervisor: QEMU 6.2.0
Hardware:
• Supported on Cisco UCS C-Series or B-Series servers, with Intel Xeon based CPUs
• Cisco Secure Email Virtual performance test labs use as minimum the following: Cisco Unified
Computing System™ (Cisco UCS ®) C-Series M5 server with the Intel® Xeon® Gold 6126 CPU @
2.60GHz processor running at 2.6GHz
KVM Drivers
Nutanix
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
7
System Requirements
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
8
System Requirements
Other VMware hypervisors are supported on a “Best Effort” basis: Cisco will try to help you, but it may
not be possible to reproduce all problems, and Cisco cannot guarantee a solution.
Note Except as explicitly stated in the documentation, Cisco does not support the alteration of the Cisco
Content Security virtual appliance’s hardware configuration, such as removing IP interfaces or changing
the appliance’s CPU cores or RAM size. The appliance may send alerts if such changes are made.
ESXi Drivers
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
9
Prepare the Content Secure Image and Files
Step 1 Go to the Cisco Download Software page for your virtual appliance:
• For Cisco Secure Email Virtual Gateway:
https://software.cisco.com/download/home/284900944/type/282975113/release
• For Cisco Secure Email and Web Manager Virtual:
https://software.cisco.com/download/home/286283259/type/286283388/release
Step 2 In the left navigation pane, select an AsyncOS version.
Step 3 Click Download for the virtual appliance model image you want to download.
Step 4 Save the image to your local machine.
Related Topics
• Deploy on Microsoft Hyper-V, page 11
• Deploy on KVM, page 12
• Deploy on VMWare ESXi, page 17
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
10
Deploy on Microsoft Hyper-V
• Upload a configuration file. Feature keys are not activated until you enable the respective
features.
• Manually configure features
and functionality.
Note From AsyncOS 15.0 and later, Secure Email Gateway supports Generation 2 deployments.
From AsyncOS 15.0 and later, Secure Email and Web Manager supports only Generation 2 deployments.
Currently, there is no support for “Secure Boot” and “Trusted Platform Module (TPM)” technologies in
Generation 2 deployment.
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
11
Deploy on KVM
Note If you cloned the virtual security appliance image, perform the following steps for each image.
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.
Note The hostname does not update until after you have completed the setup wizard.
Deploy on KVM
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
12
Deploy on KVM
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
13
Deploy on KVM
Related Topics
• Deploy on KVM, page 12
Procedure
Step 1 Create the storage pool where your virtual appliance will reside.
virsh pool-define-as --name vm-pool --type dir --target /home/username/vm-pool
virsh pool-start vm-pool
Step 2 Copy the virtual appliance image to your storage pool.
cd /home/yusername/vm-pool
tar xvf ~/asyncos-15-0-0-068-C600V.qcow2.tar.gz
Step 3 Install the virtual appliance.
virt-install \
--virt-type kvm \
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
14
Deploy on KVM
--os-type=unix \
--os-variant=freebsd13 \
--name test-dut \ (This name should be unique)
--ram 16384 \ (Use the value appropriate to your virtual appliance model)
--vcpus 8 \ (Use the value appropriate to your virtual appliance model)
--noreboot \
--import \
--disk
path=/home/username/vm-pool/asyncos-15-0-0-068-C600V.qcow2,format=qcow2,bus=virtio \
--network type=direct,source=enp6s0.483,source_mode=vepa,model=virtio \
--network type=direct,source=enp6s0.484,source_mode=vepa,model=virtio \
--network type=direct,source=enp6s0.485,source_mode=vepa,model=virtio \
Step 4 Restart the virtual appliance.
virsh start test-dut
virsh --connect qemu:///system start test-dut
Step 5 To Start or Stop the virtual appliance:
--virsh shutdown test-dut
--virsh start test-dut
Related Topics
• Deploy on KVM, page 12
Deploy on Nutanix
4. Determine the amount of RAM and the number of See System Requirements, page 6
CPU cores to allocate to your virtual appliance
model.
5. Deploy the virtual appliance on your Nutanix See Deploy the Virtual Appliance on Nutanix
Prism. Prism, page 16
6. Install the license file. Install Cisco Content Security Virtual Appliance
License, page 20.
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
15
Deploy on KVM
Procedure
Step 1 Untar the virtual appliance qcow2 image and upload it to your storage pool.
Step 2 Click the Hamburger icon in the top left corner of the Nutanix Prism dashboard.
Step 3 Select Compute and Storage > VM from the left navigation pane.
Step 4 Click the Create VM button.
Step 5 Enter the details to configure the VM and click Next.
To configure the VM Properties, see Cisco Secure virtual appliances function the same as physical
Cisco Secure Email Gateway or Cisco Secure Email and Web Manager hardware appliances, with only
a few minor differences, which are documented in Manage Your Cisco Secure Virtual Appliance,
page 22., page 2.
Step 6 Click the Attach Disk button under Disks and select the following:
• Clone from Image from the Operation drop-down list.
• Uploaded qcow2 image from the Image drop-down list.
Step 7 Click the Attach to Subnet button under Networks and configure the network interface settings.
Step 8 Complete the Wizard to deploy the Virtual Appliance on Nutanix Prism.
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
16
Deploy on VMWare ESXi
4. Prevent intermittent connectivity issues. Disable unused network interface cards (NICs) on
the virtual machine.
5. Configure synchronization on the virtual machine Important! Prevent Random Failures, page 19
to avoid random failures on your Cisco Content
Security virtual appliance.
6. If DHCP is disabled, set up the appliance on your If DHCP Is Disabled, Set Up the Appliance on the
network. Network (VMware vSphere), page 19
7. Install the license file. Install Cisco Content Security Virtual Appliance
License, page 20.
8. Log in to the web UI of your appliance and • For instructions on accessing and configuring
configure the appliance software as you would do the appliance, including gathering required
for a physical appliance. information, see the online help or user guide
for your AsyncOS release, available from the
For example, you can:
relevant location in Additional Information,
• Run the System Setup Wizard page 29.
• Upload a configuration file • To migrate settings from a physical appliance,
• Manually configure features and see the release notes for your AsyncOS
functionality. release.
Feature keys are not activated until you enable the
respective features.
9. Configure the appliance to send alerts when See the online help or user guide for your
license is about to expire. AsyncOS release, available from the relevant
location in Additional Information, page 29.
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
17
Deploy on VMWare ESXi
• If you want to clone a virtual appliance that is already in use, see Clone a Virtual Appliance Already
in Use, page 22 for more information.
For instructions on cloning a virtual machine, see VMWare’s technical documentation at
http://www.vmware.com/support/ws55/doc/ws_clone.html.
Step 1 Unzip the .zip file for the virtual appliance in its own directory; for example, C:\vESA\C100V.
Note Except as explicitly stated in the AsyncOS documentation, modifications to the ESXi
configurations defined in the OVF are not supported.
Note Do not take backup (snapshot) of the virtual appliance using VMware or any other third-party tools, or
restore a virtual appliance from a snapshot. Alternatively, you can take backup of the configuration using
the System Administration > Configuration File menu in the user interface or using the saveconfig
CLI command. You can then load it on another spawned virtual appliance.
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
18
Deploy on VMWare ESXi
Caution It is important that you do not shutdown or restart the virtual appliances using vSphere client or web
client unless advised to do so by Cisco Technical Support. Cisco recommends that you use the shutdown
or reboot command from the CLI, or the Shutdown/Reboot option that is listed in the system
administration tab of the appliance GUI. If you power cycle the appliance (or experience power outage
to the virtual infrastructure), it may lead to loss of messages, database corruption, or loss of logging data.
The failure to unmount the file system cleanly damages the file system, resulting the system in a broken
state.
Virtual machines have inherent timing quirks that you must address in order to avoid random failures on
your Cisco Content Security virtual appliance. To prevent these issues, enable exact time stamp counter
synchronization on your virtual machine.
Step 1 Select a virtual appliance from the list of machines in the vSphere Client.
Step 2 Log in to the CLI, and type the command shutdown to power off the virtual appliance.
Step 3 Right-click the appliance and select Edit Settings.
Step 4 Click the Options tab and select Advanced > General.
Step 5 Click Configuration Parameters.
Step 6 Edit or add the following parameters:
monitor_control.disable_tsc_offsetting=TRUE
monitor_control.disable_rdtscopt_bt=TRUE
timeTracker.forceMonotonicTTAT=TRUE
Step 7 Close the settings window and run appliance.
Note If you cloned the virtual security appliance image, perform the following steps for each image.
Step 2 Write down the IP address of the virtual appliance’s Management port.
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
19
Microsoft Azure Deployments
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.
Note The hostname does not update until you have completed the setup wizard.
Note To use Smart Software Licensing, follow the steps mentioned in “Smart Software Licensing - New User”
section of the Smart Licensing Deployment Guide.
To use Classic Licensing, follow the steps mentioned below.
Note If you cloned the virtual security appliance image, perform the following steps for each image.
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
20
Amazon Web Services (AWS) EC2 Deployments
Procedure
Step 1 Log in to the appliance’s CLI as the admin or ironport user using SSH or telnet in a terminal application.
Note You cannot paste the contents of the license file into the CLI using the vSphere client console.
What to Do Next
For Nutanix deployments:
Return to Deploy on Nutanix, page 15.
For Microsoft Hyper-V deployments:
• Return to Deploy the Virtual Appliance on Nutanix Prism, page 16.
For KVM deployments:
• Return to Deploy on KVM, page 12.
For ESXi deployments:
• For more information on the Management interface’s IP address, see Deploy on VMWare ESXi,
page 17.
• If you cloned the virtual security appliance image, repeat the procedure in this topic for each image.
• See remaining setup steps in Deploy on VMWare ESXi, page 17.
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
21
Manage Your Cisco Secure Virtual Appliance
IP Address
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 interface’s IP address. The CLI displays the Management interface’s
IP address when you run the System Setup Wizard on the virtual appliance.
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
22
Manage Your Cisco Secure Virtual Appliance
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 your AsyncOS release.
Smart Licensing
For detailed information, refer Smart Licensing Deployment Guide.
Classic Licensing
The Cisco Secure virtual appliance requires an additional license to run the virtual appliance on a host.
You can use this license for multiple, cloned virtual appliances. Licenses are hypervisor-independent.
For AsyncOS for Secure Email Gateway 8.5.x and later, and AsyncOS for Secure Email and Web
Manager 8.4 and later:
• Feature keys for individual features can have different expiration dates.
• After the virtual appliance license expires, the appliance will continue to deliver mail (Secure Email
Gateway), or automatically handle quarantined messages (Secure Email and Web Manager) without
security services for 180 days. Security services are not updated during this period. On the Content
Security Management, administrators and end users cannot manage quarantines, but the
management appliance continues to accept quarantined messages from managed Cisco Secure Email
Gateway Appliances, and scheduled deletion of quarantined messages will occur.
• As feature keys are included in the virtual appliance license, there are no evaluation licenses for
AsyncOS features.
Note For information about the impact of reverting the AsyncOS version, see the online help or user guide for
your AsyncOS release.
Related Topics
• Install Cisco Content Security Virtual Appliance License, page 20
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
23
Manage Your Cisco Secure Virtual Appliance
Supported
on Virtual
Command SMA? Information
loadlicense Yes 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.
etherconfig — The Pairing option is not included on virtual appliances.
version — This command will return all the information about the virtual appliance
except for the UDI, RAID, and BMC information.
resetconfig — Running this command leaves the virtual appliance license and the feature
keys on the appliance.
revert — Beginning with AsyncOS 8.5 for Email Security: Behavior is described in
the System Administration chapter in the online help and user guide for
your appliance.
diagnostic Yes The following diagnostic > raid submenu options will not return
information:
1. Run disk verify
2. Monitor tasks in progress
3. Display disk verify verdict
4. Check disk firmware
showlicense Yes View license details.
For Secure Email Virtual Gateway, additional information is available via
the featurekey command.
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
24
Increase RAM in Virtual Machine
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
25
Troubleshoot and Support
Random Failures
Problem Random failures occur that have no obvious cause.
Solution See Important! Prevent Random Failures, page 19
Note To get support for virtual appliances, call Cisco TAC and have your Virtual License Number (VLN)
number ready.
If you file a support case for a Cisco Secure virtual appliance, you must provide your contract number
and your Product Identifier code (PID).
You can identify your PID based on the software licenses running on your virtual appliance, by
referencing your purchase order, or from the following lists:
• Product Identifier Codes (PIDs) for Cisco Secure Email Virtual Gateway, page 26
• Product Identifier Codes (PIDs) for Cisco Secure Email and Web Manager Virtual, page 28
Product Identifier Codes (PIDs) for Cisco Secure Email Virtual Gateway
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
26
Troubleshoot and Support
Subscription SKU
There is only one subscription SKU for Email Security-CSEMAIL-SEC-SUB. The term and payment
option of the subscription applies to all products included in the subscription.
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
27
Troubleshoot and Support
Product Identifier Codes (PIDs) for Cisco Secure Email and Web Manager Virtual
Cisco TAC
Contact information for Cisco TAC, including phone numbers:
http://www.cisco.com/en/US/support/tsd_cisco_worldwide_contacts.html
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
28
Additional Information
Additional Information
For more information, including information about support options, see the Release Notes and User
Guide or online help for your AsyncOS release.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of
Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The
use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any
examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only.
Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
29
Additional Information
Cisco Secure Email Virtual Gateway and Secure Email and Web Manager Virtual Appliance Installation Guide
30