Web Administration for CommCell Console

Table of Contents

Overview

The CommCell Console provides several configuration options for web administration. These options provide the facility to:

  • Access the CommCell Console as a remote web-based application
  • Launch Books Online from the CommCell Console

The following sections describe the available web administration options, as well as the required steps to configure each of them.

Configuring IIS for Windows Servers

To access the CommCell Console as a web application, you need to configure Internet Information Service (IIS) 4 or higher on the computer where the CommCell Console is installed.

Use the Microsoft Server Manager to configure the server features and roles needed to enable IIS on a Windows Server computer. For instructions on using the Server Manager, go to the Microsoft TechNet website, Adding Server Roles and Features. Select the instructions that apply to your Windows server.

  1. Open the Server Manager console.
  2. Use the add roles wizard available in the Server Manager console to add roles to the Web Server (IIS):
    • Under Common HTTP Features, select the HTTP Redirection check box.

      The following check boxes are automatically selected under Common HTTP Features:

      • Static Content
      • Default Document
      • Directory Browsing
      • HTTP Errors
    • Under Application Development, select the following check boxes:
      • ASP.NET
      • ASP
      • CGI

      Note: If you are prompted to add required role services, click Add Required Role Services.

    • Under Security, select the following check boxes:
      • Basic Authentication
      • Windows Authentication
    • Under Management Tools, select the IIS 6 Management Compatibility check box to include the following role services:
      • IIS 6 Metabase Compatibility
      • IIS 6 WMI Compatibility
      • IIS 6 Scripting Tools
      • IIS 6 Management Console

Configuring Web Administration

The following sections describe how the CommCell Console can be configured for web access from the CommServe computer or an alternate computer. Once configured, users can access the CommCell Console using the Java Web Start application from any computer that can communicate with the CommServe.

The Java Web Start application may fail to launch if the Java cache contains corrupted files. To resolve this issue, open the Java Control Panel (located in the Windows Control Panel) and delete all Temporary Internet Files. Then, close and re-launch the CommCell Console.

Prerequisites

Configuring the CommServe Computer

Review the prerequisites in Configuring Web Administration.

IIS Is Enabled During CommServe Installation

By default, the CommCell Console is automatically installed along with the CommServe software. If IIS was enabled during the CommServe installation, access the CommCell Console using your web browser as follows:

http://<commserve_computer>:81/console

IIS Is Not Enabled During CommServe Installation

If IIS is not enabled on the CommServe computer during installation, enable it at any time to start using the CommCell Console through the web.

  1. Use the steps in Configuring IIS for Windows Servers to enable IIS.
  2. Uninstall the CommCell Console on the CommServe machine: In the Windows Control Panel, click Uninstall a Program under Programs.
  3. Reinstall the CommCell Console on the CommServe machine. See Install the CommCell Console for instructions.
  4. Once IIS is enabled and the CommCell Console is reinstalled, access the CommCell Console using your web browser as follows:

http://<commserve_computer>:81/console

CommCell Console Is Not Installed

If you performed a customized installation of the CommServe that excluded the CommCell Console, use the following steps to configure the CommServe computer for web administration:

  1. Log on to the CommServe computer as an Administrator or a member of the Administrator's group.
  2. Verify that IIS is enabled on the computer.
  3. Install the CommCell Console software. See Install the CommCell Console for instructions.
  4. During the installation, click Yes when prompted to configure the console for web administration.

    The CommServe computer is now configured for web administration.

Configuring an Alternate Computer

If you do not want to use the CommServe computer as the IIS source, install the CommCell Console on a separate computer and configure it for web administration.

Review the prerequisites in Configuring Web Administration.

Install the CommCell Console on a Separate Computer

  1. Log on to the alternate computer as an Administrator or a member of the Administrator's group.
  2. Install the CommCell Console software. See Install the CommCell Console for instructions.
  3. During the installation, click Yes when prompted to configure the console for web administration.

    The alternate computer is now configured for web administration.

Configure the CommCell Console to Use the Alternate Computer IIS

  1. Log on to the stand-alone CommCell Console.
  2. From the CommCell Console toolbar menu, click Control Panel.
  3. Under the Monitoring section, click Email & Web Server Configuration.
  4. Click the Web Server tab.
  5. Click the Use Alternate Web Server URL for Add-in check box and type the path to the alternate computer's web alias. The path should be entered as follows:

    http://<alternate_computer_name>:<port>/<web_alias>

    By default, port 81 is used. If you defined a different port, specify the port in the URL.

  6. Click OK.

