Install the Web Client

Table of Contents

Install Requirements

Before You Begin

Install Procedure

Getting Started

Select Components for Installation

Configuration of Other Installation Options

Client Group Selection

Schedule Automatic Update

Global Filters Selection

Storage Policy Selection

Configure the Web Client for Web-Based Administration

Verify Summary of Install Options

Setup Complete

Post-Install Considerations

Install Requirements
The Web Client is installed on the Apache Tomcat to provide a web-based interface for end-users and compliance users to search for data. The computer on which this component will be installed is referred to as the Client computer in this install procedure. For the Web Client installation to complete successfully, Web Search Server must already be installed.

Verify that the computer in which you wish to install the software satisfies the minimum requirements specified in System Requirements - Web Search Server and System Requirements - Microsoft Windows File System iDataAgent.

The following procedure describes the steps involved in installing the Windows File System iDataAgent and the Web Client. If you choose to install multiple components simultaneously, refer to the appropriate procedures for installation requirements and steps specific to the component. Note that when you install multiple components, the sequence of the install steps may vary.
Contact Professional Services for assistance in designing the Content Indexing Engine and Search in your environment.

Review the following Install Requirements before installing the software:

General

  • Review Install Considerations before installing the software.
  • Agents should be installed only after the CommServe and at least one MediaAgent have been installed in the CommCell. Also, keep in mind that the CommServe® software and MediaAgent must be installed and running (but not necessarily on the same computer), before you can install the Agent.
  • Close all applications and disable any programs that run automatically, including anti-virus, screen savers and operating system utilities. Some of the programs, including many anti-virus programs, may be running as a service. Stop and disable such services before you begin. You can re-enable them after the installation.
  • Ensure there is an available license on the CommServe software for the Agent.
  • Verify that you have the Software Installation Disc that is appropriate to the destination computer’s operating system.

Agent Specific

To complete the Web Client installation, this software should be installed in a CommCell component where Web Search Server is already installed.

Before You Begin

  • Log on to the client as local Administrator or as a member of the Administrators group on that computer.

Install Procedure

Getting Started
1. Place the Software Installation Disc for the Windows platform into the disc drive.

After a few seconds, the installation program is launched.

If the installation program does not launch automatically:

  • Click the Start button on the Windows task bar, and then click Run.
  • Browse to the installation disc drive, select Setup.exe, click Open, then click OK.

NOTES

  • If you are installing on Windows Server Core editions, mount to Software Installation Disc through command line, go to the AMD64 folder and run Setup.exe.
2. Choose the language you want to use during installation. Click the down arrow and select the desired language from the drop-down list, and click Next to continue.
3. Select the option to install software on this computer.

NOTES

  • The options that appear on this screen depend on the computer in which the software is being installed.
4. Read the license agreement, then select I accept the terms in the license agreement.

Click Next to continue.

Select Components for Installation
5. Select the component(s) to install.

NOTES

  • Your screen may look different from the example shown.
  • Components that either have already been installed, or which cannot be installed, will be dimmed. Hover over the component for additional details.
  • If you wish to install the agent software for restore only, select Install Agents for Restore Only checkbox. See Installing Restore Only Agents for more information.
  • The Special Registry Keys In Use field will be highlighted when GalaxyInstallerFlags registry key is enabled. Move the mouse pointer over this field to see a list of registry keys that have been created in this computer.

Click Next to continue.

To install the Web Client, expand the Client Modules folder, and the Web Based Search & Browse folder, then select the following:

  • Web Client

When you select this component for install, the appropriate Windows File System iDataAgent is automatically selected for install.
6. Click Yes to set up the required privileges for the local administrators group.

NOTES

  • This option will only appear if the Windows user account used to install the software does not have the required administrator rights (e.g., if the operating system was newly installed).
  • If you choose to click Yes, the install program will automatically assign the required rights to your account. You may be prompted to log off and log back on to continue the installation.
  • If you choose to click No, the installation will be aborted.
  • You will be prompted at the end of the installation to decide if you want these privileges to be revoked.
note.gif (292 bytes) The install program checks your Windows user account for the following necessary operating system rights:
  • Right to increase quotas (this is referred to as adjust memory quotas for a process on Windows Server 2003).
  • Right to act as a part of the operating system.
  • Right to replace a process level token.

Configuration of Other Installation Options
7. If this computer and the CommServe is separated by a firewall, select the Configure firewall services option and then click Next to continue.

For firewall options and configuration instructions, see Firewall Configuration and continue with the installation.

If firewall configuration is not required, click Next to continue.
8. Enter the fully qualified domain name of the CommServe Host Name. This should be TCP/IP network name. e.g., computer.company.com.

