User Guide for CiscoWorks Common Services 3.1.1 - Chapter 2 Interacting With CiscoWorks Home Page [CiscoWorks Common Services Software]

Table Of Contents

Interacting With CiscoWorks Home Page

Invoking CiscoWorks LMS Portal Home Page

Invoking CiscoWorks Home Page

Invoking CiscoWorks Home Page in Normal Mode

Invoking CiscoWorks Home Page in SSL Enabled Mode

Logging Into CiscoWorks

CiscoWorks Home Page Layout

Navigation Tools

Supported Browser Versions

Using Online Help

Changing Web Server Port Numbers

Changing Web Server Port Numbers on Solaris

Changing Web Server Port Number on Windows

Interacting With CiscoWorks Home Page

CiscoWorks home page provides launch points and top level navigation for CiscoWorks applications and their major functions installed on the CiscoWorks Server or a remote server. It also provides launch points for all Common Services features such as Home, Server, Software Center, Device and Credentials, and Groups.

You can access CiscoWorks resources, Cisco.com resources, Third Party tools, Custom Tools, CiscoWorks product updates, and urgent messages from the CiscoWorks home page.

CiscoWorks home page also provides launch points for applications installed on the same server or a remote server, and their major functions and for other web-based products (Non-CiscoWorks products and third-party or in-house tools) residing on the same or on a different server.

After you install the applications, you can see the application panels on CiscoWorks home page. CiscoWorks home page requires a single login for all products installed on the same server. Cisco Products installed on other servers, Third Party Applications, and Custom Tools should be registered using the Application Registration and Links Registration features under home page.

CiscoWorks home page supports application oriented and device oriented navigation paradigms. When you select any of the application functions on CiscoWorks home page, it launches the application
home page, and the selected function is launched in application home page content area.

CiscoWorks home page is completely based on HTML, and provides intuitive navigation for you to move between CiscoWorks home page, and all other application home pages.

This chapter contains:

•Invoking CiscoWorks LMS Portal Home Page

•Invoking CiscoWorks Home Page

•CiscoWorks Home Page Layout

•Configuring CiscoWorks Home Page

•Setting Up CiscoWorks Home Page

•Registering Applications With CiscoWorks Home Page

•Registering Links With CiscoWorks Home Page

•Using CiscoWorks Server Hostname Change Scripts

Invoking CiscoWorks LMS Portal Home Page

CiscoWorks LMS Portal serves as a home page for Common Services and other applications of LMS bundle when you perform fresh installation or upgrade installation of Common Services from the
LMS 3.0 DVD.

See the following documents for installation prerequisities and instructions:

•Installing and Getting Started with CiscoWorks LAN Management Solution 3.0

•Readme for CiscoWorks LAN Management Solution 3.0 December 2007 Update on Solaris

•Readme for CiscoWorks LAN Management Solution 3.0 December 2007 Update on Windows

See User Guide for CiscoWorks LMS Portal 1.0.1 to know more about the LMS Portal home page.

The classic CiscoWorks home page is the default home page of CiscoWorks applications if Common Services is installed from a source other than LMS 3.0 Product DVD.

Note This document explains how to invoke and configure the classic CiscoWorks home page.

Invoking CiscoWorks Home Page

You can invoke CiscoWorks home page using the following browsers:

•Microsoft Internet Explorer 6.0

•Microsoft Internet Explorer 7.0

•Mozilla Firefox 2.0

See Supported Browser Versions for more information on browser-specific features, options and the limitations.

You may invoke CiscoWorks home page by either:

•Invoking CiscoWorks Home Page in Normal Mode

or

•Invoking CiscoWorks Home Page in SSL Enabled Mode

Invoking CiscoWorks Home Page in Normal Mode

To invoke CiscoWorks home page in the normal mode (HTTP), enter the URL for your CiscoWorks Server in your web browser:

http://server_name:port_number

where server name is the name or IP Address of the CiscoWorks Server and port number is the TCP port used by the CiscoWorks Server, in the normal mode.

If you have installed LMS Portal in the CiscoWorks Server, the URL http://server_name:port_number will invoke the LMS Portal application instead of CiscoWorks home page. See User Guide for CiscoWorks LMS Portal 1.0.1 for more information.

