IBM FileNet Image Services securely store and manage a wide variety of content, including documents, reports, media content , COLD (Computer Output Laser Disk) document format, and more, in large volumes and quantity, allowing high availability. IBM FileNet IDM solutions deliver a comprehensive set of capabilities, including integration with existing information systems such as FileNet Image Services, full-featured document search, and the ability to view, manage, and share the documents from Image Services across the entire enterprise.
Setting up FileNet Image Services
FileNet Image Services supports IBM® DB2®, Oracle and MS SQL Server as backend RDBMS servers. This section describes the steps required for setting up Image Services 4.1 with Oracle and MS SQL Server as backend databases. It's assumed that the required RDBMS software is already installed. It initially covers the preparation necessary to install Image Services 4.1 and then continues onto the installation and configuration of Image Services 4.1.
Note: The scope of this article is restricted to the Windows® platform. For further information, read the guidelines for installing FileNet Image Services, included in "Guidelines for Installing and Updating Site-Controlled Oracle and MS SQL Software for Windows Server" (IBM, 2008). (See Resources.)
Before you install
Create users and groups
- Create the following users:
- dbauser (for Oracle only)
- Create the following groups:
- dbagroup (only if the Oracle is installed on the same machine as Image Services)
- Make users "fnsw", "Administrator", and "dbauser" members of "fnusr" group
- Make users "fnsw" and "Administrator" members of "fnadmin" group
Create required databases and table spaces
Based on the database being used, create the appropriate table spaces:
MS SQL server
- Create a transactional database: (Example) ISDB.
- Create the table spaces described in Table 1:
Table 1. Required tablespaces
|Server name||Object name||Location|
- Create a transactional database: (Example) ISDB.
- Create the table spaces described in Table 2:
Table 2. Required table spaces
|Name||Type||Min size in MB|
|fnsys_ts||System tablespace (Permanent)||200|
|fntmp_ts||Temporary tablespace (Temporary)||400|
|fntemp_ts||Index tablespace (Permanent)||200|
The index tablespace is optional, so the system tablespace can be used for indexing purpose, instead of the index tablespace.
- Create DB2 database, buffer pool, and tablespace with more than 4K.
- Create database IndexDB.
- Create buffer pool BP 5000 page, size 16K.
- Create regular tablespace TS page, size 16K, managed by system using (FNIS buffer pool BP).
Installing Image Services 4.1
- Double-click on the is_4.1.0_win.exe file in the installation package.
- On the welcome page of Image Services installation, click on Next to continue.
- Accept the software license notice, and click on Next.
- Select either of the following options, and click on Next:
- System Check only (Hardware, OS, users, and groups status): Select this radio button just to check the status of the system.
- System Check and Install Image Services: Select this radio button to install Image Services 4.1.
Figure 1. System check and install
- Once the system check is passed, the installation moves on to the
database selection window. Select the relevant databases from the
drop-down list, and click on Next:
Figure 2. Select database
- Select Next in the "Configure the fnsw user account" window:
Figure 3. Configure fnsw user account
- Enter the password for fnsw, and click on Next:
Figure 4. Enter the password
- Enter the System Serial Number (SSN) and Network Clear House (NCH)
Figure 5. Image Services configuration information
Note: In the NCH Domain name filed, enter the value in Domain:Organization format. For example, if the server's name is server1 and the organization is IBM, you would enter
server1:IBM. Make sure to also select Combined Server.
- Select the installation path, and click Next:
Figure 6. Choose installation path
Note: Both the paths mentioned for Image Services executables and Image Services local files should be of NTFS format and have a minimum of 500MB space each.
- The install shield checks for hard disk and OS status. Make sure none
show a Fail status. Click on Next.:
Figure 7. Hardware checks
- The install shield further checks for groups and users info. Click on
Figure 8. Groups and users checks
If you need to do so, refer to the "Create users and groups" section to see what users and groups need to be created.
- A summary of the installation is displayed. Click on Next:
Figure 9. Summary
- Upon successful installation, the message, illustrated in Figure 10,
is displayed. Click on Next.
Figure 10. Successful installation
- Select Yes, restart my computer, and click on Finish to
complete the Image Services installation:
Figure 11. Restart the computer
Configuring FileNet Image Services software
This section explains the construction of an Image Services system configuration database customized to an Image Services installation. This editor helps you specify database-related information such as temp db, index db location, and default size.
- Log on as fnsw.
- To open the configuration editor, select Start > Programs > FileNet Image Services > System Configuration > Configuration Editor. The New Configuration Database dialog box will open.
- Enter the domain name, as entered during the installation, and select
Combined Server System for database template:
Figure 12. New configuration
- Click on OK.
- Select the default directory for the data sets, and select Next.
- Select the relation database type (MS SQL 2000, Oracle, or DB2) for the new configuration, and click on Next.
- Once you select the database, you're prompted to enter the password
for the following users. Enter them, then select Next.
- Choose the defaults for further options until you arrive at the prompt "Do you want to automatically configure the storage library?". Select Yes, and click on Next twice.
- When your configuration is complete, a "Configuration Complete" message appears. Click on Next to complete the configuration.
- The FileNet Image Services System Configuration Editor window displays. Before you exit the Configuration Editor, complete any remaining configuration sections that apply to your system.
- From the FileNet Image Services System Configuration Editor window, click on the File menu, and click on the Exit option.
- Click on the Yes button to save the configuration and exit the System Configuration Editor.
Initializing the server software
- Log on as fnsw, if you aren't already.
- Initialize the index database and all the MKF databases (includes
permanent, transient, and security databases). Enter the following
commands to initialize the databases:
fn_setup_rdb -f fn_util init
The initialization will take approximately 5 - 30 minutes, during which time there is very little status feedback to the display. The larger the data sets, the longer the process takes. When the prompt returns to the Command Prompt window, the initialization is complete.
- When initialization is complete, view the following log files to make
sure there were no errors in the database initialization process:
- database logs - oracle.log (or mssql.log)
Starting Image Services
Once the initialization process is complete, Image Services needs to be started.
- Logon as fnsw, if you aren't already logged on.
- Open the Windows Services window.
- If the properties are not correct, right-click on IS ControlService. The Image Services ControlService Properties dialog opens.
- Verify that the Image Services ControlService is started. If the settings for the Image Services ControlService are correct, skip to Step 6.
- In the Image Services ControlService Properties window, do the
following, as necessary:
- Set the startup type to automatic.
- Click on the Start button to start the Image Services ControlService.
- Click OK to exit the Image Services ControlService Properties window.
- Close the services window.
- Open the FileNet Task Manager.
- From the Taskbar, point to Programs > FileNet Image Services > Server Applications, and click on the Task Manager icon. Since the Image Services ControlService is running, the TM_daemon.exe process will be listed in the Process column.
- Select the Monitor drop-down menu, and select the Event Logs... option. The Event Logs window appears.
- Select the Display drop-down>menu, and select the Dynamic option. This enables the event window to be refreshed whenever messages are logged. Leave the Event Logs window open.
- At the FileNet Task Manager window, click on Start to bring up the FileNet software. Messages will display in the Current Status window as FileNet software is being started.
- After the FileNet software has been initiated, click on the Close button to close the Current Status window.
- View the Event Logs window to make sure there are no error messages.
- After viewing the Event Logs, close any other open windows.
Integrating Image Services with FileNet IDM
Configure Image Services using IDM Configure
The purpose of the IDM Configure application is to allow you to determine which libraries an IDM desktop and IDM Web Services can access, and to configure certain parameters that affect IDM Desktop and IDM Web Services application behavior.
FileNet IDM has three types of clients: IDM Desktop, IDM Web Services, and IDM Open Client. Configuring IDM products involves defining user preferences, which includes setting up access to libraries, defining options for directories and files, documents, searches, libraries, and integrated applications. Some of the preferences are common to IDM Desktop, IDM Web Services, and IDM Open Client. Using IDM Configure, you can set or modify additional preferences per the requirement for each library.
Once the preferences are set, you can export them to a file, then import these preferences to another user computer. This facilitates setting up many users' machines with common settings.
- To launch the IDM Configure application, select Start > Programs > FileNet IDM > Configure.
- Once IDM Configure opens, click on the Add button to add a
library, and then select Image Services to add an Image
Figure 13. Configure IDM
- In the Library name field, enter the name you want to use as the library's label.
- In the Domain field, enter the domain name of the system.
- In the Organization field, enter the organization name, as provided at the time of installation of Image Services.
- Click on OK to confirm.
Note: In the Image Services configuration, Image Services domain and organization names are case sensitive.
In some cases, a line must be added to the hosts file of the machine for each Image Services server that includes the IP address of the Image Services server and its NCH designation. An example of this line is:
IS server IP domain-organization-nch-server
IDM Configure allows the users to configure any number of IS libraries.
A COLD document is a special type of document that has text superimposed on a background image. The text has a specific formatting, such as font, font size, and spacing, so that it can sit on the background image and give an impression of a single image. COLD documents also save space when it comes to ECM, and, by default, these COLD documents can be worked on as normal images. In addition, there is also a possibility to search these documents based on the content (in the superimposed text), and when displayed as a text, the text document can be selected and copied.
The FileNet system supports various devices, like print servers, scan servers, storage libraries, fax servers, tapes, disks, and more. All hardware devices need to be configured on the Image Services:
- Print server - All the printers are connected to a print server that receives documents for printing from the Image Services. The print server also provides software to monitor the printing status, errors, and network connection information.
- Fax server - The fax server is a server that is equipped with fax card and fax software. It receives documents from Image Services and converts them to outbound documents to a misconfiguration machine or another fax server, as well as converts the received fax documents to inbound documents and converts them into FileNet images.
To configure Print/Fax, select IDM Configure > Additional Preferences > Print/ Fax:
Figure 14. Configure Print/Fax
Most common errors encountered during integration
While integrating FileNet Image Services with FileNet IDM, there is a possibility of encountering errors either due to misconfiguration of FileNet IDM or service unavailability. Table 3 describes the most common errors encountered connecting the FileNet Image Services and the respective troubleshooting techniques:
Table 3. Common errors and troubleshooting techniques
|Common errors||Cause||Troubleshooting technique|
|Property manager unavailable||By default, while adding a library in IDM Configure FileNet, Content Service is selected, and if not changed to FileNet Image Service in IDM Configure, this error is encountered.||Remove the FileNet Image Services library and correctly add it in IDM Configure, making sure FileNet Image Service is selected.|
|Unable to log on||This error is encountered when the FileNet Image Services Library is either shut down or services are not available.||Start the FileNet Image Services. Make sure the FileNet Image Services starts automatically at system boot up.|
|Get category method failed||This error is encountered when the database services are not available.||Start the database services. Make sure the database services start automatically at system boot up.|
Again, Table 3 lists the most common errors that can be encountered. If you encounter other errors, please refer to the guide lines for installing FileNet Image Services in "Guidelines for Installing and Updating Site-Controlled Oracle and MS SQL Software for Windows Server." (See Resources.) For known issues for FileNet IDM on Windows Vista, see "Technical Bulletin - IDM 4.0.2 on Windows Vista" (IBM, 2008). (See Resources.)
This article walked you through the basic installation, initialization, and configuration of FileNet Image Services. It guided you through the step-by-step procedure to effectively integrate FileNet Image Service with FileNet IDM. This article also helped solve basic errors that are encountered during the integration of FileNet Image Services with FileNet IDM.
- "Guidelines for Installing and Updating Site-Controlled Oracle and MS SQL Software for Windows Server" (IBM, 2008): Follow these guidelines for installing and updating Oracle and MS SQL software on a Windows Server.
- "Technical Bulletin - IDM 4.0.2 on Windows Vista" (IBM, 2008): Understand installation, upgrade scenarios, and known issues for IDM on Windows Vista, and find alternative methods to overcome the known issues.
- FileNet documents: Read "FileNet Web Services Administrator's Help" (WSAdminHelp.zip) and "IDM Web Services Online Help" (WSUserHelp402.zip) for further reference.
- developerWorks Information Management zone: Learn more about Information Management. Find technical documentation, how-to articles, education, downloads, product information, and more.
- Stay current with developerWorks technical events and webcasts.
- Technology bookstore: Browse for books on these and other technical topics.
Get products and technologies
- IBM trial software:Build your next development project with IBM trial software, available for download directly from developerWorks.
- Participate in the discussion forum.
- Participate in developerWorks blogs and get involved in the developerWorks community.