Table Of Contents
Cisco Security Agent Installation and Overview
Overview
Downloading and Installing
The Cisco Security Agent User Interface
Uninstall Windows Cisco Security Agent
Installing the Solaris Agent
Uninstalling Solaris Agent
Installing the Linux Agent
Uninstalling Linux Agent
Cisco Security Agent Installation and Overview
Overview
This chapter describes the Cisco Security Agent and provides information on the agent user interface. It also includes installation information for Windows, Linux, and Solaris agents. (This information, with additional details, also appears in a similarly titled Appendix A in the User Guide.)
Once the agent is installed, there is no configuration necessary on the part of the end user in order to run the agent software. Optionally, as the administrator, you can ask users to enter individualized contact information into the fields provided. If required, the agent user interface makes it easy for the user to enter this data and send it to CSA MC.
This section contains the following topics.
•
Downloading and Installing
•
The Cisco Security Agent User Interface
•
Installing the Solaris Agent
•
Installing the Linux Agent
Downloading and Installing
Once you build an agent kit on CSA MC, you deliver the generated URL, via email for example, to end users so that they can download and install the Cisco Security Agent. They access the URL to download and then install the kit. This is the recommended method of agent kit distribution. But you may also point users to a URL for the CSA MC system. This URL will allow them to see all kits that are available. That URL is:
https://<system name>/csamc60/kits
If you are pointing users to the "kits" URL and you have multiple agent kits listed here, be sure to tell users which kits to download.
Note
Note that the Registration Control feature also applies to the <system name>/csamc60/kits URL. If the Registration Control feature (see the User Guide for details on the feature) prevents your IP address from registering, it also prevents you from viewing the agent kits URL.
Note
Cisco Security Agent systems must be able to communicate with the Management Center for Cisco Security Agents over HTTPS.
Once users install agents on their systems, they can optionally perform a reboot (if Force reboot is not selected). See Figure A-1. Whether a system is rebooted or not, the agent service starts immediately and the system is protected.
Figure A-1 Optional Agent Reboot
If a system is not rebooted following the agent installation, the following functionality is not immediately available. (This functionality becomes available the next time the system is rebooted.)
Windows agents
•
Network Shield rules are not applied until the system is rebooted.
•
Network access control rules only apply to new socket connections. Network server services should be stopped and restarted for full network access control security without a system reboot.
•
Data access control rules are not applied until the web server service is restarted.
Solaris and Linux agents, when no reboot occurs after install, the following caveats exist
•
Network access control rules only apply to new socket connections. Network server services should be stopped and restarted for full network access control security without a system reboot.
•
Buffer overflow protection is only enforced for new processes.
•
File access control rules only apply to newly opened files.
•
Data access control rules are not applied until the web server service is restarted.
After installation, the agent automatically and transparently registers with CSA MC. To see which hosts have successfully registered, switch to Advanced Mode, from the Systems menu select Hosts. This displays the hosts list view. All registered host system names appear here.
The Cisco Security Agent User Interface
Note
The Cisco Security Agent user interface does not run on Solaris systems.
Note
If the Agent UI control rule is not present (available on Windows and Linux only) for the system group, no agent UI appears on the end user system.
To open the Cisco Security Agent user interface on Windows and Linux systems, users can double-click on the flag icon in their system trays. The user interface opens on their desktop.
As the administrator, you decide which agent UI options to provide to the end user. These options are controlled by the Agent UI control rule. Available options are as follows:
•
Allow user to reset agent UI default settings—Selecting this checkbox in the Agent UI control rule causes the end user to have a product reset option available from the Start>Programs>Cisco>Cisco Security Agent menu. Selecting the "Reset Cisco Security Agent" option puts all agent settings back to their original states and clears almost all other user-configured settings. This does not clear configured Firewall Settings or File Protection settings. But if these features are enabled, they are disabled as this is the default factory setting. The information entered into the edit boxes for these features is not lost.
•
Allow user interaction—Selecting this checkbox in the Agent UI control rule causes the end user to have a visible and accessible agent UI, including a red flag in the system tray.
•
Allow user access to agent configuration and contact information— Selecting this checkbox in the Agent UI control rule provides Status, Messages, and Contact Information features, including the ability to manually poll the MC.
•
Allow user to modify agent security settings—Selecting this checkbox in the Agent UI control rule provides System Security and Untrusted Applications features.
•
Allow user to modify agent personal firewall settings—Selecting this checkbox in the Agent UI control rule provides Local Firewall Settings and File Protection features.
The options available to the user in the agent UI depend upon the features selected in the Agent UI control rule governing the agent in question. All possible agent features are described in Appendix A of the User Guide.
Uninstall Windows Cisco Security Agent
To uninstall the Cisco Security Agent, do the following:
From the Start menu, go to Programs>Cisco>Cisco Security Agent>Uninstall Cisco Security Agent. Reboot the system when the uninstall is finished.
Note
You can also uninstall the agent from the Start>Settings>Control Panel> Add/Remove Programs dialog.
Installing the Solaris Agent
This section details the commands you enter and the subsequent output that is displayed when you install the Cisco Security Agent on Solaris systems. After you download the agent kit from CSA MC, do the following to unpack and install it. (Note that you can put the downloaded tar file in any temp directory. Do not put it in the opt directory; however, as you may then experience problems with the installation.)
Note
See also UNIX Agent csactl Utility in Appendix A of Using Management Center for Cisco Security Agents for information on a Solaris agent utility which allows you to manually poll to CSA MC and perform other tasks.
Step 1
You must be super user on the system to install the agent package.
Step 2
Untar the agent kit. (In the following example, CSA-Server_6.0.1.100-setup.tar is the name of the agent kit.)
# tar xf CSA-Server_6.0.1.100-setup.tar
Step 3
Install the agent package. (Use the command listed below when you install. This command forces the installation to use a package administration file to check the system for the required OS software agent dependencies. If the required dependencies are not present, such as the "SUNWlibCx" library, the install aborts.)
# pkgadd -a CSCOcsa/reloc/cfg/admin -d . CSCOcsa
When the install is complete, the following is displayed:
The agent installed cleanly, but has not yet been started. The
command: /etc/init.d/ciscosec start will start the agent. The agent
will also start automatically upon reboot. A reboot is recommended to
ensure complete system protection.
Step 4
Optionally, reboot the system by entering the following.
Note
If the Solaris system is not rebooted following the agent installation, the following functionality is not immediately available: Buffer overflow protection is only enforced for new processes, network access control rules only apply to new socket connections, file access control rules only apply to newly opened files, and data access control rules are not applied until the web server service is restarted. (This functionality becomes available the next time the system is rebooted.)
Note
On Solaris 10, when you reboot the system after upgrading the agent, the system will perform the reboot once, display these messages, and reboot, automatically, again.
svc.startd[7]:system/csaservice : default failed: transitioned to maintenance (see 'svcs -xv for more details')
svc.startd[7]:system/webconsole :console failed: transitioned to maintenance (see 'svcs -xv for more details')
After second reboot, you will not receive any other messages and regarding CSA and CSA will be fully functional.
The agent installs into the following directory:
Some files are put into additional directories such as
/kernel/strmod/sparcv9, usr/lib/csa, /etc/init.d and /etc/rc?.d.
Note
If you are upgrading the Solaris agent and you encounter the following error, "There is already an instance of the package and you cannot install due to administrator rules", you must edit the file /var/sadm/install/admin/default. Change "instance=unique" to "instance=overwrite" and then proceed with the upgrade.
Note
See also Manual Agent Data Filter Installation, in chapter 12 of Using Management Center for Cisco Security Agents, if you are installing a web server on the same server as the Solaris agent.
Uninstalling Solaris Agent
When uninstalling the Solaris Agent you must be in a session which has permission to disable CSA. The Agent Service Control rules in the Base - CSA service control (Solaris) rule module provided with this release, define the sessions given permission to disable CSA.
While running the default Base - CSA service control (Solaris) rule module, booting directly into multi-user mode using the Command Line Login option or booting directly into single-user mode gives you the permission to uninstall CSA.
Note
When running Solaris 10, if you boot into multi-user mode and then switch to single-user mode, you do not have permission to disable CSA.
To uninstall CSA:
Step 1
Boot directly into multi-user mode using the Command Line Login option or boot directly into single-user mode.
Step 2
Login as the root user.
Step 3
At the prompt, enter the following command:
# pkgrm CSCOcsa
Step 4
Reboot the machine.
Note
If an agent is running a policy which contains an Agent self protection rule, the agent cannot be uninstalled unless your session has the permission to disable it. (Administrators can generally do this through a remote management session if the default policies applied to the CSA MC/VMS system are not changed to restrict this access.)
A shipped UNIX policy allows secured management applications to stop the agent service. For example, after having logged in by selecting Command Line Login in the options menu of the login screen, all login applications are considered secure management applications. You can now run the pkgrm command to uninstall the agent.
Installing the Linux Agent
This section details the commands you enter and the subsequent output that is displayed when you install the Cisco Security Agent on Linux systems.
Step 1
Move the tar file downloaded from CSA MC to a temporary directory, for example:
$ mv CSA-Server_V5.2.0.218-lin-setup-1a969c667ddb0a2d2a8da3e7959a30b2.tar /tmp
Step 2
Untar the file, for example:
$ tar xvf CSA-Server_V5.2.0.218-lin-setup-1a969c667ddb0a2d2a8da3e7959a30b2.tar
Step 3
Connect to the CSCOcsa directory where the rpm package is located, for example:
Step 4
Run script install_rpm.sh as root, for example:
The package will be installed to /opt/CSCOcsa, with some files being put into directories such as /lib/modules/CSCOcsa, /lib/csa, /etc/init.d and /etc/rc?.d.
As the installation proceeds, you receive these messages:
If you wish to install the CSA data filters Apache 2.0, you will need to run the install script by hand:
cd /opt/CSCOcsa/app_plugins/apache
./i.csafilter install
Warnings about non-GPL modules are to be expected and can be ignored The Agent UI may have to be added to customized Gnome/KDE session files manually (gnome-session-properties for GNOME). To do this, add /opt/CSCOcsa/bin/ciscosecui to the startup programs list.
If this system is running a web server, the csa service module must be installed. Execute /opt/CSCOcsa/app_plugins/apache/i.csafilter to copy the module and modify the httpd configuration appropriately. The web server will be restarted automatically.
For more information about installing data filters, see "Manual Agent Data Filter Installation" in chapter 12 of Using Management Center for Cisco Security Agents.
Step 5
After a successful installation, you receive the message "The installation has completed successfully. For Full protection to be enabled, it is recommended that the machine be rebooted."
Step 6
Reboot the host after the installation is complete.
Note
CSAagent rpm packages are not relocatable.
Caution 
If a system is not rebooted following the agent installation, the following functionality is not immediately available: Buffer overflow protection is only enforced for new processes, network access control rules only apply to new socket connections, file access control rules only apply to newly opened files, and data access control rules are not applied until the web server service is restarted. (This functionality becomes available the next time the system is rebooted.)