In normal mode (HTTP), the default TCP port for CiscoWorks Server is 1741.

•On Windows, the CiscoWorks Server always uses the default port numbers in normal modes.

•On Solaris, if the default TCP port (1741) is used by other applications, you can select different ports during CiscoWorks Server installation.

For more information, see the following documents:

–Installing and Getting Started with CiscoWorks LAN Management Solution 3.0

–Readme for CiscoWorks LAN Management Solution 3.0 December 2007 Update on Solaris

–Readme for CiscoWorks LAN Management Solution 3.0 December 2007 Update on Windows

You can also use the changeport utility to change the web server port numbers. See Changing Web Server Port Numbers for more information.

When you invoke the CiscoWorks home page in normal mode, the browser you use displays a security alert, as the login pages always open in SSL mode, irrespective of the Browser-Server security mode.

You should click Yes in the Security Alert dialogs to get to the Login panel.

Invoking CiscoWorks Home Page in SSL Enabled Mode

To invoke CiscoWorks home page in the SSL enabled mode (HTTPS), enter the URL for your CiscoWorks Server in your browser.

https://server_name:port_number

where server name is the name or IP Address of the CiscoWorks Server and port number is the TCP port used by the CiscoWorks Server, when SSL is enabled (secure mode).

When SSL is enabled (HTTPS), the default TCP port for CiscoWorks Server is 443.

•On Windows, CiscoWorks Server always uses the default port numbers in secure mode.

•On Solaris, if the default TCP port (443) is used by other applications, you can select different ports during CiscoWorks Server installation.

For more information, see the following documents:

–Installing and Getting Started with CiscoWorks LAN Management Solution 3.0

–Readme for CiscoWorks LAN Management Solution 3.0 December 2007 Update on Solaris

–Readme for CiscoWorks LAN Management Solution 3.0 December 2007 Update on Windows

You can also use the changeport utility to change the web server port numbers. See Changing Web Server Port Numbers for more information.

When you invoke the CiscoWorks home page in secure mode, the browser you use displays a security alert while invoking CiscoWorks home page in SSL mode.

If Common Services is running in a Plug-in environment, it displays Plug-in alert dialogs. (For example, Server Certificate details, Hostname Mismatch details). You should click Yes in the Plug-in alert dialogs to get to the Login panel.

This section explains the following:

•Invoking CiscoWorks Home Page in SSL Enabled Mode in Microsoft Internet Explorer 6.0

•Invoking CiscoWorks Home Page in SSL Enabled Mode in Microsoft Internet Explorer 7.0

•Invoking CiscoWorks Home Page in SSL Enabled Mode in Mozilla Firefox 2.0

•Reducing the Number of Dialog Boxes While Invoking CiscoWorks Home Page in SSL Enabled Mode

•Additional Notes On Invoking CiscoWorks Home Page

Invoking CiscoWorks Home Page in SSL Enabled Mode in Microsoft Internet Explorer 6.0

When you invoke CiscoWorks home page using the Microsoft Internet Explorer 6.0 browser in secure mode, the browser displays a Security Alert window indicating that you are about to view web pages over a secure connection.

To load CiscoWorks home page:

Step 1 Click OK in the Security Alert window.

The Security Alert window displays the security certificate alert.

Step 2 Click Yes in the Security Alert window.

In the New Site Certificate wizard, you can accept the certificate for the current session or accept it till the certificate expires. To avoid going through the New Site Certificate wizard whenever you invoke CiscoWorks home page, you may accept the certificate till it expires.

Invoking CiscoWorks Home Page in SSL Enabled Mode in Microsoft Internet Explorer 7.0

If you use Microsoft Internet Explorer 7.0 to invoke the home page in secure mode, you are directed to a security alert web page.

You should click Continue to this website in the security alert page to load CiscoWorks home page.

Invoking CiscoWorks Home Page in SSL Enabled Mode in Mozilla Firefox 2.0

When you invoke CiscoWorks home page in Mozilla Firefox 2.0, the browser displays a security alert page.

Select Accept this certificate temporarily for this session to accept the certificate for the current session. To avoid going through this security alert page whenever you invoke CiscoWorks home page, you may accept the certificate till it expires.

