Installing and Configuring the Client
There are two main client applications that you use with Security Manager applications:
•The Security Manager client. This is a client-server application that is installed on your workstation and that interacts with the database running on the Security Manager server, which normally resides on another computer. This client also uses your web browser for some functions.
•A web browser. You use your web browser to use Performance Monitor, AUS, RME, and for configuring the Security Manager server and other servers that use Common Services.
The following topics describe how to configure your web browser to run the clients and how to install the Security Manager client:
•Configuring Web Browser Clients
•Tips for Installing the Security Manager Client
•Installing the Security Manager Client
•Logging In to the Applications
•Uninstalling Security Manager Client
Configuring Web Browser Clients
You must ensure that your web browser is configured to allow certain types of content and not to block popup windows from the server running the applications. The web browser is used for displaying online help as well as functional application windows. The following sections explain the browser settings you must configure so that you can use your browser effectively as an application client:
•Configuring Internet Explorer Settings
•Configuring Firefox Settings
•Enabling and Configuring Exceptions in Third-party Tools
Configuring Internet Explorer Settings
There are several settings that you need to configure in Internet Explorer for Security Manager and its applications to function correctly. Internet Explorer is used to display online help, activity reports, CS-MARS lookup information, and so forth. This procedure explains the settings you need to configure in Internet Explorer.
Step 1 Turn off Pop-up Blocker for Security Manager by performing the following steps:
a. Open Internet Explorer
b. Go to Tools > Pop-up Blocker > Pop-up Blocker Settings
c. In the Address of website to allow field, enter the IP address of your Security Manager server and then click Add.
If you do not turn off Pop-up Blocker, you may not be able to discover devices in Security Manager.
Tip "Pop-up Blocker is a feature in Internet Explorer that lets you limit or block most pop-ups"
Step 2 In Internet Explorer, select Tools > Internet Options. All subsequent steps in this procedure are performed on the Internet Options dialog box.
Step 3 Allow active content by performing the following steps:
a. Click the Advanced tab, scroll to the Security section, and select Allow active content to run in files on My Computer.
b. Click Apply to save your changes.
Step 4 Confirm that the browser security settings enable you to save encrypted pages to disk. If you cannot save encrypted pages, you cannot download the client software installer.
On the Advanced tab, in the Security area, deselect Do not save encrypted Pages to Disk. If you needed to change the setting, click Apply to save your changes.
Step 5 Confirm that the size of the disk cache for temporary files is greater than the size of the client software installer that you expect to download. If the cache allocation is too small, you cannot download the installer. Change the cache size by performing the following steps:
a. Click the General tab.
b. Click Settings in the Temporary Internet Files group.
c. If necessary, increase the amount of disk space to use for temporary Internet files, and click OK.
d. Click Apply to save your changes.
Step 6 (Optional) Some interactions between CS-MARS and Security Manager require the opening of pages that have both secure and nonsecure content. By default, Internet Explorer asks you whether you want to display the nonsecure items. You can click Yes to this prompt and the software will function normally.
If desired, you can change the Internet Explorer settings so that you are not prompted and any page that has mixed content, that is, both secure and nonsecure content, are displayed automatically. Configure Internet Explorer to display mixed content pages by performing the following steps:
a. Click the Security tab.
b. Click Custom Level near the bottom of the dialog box.
c. Under the Miscellaneous heading, select the Enable radio button for the "Display mixed content" setting. (Ensure that you do not select Disable.)
d. Click Apply to save your changes.
Step 7 Click OK to close the Internet Options dialog box.
Configuring Firefox Settings
There are several settings that you need to configure in Firefox for Security Manager and its applications to function correctly. Firefox is used to display some features, such as online help, activity reports, CS-MARS lookup information, and so forth. This procedure explains the options you need to configure in Firefox.
•Editing the Preferences File
•Editing the Size of the Disk Cache
•Disabling the Popup Blocker or Creating a White List
•Displaying Online Help on a New Tab in the Most Recent Window and Reusing Existing Windows on Subsequent Requests
Editing the Preferences File
To edit the preferences file, do the following:
Step 1 From the \Mozilla Firefox\defaults\pref subdirectory, open firefox.js in a text editor, such as Notepad.
Step 2 Add the following:
Step 3 Save, and then close, the edited file.
Editing the Size of the Disk Cache
Confirm that the size of the disk cache for temporary files is greater than the size of the client software installer that you expect to download. If the cache allocation is too small, you cannot download the installer.
To change the cache size, do the following:
Step 1 Select Tools > Options, then click Advanced.
Step 2 Reserve more space for the cache if the setting is too small, then click OK.
Disabling the Popup Blocker or Creating a White List
To disable popup blockers, do the following:
Step 1 Select Tools > Options, then click the Contents icon.
Step 2 Deselect the Block pop-up windows check box.
Alternatively, to create a white list of trustworthy sources from which to accept popups, select the Block pop-up windows check box, then click Exceptions and in the Allowed Sites - Popups dialog box do the following:
a. Enter http://<SERVER_NAME> (where SERVER_NAME is the IP address or DNS-routable name of your Security Manager server) in the Address of web site field, then click Allow.
b. Enter file:///C:/Documents%20and%20Settings/<USER_NAME>/Local%20Settings/
Temp/ (where C: is the client system disk drive on which you installed Windows and USER_NAME is your Windows username on the client system), then click Allow.
c. Click Close.
Step 3 Click OK.
Step 1 Select Tools > Options, then click the Contents icon.
Step 4 Click OK.
Displaying Online Help on a New Tab in the Most Recent Window and Reusing Existing Windows on Subsequent Requests
When you access online help the first time, two new browser windows might be opened: a blank page and a page with help contents. Also, existing browser windows might not be reused during subsequent attempts to access online help.
To configure Firefox to display online help on a new tab in the most recently opened browser window and to reuse existing windows on later occasions, follow these steps:
Step 1 In the address bar, enter about:config and press Enter. The list of user preferences is displayed.
Step 2 Double-click browser.link.open_external and enter 3 in the resulting dialog box. This value denotes that links from an external application are opened in a new tab in the browser window that was last opened.
Step 3 Double-click browser.link.open_newwindow and set it to 1. This value denotes that links are opened in the active tab or window.
Step 4 Double-click browser.link.open_newwindow.restriction and set it to 0. This value causes all new windows to be opened as tabs.
Step 5 Close the about:config page.
Note A blank page might be displayed when you open context-sensitive help, even after the browser status bar displays the status as Done. If this problem occurs, wait for a few minutes to allow the content to be downloaded and displayed.
Enabling and Configuring Exceptions in Third-party Tools
Some third-party popup blockers enable you to allow popups from a specific site or server without allowing popups universally. If your popup blocker does not allow you to configure exceptions to include in a white list, or if that option fails to meet your requirements, you must set your utility to allow all popups. The method for allowing popups from a trusted site varies according to the utility that you use. Please refer to the third-party product's documentation for more information.
Tips for Installing the Security Manager Client
You use the Security Manager client to configure your devices. When you save changes in the client, they are saved to your workstation. You then must submit the changes to the database, which updates the database that resides on the server.
While using the client, there is constant back-and-forth communication between the client and the server. With that in mind, consider the following tips on installing the client to help improve client performance:
•Do not run the client on the same computer as the server as a normal day-to-day operation. If you install the client on the server, use it only for limited troubleshooting purposes.
•Install the client on workstations that are reasonably close to the server to avoid network latency problems. For example, if you have the server installed in the USA, a client running from a network in India might experience poor responsiveness due to the latency introduced. To alleviate this problem, you can employ a remote desktop or terminal server arrangement, where the clients are collocated in the same data center as the server.
•You can install only one copy of the client on a computer. There must be an exact version match between the client and server. Therefore, if you want to run two different versions of the Security Manager product, you must have two separate workstations for running the client.
On the other hand, you can start the client multiple times to connect to different Security Manager servers that are running the same version.
Installing the Security Manager Client
The Security Manager client is a separate program that you install on your workstation. You use the client to log in to the Security Manager server and to configure security policies on your devices. The Security Manager client is the main application that you use with the product.
You might have already installed the client on the Security Manager server when you installed the server software. However, using the client on the same system as the server is not recommended for normal day-to-day usage of the product. Instead, you should install the client on a separate workstation using the following procedure. For information on workstation system requirements and supported browser versions, see Client Requirements, page 2-7.
If you run into problems during installation, see the following topics:
•Handing Security Settings That Prevent Installation
•Unable to Upgrade From a Previous Version of the Client
•Client Problems During Installation, page A-9.
Before You Begin
•Ensure that your browser is configured correctly. See Configuring Web Browser Clients.
•We recommend that you manually delete the Temp files on your client system before you download the client software installer. Deleting such files increases the chances that you have enough available space.
•If it is installed, the Cisco Security Agent needs to be disabled, either before or during the process of installing the client. If the client installer cannot disable the Cisco Security Agent during the installation process, the process aborts and you are prompted to manually disable it before restarting the client installation.
•If you already have the Security Manager client installed on the workstation, the installation program must first uninstall it before installing the updated client. The wizard will prompt you if this is necessary.
Step 1 Log in to the client workstation using a user account that has Windows administrator privileges.
Step 2 In your web browser, open one of these URLs, where SecManServer is the name of the computer where Security Manager is installed. Click Yes on any Security Alert windows.
•If you are not using SSL, open http://SecManServer:1741
•If you are using SSL, open https://SecManServer:443
Step 3 Log in to the Cisco Security Management Suite server with your username and password. When you initially install the server, you can log in using the username admin and the password defined during product installation.
Step 4 On the Cisco Security Management Suite home page, click Cisco Security Manager Client Installer.
You are prompted to either open or run the file or to save it to disk. You can choose either option. If you choose to save it to disk, run the program after downloading it (double-click the file or select the Run option if your browser prompts you).
Tip If you get any security warnings about the application, such as "a problem was detected" or "the publisher cannot be verified" or that an unidentified application wants access to your computer, ensure that you allow the access. You might need to click more than one button, and the button names vary based on the application prompting you (such as Allow, Yes, Apply, and so forth).
Step 5 Follow the installation wizard instructions. During installation, you are asked for the following information:
•Server name—The DNS name or IP address of the server on which the Security Manager server software is installed. Normally, this is the server from which you downloaded the client installer.
•Protocol—HTTPS or HTTP. Select the protocol the Security Manager server is configured to use. Typically, the server is configured to use HTTPS. Ask your system administrator if you are not sure which to select. Also, if you know that the server is configured to use a non-default port, configure the port after installation using the information in Configuring a Non-Default HTTP or HTTPS Port.
•Shortcuts—Whether to create shortcuts for just yourself, for all user accounts that log in to this workstation, or for no users. This determines who will see Cisco Security Manager Client in the Start menu. You can start the client from Start > Programs > Cisco Security Manager Client > Cisco Security Manager Client or from the icon on the desktop.
•Installation location—The folder in which you want to install the client. Accept the default unless you have a compelling reason to install it elsewhere. The default location is C:\Program Files\Cisco Systems.
Step 6 After you click Finish to complete the installation, if you disabled an antivirus application temporarily, re-enable it.
If the Cisco Security Agent was stopped by the client installer, it is restarted at the end of the installation. However, if you manually disabled the Cisco Security Agent on your system, you must enable it after client installation is complete.
Handing Security Settings That Prevent Installation
There are many different ways you can configure security settings on your workstation, and many different products that you can install, that might prevent you from installing the Security Manager client. If you run into problems during installation, first ensure that your Windows user account has the administrative privileges required for installing software, then consider the following tips:
•(Windows 2003 or Windows XP) Internet Explorer Enhanced Security default settings might stop you from downloading the installation utility from your server. In this case, the following message appears:
Internet Explorer cannot download CSMClientSetup.exe from <server>
. Internet Explorer was not able to open this Internet site. The requested site is either unavailable or cannot be found. Please try again later.
To work around this problem, select Start > Settings > Control Panel > Add or Remove Programs, then click Add/Remove Windows Components. From the Windows Component Wizard window, deselect the Internet Explorer Enhanced Security Configuration check box, click Next, and then click Finish.
•(Windows Vista) The system displays the User Account Control popup window to indicate that an unidentified program wants access to your computer. This occurs because of a limitation in the InstallAnywhere software. This one-time popup displays only when installing the client software. Select Allow to continue.
•(Windows XP SP2 and Vista) Increased security features might cause the following message to be displayed:
Security Warning Message. The publisher could not be verified. Are you sure you want to run this software?
When you see this message, click Yes to continue.
•(Windows Vista) When you download the client software from your server, a File Download - Security Warning dialog box appears and asks, "Do you want to run or save this file?" Click Save to continue.
Configuring a Non-Default HTTP or HTTPS Port
The Security Manager server uses these default ports: HTTPS is 443; HTTP is 1741. If your organization installed the Security Manager server to use a different port, you need to configure the client to use the non-standard port. Otherwise, the client cannot connect to the server.
To configure different ports for your client, edit the C:\Program Files\Cisco Systems\Cisco Security Manager Client\jars\client.info file using a text editor such as NotePad. Add the following settings and specify the custom port number in place of <port number>:
These settings are used the next time you start the client.
Unable to Upgrade From a Previous Version of the Client
When you attempt to install the Security Manager client when you already have an older client installed, or when you used to have a client installed on the workstation, the client installer first uninstalls the previous version before installing the new one. If you receive the error message "Could not find main class. Program will exit," the installer cannot install the client.
This problem occurs because of the presence of old registry entries in your system. To correct this problem, do the following:
Step 1 Start the Registry Editor by selecting Start > Run and entering regedit.
Step 2 Remove the following registry key:
Step 3 Delete the previous installation directory, usually C:\Program Files\Cisco Systems\Cisco Security Manager Client.
Step 4 Rename the following folder:
C:\Program Files\Common Files\InstallShield\Universal\common\Gen1
Step 5 Select Start > Control Panel > Add or Remove Programs. If the Cisco Security Manager Client is still listed, click Remove. If you receive the message, "Program already removed; do you want to remove it from the list?", click Yes.
If you still cannot re-install the Security Manager client, rename the C:\Program Files\Common Files\InstallShield directory, then try again. Also see Client Problems During Installation, page A-9.
Patching a Client
After you apply a service pack or a point patch to your Security Manager server, the Security Manager client prompts you to apply an update when you log in to the server. The version number of the client software must be the same as the version number of the server software.
When you are prompted to download and apply a required software update, your web browser is used to download the update. You are prompted to either open or run the file, or to save it to disk. You can choose either option. If you choose to save it to disk, run the program after downloading it (double-click the file or select the Run option if your browser prompts you).
Installation of the patch is similar to installation of the client, and you must allow (or click Yes) to any security alerts from Cisco Security Agent or other security software you have installed to allow the installer to run.
When prompted for installation location, ensure that you select the folder in which you installed the client, and select Yes to All if you are asked if you want to overwrite files.
Tip If you get an error message that says that the URL cannot be retrieved or that the connection timed out, you need to uninstall the Security Manager client, then install a fresh copy (which will already have the patch applied). For more information, see Uninstalling Security Manager Client and Installing the Security Manager Client.
Logging In to the Applications
After you have installed the server applications, configured your web browser, and installed the Security Manager client, you can log in to the applications:
•Logging In to Security Manager Using the Security Manager Client
•Logging In to Server Applications Using a Web Browser
Logging In to Security Manager Using the Security Manager Client
Use the Security Manager client to perform most Security Manager tasks.
Tip You must log into the workstation using a Windows user account that has Administrator privileges to fully use the Security Manager client. If you try to operate the client with lesser privileges, you might find that some features do not work correctly.
Step 1 Select Start > Programs > Cisco Security Manager Client > Cisco Security Manager Client to start the client.
Step 2 In the Security Manager login window, enter or select the DNS name or IP address of the server to which you want to log in, and enter your Security Manager username and password. If the server uses HTTPS for connections, ensure that the check box is selected; otherwise, deselect it. Click Login.
The client logs in to the server and opens the client interface. If the server prompts you to download and install a client software update, see Patching a Client.
Tip The client closes if it is idle for 120 minutes. To change the idle timeout, select Tools > Security Manager Administration, select Customize Desktop from the table of contents, and enter the desired timeout period. You can also disable the feature so that the client does not close automatically.
Step 3 To exit Security Manager, select File > Exit.
Logging In to Server Applications Using a Web Browser
Only the Security Manager server uses a regular Windows application client for hosting the client application. All other applications, including the server administration features of Security Manager (through the Common Services application), CiscoWorks, Auto Update Server, Performance Monitor, and RME, are hosted in your web browser.
Logging in to these applications is identical. If you install more than one application on a single server, you log in to all installed applications at the same time. This is because the login is controlled by CiscoWorks, and all these applications are hosted under the CiscoWorks umbrella.
Step 1 In your web browser, open one of these URLs, where server is the name of the computer where you installed any of the server applications. Click Yes on any Security Alert windows.
•If you are not using SSL, open http://server:1741.
•If you are using SSL, open https://server:443.
Step 2 Log in to the Cisco Security Management Suite server with your username and password. When you initially install the server, you can log in using the username admin and the password defined during product installation.
Step 3 On the Cisco Security Management Suite home page, you can access the features installed on the server. The home page can contain different items based on what you installed.
•Click the panel for the application that you want to run, such as Auto Update Server, Performance Monitor, or Resource Manager Essentials.
•Click the Server Administration panel to open the CiscoWorks Common Services Server menu. You can click this link to get to any place within Common Services. CiscoWorks Common Services is the foundation software that manages the server. Use it to configure and manage back-end server features such as server maintenance and troubleshooting, local user definition, and so on.
•Click the CiscoWorks link (in the upper right of the page) to open the CiscoWorks home page on the server.
•Click the Cisco Security Manager Client Installer to install the Security Manager client. The client is the main interface for using the Security Manager server.
Step 4 To exit the application, click Logout in the upper right corner of the screen. If you have both the home page and the Security Manager client open at the same time, exiting the browser connection does not exit the Security Manager client.
Uninstalling Security Manager Client
If you want to uninstall the Security Manager client, select Start > Programs > Cisco Security Manager Client > Uninstall Cisco Security Manager Client and follow the uninstallation wizard prompts.
If you are uninstalling the client from the Security Manager server, you can also uninstall the client using the server uninstaller.