Note
Linux Agent UI: For gnome desktop environments, the install script will only modify the default session config file for launching the agent UI automatically every time a user starts a gnome desktop session. But if a user already has their own session file ( ~/.gnome2/session ), the default session file (/usr/share/gnome/default.session) will not be effective. Therefore, the agent UI will not automatically start when the user logs in. In such a case, the user must add the agent UI (/opt/CSCOcsa/bin/ciscosecui) manually (using "gnome-session-properties" utility) to make the agent UI auto-start.
Caution 
On Linux systems, if you upgrade the kernel version or boot a different kernel version than the initial version where the agent was installed, you must uninstall and reinstall the agent.
Uninstalling Linux Agent
You can uninstall Linux agents from the command line or by using the GUI.
Uninstalling Cisco Security Agent from a command line
Step 1
Log on to the host as the root user.
Step 2
CD to the directory: /opt/CSCOcsa/bin
Step 3
At the prompt enter: ./uininstall
Step 4
When warned that CSA is being disabled, select Yes to allow the action, type an explanation in the "Please Explain" field and then click Apply.
Step 5
When you have successfully uninstalled CSA, you receive the message, "Cisco Security Agent has been uninstalled. Press Enter to exit...." Press Enter.
Step 6
Restart the computer.
Uninstalling Cisco Security Agent using the GUI
Step 1
Log on to the host as the root user.
Step 2
From the Applications menu, select Cisco Security Agent > Uninstall Cisco Security Agent.
Step 3
When warned that CSA is being disabled, select Yes to allow the action, type an explanation in the "Please Explain" field and then click Apply.
Step 4
When you have successfully uninstalled CSA, you receive this message in a terminal window: "Cisco Security Agent has been uninstalled. Press Enter to exit...." Press Enter.
Step 5
Restart the computer.
Caution 
If an agent is running a policy which contains an Agent self protection rule, the agent cannot be uninstalled unless this rule is disabled. (Administrators can generally do this through a remote management session if the default policies applied to the CSA MC system are not changed to restrict this access.) See
Agent self protection in the User Guide for details on this rule type.
You can uninstall the linux agent regardless of policies if you login using single user mode.