Access the Console as a Web-Based Application

From any computer that can communicate with the CommCell Console computer, type the following in the web browser:

http://<alternate_computer_name>:<port>/<web_alias>

For example:

http://mycomputer:81/console

Accessing a CommServe Behind a Firewall

When CommCell components are separated by a firewall, the components must be configured with the connection route to reach each other across the firewall.

IIS Port:  Remote access to the CommServe may not be available for computers running outside of a firewall. To enable web access to the CommServe in this scenario, enable the firewall port used by the IIS. By default, this port is 81.

CommServe Port: To make a direct connection to a CommServe through a firewall, enable port 8401.

Proxy Computers: In a firewall environment where a proxy computer is used to authenticate incoming and outgoing connections to the CommServe, you may not be able to access the CommServe if the computer where the CommCell Console is installed is outside of the firewall. To enable web access to the CommServe in this scenario, provide the proxy computer details in the computer where the CommCell Console is installed as follows:

  1. Navigate to the <Software Installation Directory>/GUI folder and open the oem.properties file with any text editor.
  2. Add the following parameters along with their respective values at the end of the file:

    consoleProxyHostName=<host name or IP address of the proxy computer>

    consoleProxyPort=<port number used by the proxy to communicate with the CommServe>

  3. Save the file.

For information on third party port mappings, see Third-Party Port Mappings (TPPM or Network Proxy).

For information on setting up a perimeter network using a proxy, see Firewall - Getting Started - Perimeter Network Using Proxy.

Configuring CommCell Console to Access Offline Documentation

By default, the CommCell Console opens online Documentation in a web browser. When there is no internet connection available, you can configure the CommCell Console to open an offline copy of Documentation that is hosted on an intranet site.

Prerequisites

  1. Download the Documentation package and extract the files. See Downloading the Documentation Package.
  2. Set up the Documentation web site for offline access. See Setting Up the Documentation Web Site for Offline Access.

Steps

  1. Log on to CommCell Console.
  2. On the ribbon in the CommCell Console, click Configuration > Email and Web Server.
  3. Click the Web Server tab.
  4. Select the Use Alternate URL for Online Help check box.
  5. In the URL box, type the URL of the intranet site where the offline Documentation is hosted as follows:

    http://<hostname>:<port>/v10/article

    hostname is the name of the machine hosting the offline Documentation web site. The machine you use to open the CommCell Console must have connectivity to the hostname machine.

    port is the port number specified when setting up the Documentation web site for offline access. The default port number is 8080.

  6. Click OK.
  7. Restart the CommCell Console.

Post-requisites

  • To verify the URL, on the ribbon in the CommCell Console, click Support > Online Help.

    Your web browser should open to the specified intranet site for offline Documentation.

Configuring Reports for Web Administration

Use the following steps to configure reports for web administration:

  1. From the CommCell Console toolbar menu, click Control Panel.
  2. Under the Monitoring section, click Email & Web Server Configuration.
  3. Click the Web Server tab.
  4. Click the Use Alternate Web Server check box.
  5. In the Web Server Name box, type the name of the computer that has the IIS enabled.
  6. In the Alias box, type the desired web alias (if it is different from the one displayed).
  7. Depending on the protocol being used, type the a port number if the default port is not suitable for your environment.

    For HTTP, the default port is 80. For HTTPS, the default port is 443.

  8. In the Report folder published on the Web server box, type the installation path or click the Browse button to select the path.

    Make sure this folder is published on the alternate IIS server and reachable from the CommServe.

  9. Click the Change button to add a login and password to access the IIS Server.
  10. Click OK.

Configure an Alternate Computer for Launching Stand-Alone Add-Ins

You can setup an alternate computer to access stand-alone Add-In components, such as the Outlook and Lotus Notes Add-Ins.

The alternate computer must have the CommCell Console installed and configured for web administration, as well as Internet Information Service (IIS) enabled.

Use the following steps to configure the CommCell Console to use the alternate computer:

  1. From the CommCell Console toolbar menu, click Control Panel.
  2. Under the Monitoring section, click Email & Web Server Configuration.
  3. Click the Web Server tab.
  4. Click the Use Alternate IIS Web URL for Add-in check box and type the path to the alternate computer's web alias. The path should be entered as follows:

    http://<alternate_computer_iis_server_name>/<web_alias>

    The computer specified in this option will also be used as the source for obtaining Java updates for Outlook and Lotus Notes Add-In clients.

  5. Click OK.