Reducing the Number of Dialog Boxes While Invoking CiscoWorks Home Page in SSL Enabled Mode

To reduce the number of dialog boxes (security alerts) that appear while invoking CiscoWorks home page in secure mode, you can:

•Configure the hostname in your server certificate properly and use the same hostname to invoke CiscoWorks.

•Use a server certificate issued by a prominent third-party certificate authority.

•If you are using Self-Signed certificates:

–In Mozilla Firefox, select Accept the Server Certificate forever (until it expires) in the New Site Certificate wizard, if you are confident about the identity of the server.

–In Internet Explorer, install the certificate in the browser's trusted certificate stores, if you are confident about the identity of the server.

To install the certificate in Internet Explorer 6.0:

Step 1 Invoke CiscoWorks in secure mode.

Step 2 Click the View Certificate button in the security alert window that appears.

The Certificate dialog box appears.

Step 3 Click Install Certificate... in the Certificate dialog box.

The Certificate Import wizard appears which guides you to import the certificates.

To install the certificate in Internet Explorer 7.0:

Step 1 Click Tools > Internet Options.

Step 2 Click the Content tab.

Step 3 Click Certificates.

The Certificate dialog box appears.

Step 4 Click Import... in the Certificate dialog box.

The Certificate Import wizard appears which guides you to import the certificates.

Additional Notes On Invoking CiscoWorks Home Page

Read the following notes before you invoke CiscoWorks home page in secure mode:

•If you have installed LMS Portal in the CiscoWorks Server, the URL https://server_name:port_number will invoke the LMS Portal application instead of CiscoWorks home page. See User Guide for CiscoWorks LMS Portal 1.0.1 for more information.

•If the server is in SSL mode and if you invoke Common Services as http://server_name:1741, you will be redirected to HTTPS mode.

Logging Into CiscoWorks

If you have installed CiscoWorks Server and logging in for the first time, use the reserved admin user name and password.

To log in:

Step 1 Enter admin in the User ID field, and the password for admin in the Password field of the Login Page.

The CiscoWorks Server Administrator can set the passwords to admin and guest users during installation. Contact the CiscoWorks Server Administrator if you do not know the password.

Step 2 Click Login or press Enter.

You are now logged into CiscoWorks Server.

Step 3 Launch the Common Services application and select Server > Security > Single-Server Management > Local User Setup to:

•Set up policies for local users.