NOTES

  • The CommServe client name is the name of the computer.  This field is automatically populated.
  • Do not use space and the following characters when specifying a new name for the CommServe Host Name:

    \|`~!@#$%^&*()+=<>/?,[]{}:;'"

  • If a computer has already been installed, this screen will not be displayed; instead the installer will use the same Server Name as previously specified.
  • If you do not specify the CommServe Host Name, a window will be prompted to continue in decouple mode. Click Yes to continue to Decoupled Install. Click No to specify a CommServe Name and continue with the installation.

Click Next to continue.
9. Enter the username and password associated with an external domain user account or a CommCell user account to authorize the installation of this agent.

NOTES

  • This window will be displayed when the Require Authentication for Agent Installation option is selected in the CommCell Properties. For more information, see Authentication for Agent Installs.

Click Next to continue.
10. Enter the following:
  • The local (NetBIOS) name of the client computer.
  • The TCP/IP IP host name of the NIC that the client computer must use to communicate with the CommServe Server.

NOTES

  • Do not use spaces when specifying a new name for the Client.
  • The default network interface name of the client computer is displayed if the computer has only one network interface. If the computer has multiple network interfaces, enter the interface name that is preferred for communication with the CommServe Server.
  • If a component has already been installed, this screen will not be displayed; instead, the install program will use the same name as previously specified.

Click Next to continue.
11. Specify the port numbers to be used by IIS Website and Apache Tomcat Server.

NOTES:

  • Microsoft Internet Information Services (IIS) uses port number 80 by default. If you wish to use the port 80 for Web Client, provide the different port number in IIS Default Website port number.
  • Ensure that these port numbers are different and are not already used by any other services or application.

Click Next to continue.

 
12. Select Add programs to the Windows Firewall Exclusion List, if you wish to add CommCell programs and services to the Windows Firewall Exclusion List.

NOTES:

  • If Windows Firewall is enabled on the computer, this option is selected by default and must be enabled to proceed with the installation.
  • If Windows Firewall is disabled on the computer, you can select this option to add the programs and services to enabled CommCell operations across the firewall, if the firewall is enabled at a later time.

    You can either select this option during install or add the programs and services after installation. For adding the programs and services after installation, see Configure Windows Firewall to Allow CommCell Communication.

Click Next to continue.
13. Specify the location where you want to install the software.

NOTES

  • Do not install the software to a mapped network drive.
  • Do not use the following characters when specifying the destination path:
     / : * ? " < > | #
    It is recommended that you use alphanumeric characters only.
  • If you intend to install other components on this computer, the selected installation directory will be automatically used for that software as well.
  • If a component is already installed in this computer, this screen may not be displayed. The software will be automatically installed in the same location that was previously specified.

Click Browse to change directories.

Click Next to continue.

Client Group Selection
14. Select a Client Group from the list.

Click Next to continue.

NOTES

  • This screen will be displayed if Client Groups are configured in the CommCell Console. For more information, see Client Computer Groups.

Schedule Automatic Update
15. If necessary, select this option to schedule an automatic installation of software updates.

NOTES

  • Schedule Install of Automatic Updates allows automatic installation of the necessary software updates on the computer on a single or weekly basis. If you do not select this option, you can schedule these updates later from the CommCell Console.
  • To avoid conflict, do not schedule the automatic installation of software updates to occur at the same time as the automatic FTP downloading of software updates.

  • If a component has already been installed, this screen will not be displayed; instead, the installer will use the same option as previously specified.

Click Next to continue.

Global Filters Selection
16. Select the necessary Global Filter option for the default subclient and Click Next to continue.

NOTES

  • Select Use Cell level Policy to inherit the global filter policy configuration set for the CommCell, i.e., if the Use Global Filters on All Subclients option is selected in the Global Filters dialog box (from the CommCell Console’s Control Panel), then this policy will be applied to the default subclient as well. If is not selected, then the global filters will not be applied to the default subclient.
  • Select Always use Global filters to apply the global filters policy to the default subclient regardless of the policy set for the CommCell.
  • Select Do not use Global filters to disregard applying the global filters to the default subclient regardless of the policy set for the CommCell.
Click Next to continue.

Storage Policy Selection
17. Select the storage policy through which you want to back up/archive the agent.

NOTES

  • A storage policy directs backup data to a media library.
  • If desired, you can change your storage policy selection at any time after you have installed the client software.
  • This screen may appear more than once, if you have selected multiple agents for installation. You will be prompted to configure the storage policy association for each of the selected agents.

Click Next to continue.

Configure the Web Client for Web-Based Administration
18. Select the Web Search Server client name.

Click Next to continue.
19. Specify the virtual directory alias name for the compliance site, end-user site and admin site user to connect to the Web Client using a Web browser.

NOTES

  • The alias names provided here will be used to access the corresponding end user, compliance user, and administrator pages of the web client in the web browser.

Verify Summary of Install Options
20. Verify the summary of selected options.

NOTES

  • The Summary on your screen should reflect the components you selected for install, and may look different from the example shown.

Click Next to continue or Back to change any of the options.

The install program now starts copying the software to the computer. This step may take several minutes to complete.

Setup Complete
21. Click Next to continue.

NOTES

  • Schedules help ensure that the data protection operations for the Agent are automatically performed on a regular basis without user intervention. For more information, see Scheduling.
22. Click Yes to remove the privileges that were assigned earlier by the install program. If you do not wish to remove them, click No.

NOTES

  • This option will only be displayed if you were prompted to assign the privileges earlier in the installation.
23. Setup displays the successfully installed components.

NOTES

  • The Setup Complete message displayed on your screen will reflect the components you installed, and may look different from the example shown.
  • If you install an Agent with the CommCell Console open, you need to refresh the CommCell Console (F5) to see the new Agents.
  • If Reboot Now button is displayed make sure to reboot the computer before performing any other operations from the computer.

Click Finish to close the install program.

The installation is now complete.
If the Web Server and Web Client is installed on 64 bit machine, then installation of 32-bit File system iDataAgent is required for restoring the data from the search console.

Post-Install Considerations

General

Install post-release updates or Service Packs that may have been released after the release of the software. When you are installing a Service Pack, ensure that it is the same version as the one installed in the CommServe Server. Alternatively, you can enable Automatic Updates for quick and easy installation of updates in the CommCell component.