The first section described how to install Lotus Quickr Content Integrator. This chapter describes how to test the installation. First, this section explains how to start each of the Content Integrator components. Then, it describes how to test the Server, to ensure that it has been properly installed and configured.
Starting the Content Integrator Components
Before you can test the installation, you need to start up the Content Integrator components:
• Content Integrator Composer
• Content Integrator Server Manager
• Content Integrator Server
When you go to the Content Integrator program group, you'll see listings for some or all of the following items (depending on which Content Integrator products you have installed):
Program Group Item
Developer interface for creating jobs.
Text file containing "ReadMe" information.
Server Engine (Console Version)
Content Integrator engine running as a Windows program.
Interface to administer Content Integrator Server.
Server Performance Monitor
Monitors Server performance.
Content Integrator Composer
To start the Composer, click on Composer in the Content Integrator program group, or select Start > Programs > Lotus Quickr Content Integrator > Composer.
During the installation, you were given the option of pointing Content Integrator to an empty system catalog or a system catalog containing sample Content Integrator applications. If you selected the Examples system catalog, the Composer Objects window will show the objects associated with the sample applications that are installed with ecKnowledge. The actual objects that appear will vary, depending on which components you installed. The Content Integrator Developer's Guide describes the Composer window and its objects in detail.
If, during installation, you selected to point Content Integrator to an empty system catalog and you wish to point to the Examples system catalog now, refer to "Configuring the System Catalog and Log Files" for instructions on how to point Content Integrator to a different system catalog and log. If you wish to run the sample applications, you will need to change the pointer in both the Composer and the Server Manager.
In the unlikely event that the Composer is pointing to a non-existent system catalog (probably stemming from a previous installation of the Composer on the same machine), Content Integrator will prompt you for the correct location when you first open the Composer window. Refer to "File Locations" on page 1-34 for information on the exact location and file names for the newly installed empty (template) and "Examples" system catalogs and logs.
Content Integrator Server Manager
To start the Server Manager, click on Server Manager in the Content Integrator program group, or select Start > Programs > Lotus Quickr Content Integrator > Server Manager. The Server Manager interface initially looks something like this:
The Content Integrator Server should be listed in the window. If it isn't, select Server > Register
and enter the name of the computer on which the Server is installed.
The Content Integrator Developer's Guide describes the Server Manager in detail. This Installation Handbook focuses on using the Server Manager to start the Server.
Content Integrator Server
In the Server Manager window, click on the Server that you want to start. Then select Server > Service > Start from the menu. You will get a message confirming that the Server is running, and the traffic light icon next to the Server's name will turn from red to green.
Note: If you don't have administrative rights to start Content Integrator as a service, you can still test the rest of the installation by running the console version of the Server. To do this, double-click on the icon for "Server Engine (Console Version)" in the ecKnowledge program group, or select Start > Programs > Lotus Quickr Content Integrator > Server Engine (Console Version). This launches the Server engine as a program instead of a Service.
Testing the Server
To test the Content Integrator Server, try running one of the examples shipped with Content Integrator. You can see the example applications in the Composer (see "Content Integrator Composer"). The examples available may vary, depending on which Content Integrator components you installed. For purposes of testing the current installation and configuration, select a sample application that is compatible with the data sources available in your local environment.
Confirm Server Configuration Before Testing
Before running the example, confirm the following:
Test the Server Installation
- Have you requested and applied the Content Integrator license key, as described in "Content Integrator License Keys"?
- Does your system meet all the software requirements as described in "System Requirements"?
- Did you successfully install both the Server and the Server Manager?
- Have you installed the connectors you need to run the example?
- Is the Server registered? (To confirm this, start the Server Manager, as described in "Content Integrator Server Manager", and use the procedures in this section to register the Server if it is not already registered.)
- Does the Server's Windows account have the "Log On As Service" right, as described in "Granting 'Log On As Service' Right"?
- Have you started the Server, as described in "Content Integrator Server"?
- Is the Server pointing to the Examples system catalog? (By default, it should point to the file "RASSysCat.mdb" in the Content Integrator program directory. If it points elsewhere, you will need to point it to the correct file. For instructions, see "Selecting the System Catalog".)
- Is all the client software that is required to run the particular sample application properly installed and configured? For information on what client software is needed, see "Software Requirements" and the Content Integrator Developer's Guide section on setting up connections and data sources.
To test the Server installation:
1. Start the Server Manager, if it is not already started.
2. Select Task > Submit Task
from the Server Manager menu. You will see a list of sample information exchange jobs, similar to this:
3. Select the job you want to run, and click OK
4. To view the Server's activity and job results, select View > Server Activity
from the Server Manager menu.
You will see another menu that looks something like the following:
5. Choose Activity History
to determine whether the information exchange job completed successfully. You can also look at the sample data results in the associated databases or folders. If the job completed successfully, you have correctly installed and configured the three main Content Integrator components: Composer, Server, and Server Manager.
If the job encountered Server errors, re-check the Server configuration (see "Confirm Server Configuration Before Testing"). If the configuration is correct but the problem persists, it may be that the Server is using an incorrect Windows account login name or password — or yourContent Integrator temporary evaluation license key may have expired--- or another problem occurred.
The following table lists some common error symptoms and their solutions:
The system displays the following error message:
"Start Service failed, Error 1069. The Service could not be logged on, or specified account does not have logon as service right...."
Either you incorrectly specified the password for the Content Integrator Service, or the account you specified for the Service lacks the "Log On As Service" right. To fix, follow the instructions in "Granting 'Log On As Service' Right".
The system displays a message instructing you to check the Windows event log, and the event log contains the message "The Content Integrator Engine service failed to start due to the following error: The service did not start due to a logon failure." — followed by the message:
"Logon attempt with current password failed with the following error: Logon failure: unknown or bad password."
The password for the Server account is incorrect. To fix, follow the instructions in "Granting 'Log On As Service' Right".
If you have a problem connecting to a data source for one of the sample applications that ship with Content Integrator, it may be that the connection object associated with that application is configured incorrectly for your installation — either because you installed the Examples folder in a location other than the default location or because the sample application configuration requires some modification prior to execution. Refer to "Configuring the System Catalog and Log Files" or the Content Integrator Developer's Guide section on setting up data sources for instructions on changing the connection object.
Back to the Lotus Quickr Content Integrator Installation and Configuration Guide