•Modify your (the administrator's) profile and change the admin password using the Common Services application.

•Add, edit, and delete local users.

For more information, see Online Help.

Login sessions time out after two hours of inactivity. If the session is not used for two hours, you will be prompted to login again.

The Login screen replaces the current page of the current browser window when session times out. After you log in, the page you were on before re-logging in, appears.

If you have installed CiscoWorks LMS Portal in your CiscoWorks Server, the session gets activated for every refresh.

CiscoWorks Home Page Layout

CiscoWorks home page is the primary user interface and the launch point for all features. After you log into CiscoWorks, the default CiscoWorks home page appears.

CiscoWorks home page and the application windows launched from CiscoWorks home page contains the CiscoWorks Server name along with the browser title. See Setting Up CiscoWorks Home Page for more information.

Note If you have installed the LMS Portal application, the LMS Portal home page is your primary user interface. See Invoking CiscoWorks LMS Portal Home Page for more information.

The CiscoWorks home page window consists of:

•Common Services Panel

•Application Panels

•Device Diagnostic Tools Panel

•Setup Center Panel

•Resources Panel

•CiscoWorks Product Updates Panel

•Tool Bar Items

Common Services Panel

The Common Services Panel displays all Common Services functions. The Common Services panel appears in a tree window.

First level items displayed in the tree window are:

•Home

•Server

•Software Center

•Device and Credentials

•Groups

Note The HomePage item, which was the first level item in the tree window of Common Services Panel in the earlier versions of Common Services, is now renamed as Home Page Admin and moved as a sub item under Server item.

Application Panels

Each Application Panel in the CiscoWorks home page serves as a top-level launch point for all Common Services applications installed on local or remote server.

All the applications installed appear in the CiscoWorks home page in three columns.

By default, only the first level items are displayed when you login. These first level items are in collapsed mode. Lower level navigations are displayed only if you manually expand a first level item.

The title of each application panel displays the application name and it serves as a link to the relevant application home page. Application tasks are displayed in a hierarchical manner. When you select a task from the hierarchy, it launches the application home page in a new window.

If the corresponding application home page already exists for some other task, the window for this task is focussed, instead of creating a new window.

To launch the URL associated with the item in the popup window, click on the label.

CiscoWorks applications from other servers can be made to display in the same way as CiscoWorks applications from the local server.

To do this, you should import registration details of CiscoWorks applications installed on other servers. This allows you to navigate various CiscoWorks applications from same or different bundles (such as LMS), from a single home page. See Importing From Other Servers for information on importing from other servers.

You should authenticate yourself before using applications from other server (once for each server, for each session), even if you are authenticated on the local server.

For details on transparently navigating through multiple CiscoWorks Servers, see Enabling Single Sign-On.

Device Diagnostic Tools Panel

The Device Diagnostic Tools panel provides a launch point to the Device Center.

If you have installed CiscoWorks Assistant in your CiscoWorks Server, this panel also provides a launch point for Device Troubleshooting workflow.

For more information, see Using Device Center.

Setup Center Panel

The Setup Center panel provides a launch point to LMS Setup Center where you can configure the system settings for all applications in one stop. The Setup Center is part of LAN Management Solution bundle.

If you have installed CiscoWorks Assistant in your CiscoWorks Server, this panel also provides a launch point for Server Setup workflow.

For more information, see Using LMS Setup Center.

Resources Panel

The Resources panel is at the top right of the CiscoWorks home page. It also serves as a top-level launch point for CiscoWorks resources, Cisco.com resources, third party application links, and web based custom tool links. This panel shows the types of resources as first level and details in the next level.

CiscoWorks home page provides an option to turn off this panel if you do not want this information to be displayed in CiscoWorks home page or if the CiscoWorks Server is behind a firewall. To hide the Resources panel, see Setting Up CiscoWorks Home Page.

CiscoWorks Product Updates Panel

The Product Updates panel is at the right of the page. It displays informative messages about CiscoWorks product announcements, and help related topics.

If you click the More Updates link, a popup window appears with all the Cisco Product Update details.

If the CiscoWorks Server is behind a firewall, the proxy settings are used to download messages from Cisco.com. CiscoWorks home page provides an Admin UI to accept the proxy settings.

The Product Updates panel alerts you if any urgent messages are generated. By default, the polling interval is one minute. You can change this polling interval.

CiscoWorks home page provides an option to turn off this panel if you do not want this information to be displayed in CiscoWorks home page.

See Setting Up CiscoWorks Home Page for information on changing the polling interval and hiding the Product Updates panel.

Tool Bar Items

The tool bar buttons are at the top right of the CiscoWorks home page. The buttons are:

•Logout—Returns the browser to the Login dialog box.

•Help—Displays the help contents or application-specific help, depending on the task you selected in the CiscoWorks home page.

•About—Displays the general information about the software. The window displays license information, version and patch level, installation date and copyright information.

See User Guide for CiscoWorks LMS Portal 1.0.1 for information on the additional tool bar items that the LMS Portal application provides.

Navigation Tools

The navigation tools used by CiscoWorks applications are:

•Tool Bar Buttons

•CiscoWorks Home Page

•CiscoWorks LMS Portal

•Navigation Buttons

•Hypertext Links

Tool Bar Buttons

The tool bar buttons helps you to log out from CiscoWorks applications, launch the Online help system and view the product license and copyright information.

See Tool Bar Items for more information.

CiscoWorks Home Page

The CiscoWorks home page provides launch points for all applications.

See CiscoWorks Home Page Layout for more information.

CiscoWorks LMS Portal

CiscoWorks LMS Portal is the default home page if you launch the CiscoWorks applications from the server where you have installed LMS Portal. The CiscoWorks LMS Portal also provides launch points for all applications.

See User Guide for CiscoWorks LMS Portal 1.0.1 for more information.

Navigation Buttons

You can navigate within an application using:

•Task Navigation Buttons

Task navigation buttons allow you to move backward and forward within the steps of a task. You use the Back, Next, and Finish buttons to navigate through the screens in a task.

The first step in a task uses only a Next button. Intermediate steps can use the Next and Back buttons. The last step can use the Back and Finish buttons.

You can partially complete a task sequence and then jump to another task. However, when returning to the partially completed sequence, you must restart the sequence from the beginning.

•Browser Navigation Buttons

Browser navigation buttons appear in Results and Help windows at the top. These buttons function in the same way as other browser buttons.

The results windows contain two standard browser-type buttons, Back and Close.

–Back takes you back to the previous window.

–Close closes the current window.

Some reports provide additional buttons that allow you to select other reports, save the current report to a file, update the screen, and so on.

Hypertext Links

Hypertext links in the Online help provide connections to other content, procedures, and terminology definitions. These links appear as underlined text.

Supported Browser Versions

You can invoke CiscoWorks home page using the following browsers:

•Microsoft Internet Explorer 6.0

•Microsoft Internet Explorer 7.0

•Mozilla Firefox 2.0

CiscoWorks applications use popup dialog boxes at many places. If you have a popup-blocker enabled in your browser, none of these popups will appear. Therefore, you have to disable the popup-blocker if you have installed it.

The following table lists the features and the issues that are available with the supported browsers:

Browser Issues

Internet Explorer 6.0

Internet Explorer 7.0

Mozilla Firefox 2.0

See ...

Popup windows are blocked by default

Not Applicable

Yes

Yes

Displaying Popup Dialog Boxes

Popup windows appears with address bar and status bar

No

Yes

Not Applicable

Disabling Address and Status Bars In Popup Dialog Boxes

Modal dialogs supported by default

Yes

Yes

No

Enabling Modal Dialog Boxes Support

Links in a popup window opens in a new tab, instead of a new window, by default (Tabbed browsing)

Not Applicable

Not Applicable

Yes

Disabling Tabbed Browsing In Popup Windows

Problems in exporting Reports to PDF and CSV Format on a Windows XP platform.

Yes

Yes

Not Applicable

Enabling Reports Download In CSV and PDF Format

Displaying Popup Dialog Boxes

In Microsoft Internet Explorer 7.0 and Firefox 2.0 browsers, the popup dialog boxes are blocked and are not allowed to display:

To display the pop-up dialog boxes in Internet Explorer 7.0:

Step 1 Click Tools > Pop-up Blocker.

Step 2 Click:

•Turn Off Pop-up Blocker to turn off the pop-up blocker permanently and display the popup dialog boxes.

Or

•Always Allow Pop-ups From This Site to turn off the pop-up blocker only for CiscoWorks software.

To display the pop-up dialog boxes in Firefox 2.0:

Step 1 Click Tools > Options.

Step 2 Click the Content tab.

Step 3 Disable the Block Pop-up windows option.

Step 4 Click OK.

Disabling Address and Status Bars In Popup Dialog Boxes

In Microsoft Internet Explorer 7.0, the popup dialog boxes and notification windows may appear with the address bar and the status bar enabled.

To disable the address bar in the popup dialog boxes in Microsoft Internet Explorer 7.0:

Step 1 Click Tools > Internet Options.

The Internet Options dialog box opens.

Step 2 Click the Security tab.

Step 3 Click Custom level... from the Security level for this zone panel.

The Security Settings dialog box opens.

Step 4 Select the Enable option for Allow websites to open windows without address or status bars.

Step 5 Click OK.

Enabling Modal Dialog Boxes Support

In Firefox 2.0 browsers, modal dialog boxes such as confirmation dialog boxes are not supported by default. They are supported in Internet Explorer browsers.

To enable the modal dialog boxes support in Firefox 2.0 browsers:

Step 1 Click Tools > Options.

The Options dialog box opens.

Step 2 Click the Contents icon.

Step 3 Click Advanced... to open the Advanced JavaScript Settings dialog box.

Step 4 Select Raise or lower windows.

Step 5 Click OK to return to the Options dialog box.

Step 6 Click OK.

Disabling Tabbed Browsing In Popup Windows

In Firefox 2.0 browsers, you can open the links in new tabs instead of opening them in new windows. This feature is enabled by default.

This behavior is the same when you open the links from a popup window.

To disable opening the links in a new tab from a popup window in Firefox 2.0:

Step 1 Click Tools > Options.

The Options dialog box opens.

Step 2 Click the Tabs icon.

Step 3 Select a new tab for the New pages should be opened in radio button.

Step 4 Click OK.

Enabling Reports Download In CSV and PDF Format

In Microsoft Internet Explorer 6.0 SP2 and Microsoft Internet Explorer 7.0 browsers, sometimes problem occurs in exporting the reports in CiscoWorks applications to a PDF or CSV format on a Windows XP client machine.

This may be caused by the default security settings in the browsers.

To enable exporting reports in CSV and PDF format in Internet Explorer browsers:

Step 1 Click Tools > Internet Options.

The Internet Options dialog box opens.

Step 2 Click the Security tab.

Step 3 Click Custom level... from the Security level for this zone panel.

The Security Settings dialog box opens.

Step 4 Select the Enable option for File Downloads.

Step 5 Click OK.

Using Online Help

Each CiscoWorks application includes Online help that provides procedural and conceptual information. Online help also contains:

•A search engine—Allows you to search the topics in Online help, based on keywords.

•An index—Contains typical network tasks.

•A glossary.

To access Online help, click the Help button on the top-right corner. This opens a window that displays help contents. From this window, you can access help for all the installed CiscoWorks applications.

Changing Web Server Port Numbers

You can use the changeport utility to change the web server port numbers. You must run separate commands for Solaris and Windows.

This section contains the following:

•Changing Web Server Port Numbers on Solaris

•Changing Web Server Port Number on Windows

Changing Web Server Port Numbers on Solaris

You can change the web server port numbers (for HTTP and HTTPS) for CiscoWorks web servers.

To change the port numbers you must login as CiscoWorks Server Administrator, and run the following command at the prompt:

/opt/CSCOpx/MDC/Apache/bin/changeport

If you run this command without any command line parameter, CiscoWorks displays:

*** CiscoWorks Web server port change utility ***

Usage: changeport port number [-s] [-f]

where

port number — The new port number that should be used.

-s — Changes the SSL port instead of the default HTTP port.

-f — Forces port change even if Daemon Manager detection fails.

Note Do not use this option by default. Use it only when CiscoWorks instructs you to use.

For example, you can enter:

changeport 1744—Changes the CiscoWorks web server HTTP port to use 1744.

Or

changeport port number -s—Changes the CiscoWorks web server HTTPS port to use the specified port number.

If you change the port after installation, CiscoWorks will not launch from Start menu
(Start > Programs > CiscoWorks > CiscoWorks). You have to manually invoke the browser, and specify the URL, with the changed port number.

The restrictions that apply to the specified port number are:

•Port numbers less than 1026 are not allowed. However, you can use 443 as the HTTPS port number.

•The specified port should not be used by any other service or daemon. The utility checks for active listening ports, and ports listed in /etc/services. If there is any conflict, it rejects the specified port.

•The port number must be a numeric value in the range 1026 - 65535. Values outside this range, and non-numeric values are not allowed.

•If port 443 is specified for any of the web servers, that web server process is started as root. This is because ports lower than 1026 are allowed to be used only by root in Solaris.

However, according to Apache behavior, only the main web server process run as root, and all the child processes run as casuser:casusers. Only the child processes serve the external requests.

The main process that runs as root monitors the child processes. It does not accept any HTTP requests. Owing to this, Apache ensures that a root process is not exposed to the external world, and thus ensures security.

•If you do not want CiscoWorks processes to run as root, do not use the port 443.

When you run the utility with the appropriate options, it displays messages on the tasks it performs.

This utility lists out all the files that are being updated. Before updating, the utility will back up all the affected files in /opt/CSCOpx/conf/backup and creates appropriate unique sub-directories.

It also creates a new file called index.txt. This text file contains information about the changed port, a list of all the files that are backed up, and their actual location in the CiscoWorks directory.

A sample backup may be similar to:
/opt
   |
   `--/CSCOpx
       |
       `--/conf
         |
         `--/backup
           |
           |--README.txt (Note the purpose of this directory as it is initially empty)
           |
           `--/AAAtpaG03_Ciscobak (Autogenerated unique backup directory).
                     |
                     |--index.txt (The backup file list)
                     |--httpd.conf (Webserver config file)
                     |--md.properties (CiscoWorks config elements)
                     |--mdc_web.xml (Common Services application config file)
                     |--regdaemon.key (Common Services config registry key file)
                     |--regdaemon.xml (Common Services config registry data file)
                     |--rootapps.conf (CiscoWorks daemons using privileged ports)
                     |--services (The system /etc/services file)
                     `--ssl.properties (CiscoWorks config elements for SSL mode)
Note All the above files and the unique directories are stored with read only permission to casuser:casusers. To ensure the security of the backup files, only the CiscoWorks Server Administrator has write permissions.

The change port utility displays messages to the console, as it runs. These messages contain information about the directory where the backup files are being stored. These messages are also logged to a file, changeport.log

This file is saved to the directory:

/var/adm/CSCOpx/log/changeport.log

This file contains the date and time stamps to indicate when the log entries were created.

Changing Web Server Port Number on Windows

You can change the web server port numbers (for HTTP and HTTPS) for the CiscoWorks web server.

If you are using HPOV as your third party NMS application, you would require the IIS service be enabled for HPOV to install and run. The IIS web server runs on SSL port 443, which is the default port for LMS web server.

Since LMS web server and IIS web server conflicting on SSL port 443, Ciscoworks Common Services cannot run on a machine, where IIS is installed and enabled.

To avoid this conflict, you should change the SSL port number of LMS web server from 443 to some other available port number while installing the CiscoWorks applications.

To change the port numbers you must have administrative privileges. Run the following command at the prompt:

NMSROOT\MDC\Apache\changeport.exe

If you run this utility without any command line parameter, CiscoWorks displays the following usage text:

*** Common Services Web server port change utility ***

Usage: changeport port number [-s] [-f]

where:

port number — The new port number that should be used

-s — Change the SSL port instead of the default HTTP port

-f — Force port change even if Daemon Manager detection fails.

Note Do not use this option by default. Use it only when CiscoWorks instructs you to use.

For example, you can enter:

•changeport 1744—Changes the Common Services web server HTTP port to use 1744.

Or

•changeport port number -s—Changes the Common Services web server HTTPS port to use the specified port number.

The restrictions that apply to the specified port number are:

•Port numbers less than 1026 are not allowed. However, you can use 443 as the HTTPS port number.

•The specified port should not be used by any other service or daemon. The utility checks for active listening ports, and if any conflict is found, the utility rejects the specified port.

There is no reliable way to determine whether any other service or application is using a specified port. If the service or application is running and actively listening on a port, it can be easily detected.

However, if the service is currently stopped, there is no way that the utility can determine what port it uses. This is because on Windows there is no common port registry equivalent to /etc/services as in UNIX.

•The port number must be a numeric value in the range 1026 - 65535. Values outside this range, and non-numeric values are not allowed.

When you run the utility with the appropriate options, it displays messages on the actions it is performing.

It lists out all the files that are being updated. Before updating, the utility backs up all the affected files in CSCOpx\conf\backup, and creates, appropriate, unique, sub-directories.

It also creates a new file called index.txt. This text file contains information about the changed port, a list of all the files that are backed up, and their actual location in the CiscoWorks directory.

A sample backup may be similar to:
[drive:]
 |
 `--\Program Files
      |
      `--\CSCOpx
           |
           `--\conf
                |
                `--\backup
                   |
                   |--README.txt (Note the purpose of this dir as it is initially 
empty)
                   |
                   `--\skc03._Ciscobak (Autogenerated unique backup directory).
                        |
                        |--index.txt      (The backup file list)
                        |--httpd.conf     (Webserver config file)
                        |--md.properties (CiscoWorks config elements)
                        |--mdc_web.xml    (Common Services application config file)
                        |--regdaemon.key (Common Services config registry key file)
                        |--regdaemon.xml (Common Services config registry data file)
                        `--ssl.properties (CiscoWorks config elements for SSL mode)
Note All the above files and the unique directories are stored with read only permissions. Only the administrator and casuser have write permissions, to ensure the security of the backup files.

The change port utility displays messages on the console, as it runs. These messages specify where the backup files are being stored.

The messages displayed by the change port utility are also logged to a file, changeport.log and is saved to the directory, NMSROOT\log. This log file contains the date and time stamps to indicate when the log entries were created.