HP 7.33 TRIM software Installation and Setup Guide

HP 7.33 TRIM software Installation and Setup Guide
Add to My manuals

HP TRIM software 7.33 is a comprehensive records management solution that helps organizations manage their electronic documents and records. This guide provides detailed instructions on how to install and setup the software, including installing the Workgroup Servers, configuring the network, and setting up the TRIM client.

advertisement

Assistant Bot

Need help? Our chatbot has already read the manual and is ready to assist you. Feel free to ask any questions about the device, but providing details will make the conversation more productive.

HP TRIM 7.33 Installation and Setup Guide | Manualzz

HP TRIM

Software Version: 7.33

Installation and Setup Guide

Document Release Date: July 2013

Software Release Date: July 2013

Legal Notices

Warranty

The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.

The information contained herein is subject to change without notice.

Restricted Rights Legend

Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and

Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.

Copyright Notices

© Copyright 2008-2013 Hewlett-Packard Development Company, L.P.

Trademark Notices

Microsoft®, Windows®, Windows® XP and Windows Vista® are U.S. registered trademarks of Microsoft

Corporation.

Oracle is a registered trademark of Oracle and/or its affiliates.

Documentation Updates

The title page of this document contains the following identifying information:

Software Version number, which indicates the software version.

Document Release Date, which changes each time the document is updated.

Software Release Date, which indicates the release date of this version of the software.

To check for recent updates or to verify that you are using the most recent edition of a document, go to:

http://h20230.www2.hp.com/selfsolve/manuals

This site requires that you register for an HP Passport and sign-in. To register for an HP Passport ID, go to:

http://h20229.www2.hp.com/passport-registration.html

Or click the New users - please register link on the HP Passport login page.

You will also receive updated or new editions if you subscribe to the appropriate product support service.

Contact your HP sales representative for details.

Support

Visit the HP Software Support web site at:

www.hp.com/go/hpsoftwaresupport

This Web site provides contact information and details about the products, services, and support that HP

Software offers.

HP Software online support provides customer self-solve capabilities. It provides a fast and efficient way to access interactive technical support tools needed to manage your business. As a valued support customer, you can benefit by using the support web site to:

• Search for knowledge documents of interest

Submit and track support cases and enhancement requests

Download software patches

Manage support contracts

Look up HP support contacts

• Review information about available services

Enter into discussions with other software customers

Research and register for software training

Most of the support areas require that you register as an HP Passport user and sign in. Many also require a support contract. To register for an HP Passport ID, go to:

http://h20229.www2.hp.com/passport-registration.html

To find more information about access levels, go to:

http://h20230.www2.hp.com/new_access_levels.jsp

Contents

1 Installation and Setup Guide .................................................................... 10

Introduction ...................................................................................................................................................... 10

Audience ............................................................................................................................................................ 10

Chapters Summary .......................................................................................................................................... 10

Related Documents ........................................................................................................................................... 10

2 About HP TRIM software .......................................................................... 11

HP TRIM architecture ...................................................................................................................................... 11

Workgroup Server ...................................................................................................................................... 12

HP TRIM Web Client ................................................................................................................................. 12

Dataset ........................................................................................................................................................ 13

Electronic document stores........................................................................................................................ 13

Document content index ............................................................................................................................ 13

HP TRIM client .......................................................................................................................................... 13

HP TRIM Desktop ...................................................................................................................................... 13

HP TRIM thin client .................................................................................................................................. 14

HP TRIMWatcher ...................................................................................................................................... 14

Citrix launched Offline Records ......................................................................................................... 14

Relational Database Management System (RDBMS) requirements ............................................................ 15

RDBMS resource allocation and management ........................................................................................ 15

Ongoing dataset storage ...................................................................................................................... 15

3 HP TRIM Installation ................................................................................ 16

Installation disc ................................................................................................................................................ 16

HP TRIM environment ..................................................................................................................................... 17

Prerequisites ............................................................................................................................................... 17

Installation overview ................................................................................................................................. 18

64-bit installation ....................................................................................................................................... 19

Installing HP TRIM ................................................................................................................................... 20

Installing without using Group Policy ...................................................................................................... 20

4 Installation types ..................................................................................... 21

Network installation......................................................................................................................................... 21

Network installation prerequisites ........................................................................................................... 21

Network installation steps ........................................................................................................................ 21

Administrative installation ....................................................................................................................... 22

Overview .............................................................................................................................................. 22

Administrative installation steps ....................................................................................................... 22

Group Policy installation ........................................................................................................................... 24

Batch file installation ................................................................................................................................ 25

Batch file parameters .......................................................................................................................... 26

Thin client ......................................................................................................................................................... 31

Thin client installation prerequisites ....................................................................................................... 31

Installing HP TRIM thin client ................................................................................................................. 31

Repairing a thin client installation ........................................................................................................... 32

Upgrading a thin client installation ......................................................................................................... 33

Removing a thin client installation........................................................................................................... 33

Utility TRIMThinClientSetup.exe ............................................................................................................ 33

Using Autonomy iManage Universal Search (IUS) with TRIM .................................................................... 34

Setting up IUS to work with HP TRIM .................................................................................................... 34 ius.properties ....................................................................................................................................... 34 datasources.xml ................................................................................................................................... 34

custom.js and custom.css .................................................................................................................... 35

Folder json\trim .................................................................................................................................. 35

Captions.xml ........................................................................................................................................ 35

Folder lib\ ............................................................................................................................................ 35

Maintenance installation ................................................................................................................................. 36

Repair .......................................................................................................................................................... 37

Repairing an installation .................................................................................................................... 37

Remove ........................................................................................................................................................ 37

Removing an installation .................................................................................................................... 37

Modify ......................................................................................................................................................... 38

Modifying an installation .................................................................................................................... 38

Installation dialog boxes .................................................................................................................................. 39

Missing Prerequisites dialog box .............................................................................................................. 50

Files in Use dialog box ............................................................................................................................... 50

Installation using .msi file rules and behavior ............................................................................................... 50

5 Upgrading HP TRIM ................................................................................ 51

Version support ................................................................................................................................................. 51

Customized client toolbars and menus ........................................................................................................... 51

Upgrading from HP TRIM 6.2 ......................................................................................................................... 52

About upgrading from TRIM 6.2 ............................................................................................................... 52

Upgrade steps from HP TRIM 6.2 to 7.x .................................................................................................. 52

Upgrading from HP TRIM 7 ............................................................................................................................ 55

Upgrade steps from HP TRIM 7................................................................................................................ 55

Upgrading client computers from version 7 ............................................................................................. 56

Upgrading HP TRIM peripheral applications from version 7 ................................................................. 56

Upgrading WebDrawer ISAPI from version 7 ................................................................................... 56

Mixed environments ......................................................................................................................................... 57

Upgrade steps for mixed environments .................................................................................................... 57

Upgrading OEM IDOL ..................................................................................................................................... 58

Upgrading your document content indexes .................................................................................................... 58

Upgrading Offline Records ............................................................................................................................... 58

6 Removing HP TRIM ................................................................................. 59

7 Network user group and the TRIMServices account ..................................... 60

8 Backing up and Restoring your Data ......................................................... 61

Reasons for backing up ..................................................................................................................................... 61

Backup strategy ................................................................................................................................................ 61

Dataset components ................................................................................................................................... 62

Backup techniques ..................................................................................................................................... 63

Recovery techniques ................................................................................................................................... 63

A Steps to Setting up a Working System ....................................................... 64

B Installing and configuring the HP TRIM CFS Connector ................................ 66

Prerequisites ..................................................................................................................................................... 66

Installing the HP TRIM CFS connector .......................................................................................................... 66

Configuring the TRIM connector for use with OEM IDOL ............................................................................ 75

Add LicenseKey.dat ................................................................................................................................... 75

Modify the TRIM connector configuration file ......................................................................................... 75

Modify connector framework configuration file ....................................................................................... 75

Configuring the TRIM connector for use with Enterprise IDOL .................................................................. 76

Install OmniGroupServer .......................................................................................................................... 76

Modify the TRIM connector configuration file ......................................................................................... 78

Modify the OmniGroupServer configuration file ..................................................................................... 79

Modify the IDOL configuration file ........................................................................................................... 79

Start the services for OEM or Enterprise IDOL ............................................................................................. 80

C Troubleshooting ...................................................................................... 81

Troubleshooting the Workgroup Server .......................................................................................................... 81

Workgroup Server does not start .............................................................................................................. 81

Crashdump files ......................................................................................................................................... 81

Rendering module output does not appear ............................................................................................... 82

D Rendering Module Configuration .............................................................. 83

Security ............................................................................................................................................................. 83

Overview ..................................................................................................................................................... 83

Securing the print drivers ......................................................................................................................... 83

Securing the service and render monitor ................................................................................................. 84

Remote access ............................................................................................................................................. 84

Printing preferences ......................................................................................................................................... 85

Overview ..................................................................................................................................................... 85

Changing the settings ................................................................................................................................ 85

Using multiple servers ..................................................................................................................................... 85

Setup example ............................................................................................................................................ 85

All records of Record Type 3 and finalized ......................................................................................... 85

All records of Record Type 15 and registered 5 or more days ago .................................................... 86

Queuing ....................................................................................................................................................... 86

Processing ................................................................................................................................................... 86

Print verbs ......................................................................................................................................................... 86

Overview ..................................................................................................................................................... 86

Changing a print verb ................................................................................................................................ 87

E Demonstration database .......................................................................... 88

Installation and setup ...................................................................................................................................... 88

Overview ..................................................................................................................................................... 88

Setting up the demonstration database ................................................................................................... 88

Prerequisites ........................................................................................................................................ 88

Extracting the file ................................................................................................................................ 88

Setup ..................................................................................................................................................... 89

F Database and dataset maintenance tasks .................................................. 91

Overview............................................................................................................................................................ 91

Steps ............................................................................................................................................................ 91

Additional maintenance tasks after the schema has been upgraded .............................................. 92

G Automatic Deployment Tool ..................................................................... 93

Automatic deployment tool .............................................................................................................................. 93

AutoDeploy changes to the current user .................................................................................................. 94

Current user configuration ........................................................................................................................ 94

Deactivating HP TRIMAutoDeploy .......................................................................................................... 95

Applying to Group Policy .................................................................................................................... 95

Installation and Setup Guide

1 Installation and Setup Guide

Introduction

This HP TRIM software installation and setup guide describes HP TRIM software and the process of installing, upgrading, removing, configuring and backing up HP TRIM and its core components and data.

Even if you are familiar with HP TRIM from earlier versions, it is recommended you read this guide in its entirety before you set out to deploy HP TRIM.

Audience

This guide assumes you are qualified IT support personnel with extensive knowledge of

Microsoft Windows and the client server architecture and system administrator with a sound understanding of Windows Services and Group Policy.

Chapters Summary

Chapter 2 describes HP TRIM software, its architecture and components.

Chapter 3 gives a broad overview of the installation process and its requirements.

Chapter 4 contains step-by-step instructions for the different installation types.

Chapter 5 contains high level configuration options.

Chapter 6 gives an overview of backing up your HP TRIM application and data.

Appendix A lists the steps you need to take to create a working HP TRIM system.

Appendix B contains troubleshooting tips.

Related Documents

HP TRIM Specifications and Requirements TRIM7.33_Spec.pdf for system specifications and requirements

HP TRIM Enterprise Studio Help TRIMEnterpriseStudio.chm for post-installation dataset and server configuration and maintenance

• HP TRIM Help file TRIM.chm for post-installation system setup

Page

10

of

95

Installation and Setup Guide

2 About HP TRIM software

HP TRIM architecture

HP TRIM is an n-tiered application with a number of server-side components that are scalable and extensible.

An n-tiered or multi-tier application is an application that uses more than two tiers or layers between user and data.

Advantages of a multi-tier architecture:

Reduction of network traffic

Reduction of the effects caused by network latency

Reduction of the load on the database server

• Spreading of the processing workload (load balancing)

The HP TRIM architecture has a server component that you can run as a service.

Communication between the server and client is using RCF (Remote Call Framework) based on Open SSL.

An organization with multiple branches can run a wide area network (WAN) to allow functionality for all branches while centralizing management functions such as backup and disaster recovery.

The typical deployment model is to put a Workgroup Server in each branch and the database and store in a central location. The WAN then acts only as the conduit to update the metadata about documents. The Workgroup Server’s cache, other defined items and the authoritative document are stored centrally.

HP TRIM 7 contains the option to use a Workgroup Server on the database LAN for querying the dataset, whereas updates to the database would still use the Workgroup Server on the

WAN. Especially for organizations using Oracle RDBMS, this can lead to significantly better performance for searches.

Page

11

of

95

Installation and Setup Guide

Workgroup Server

The Workgroup Server is the key component in the HP TRIM architecture for:

Supporting client connectivity

Providing connections to

— primary database

— content index

— document stores

HP TRIM supports database and object replication and Workgroup Servers enable local users to connect with locally replicated databases and document stores to reduce the impact of the system on network bandwidth.

Clients connect to a named primary Workgroup Server; you can also configure a secondary

Workgroup Server for event that the connection to the primary server fails.

There is no limit to the number of Workgroup Servers within the system; you can use additional Workgroup Servers for load balancing and performance tuning to improve the speed of access to the database for remote users.

The Workgroup Server performs the following functions:

Managing connections to the database

Local caching of some of the control tables

• Local caching of documents, e-mail and other objects from the electronic document stores

Event processing

Events are actions that can be processed in bulk at specific times or continuously.

HP TRIM events include:

Document content indexing

Word indexing

Schedule event triggers

Mail notification

Audit log

Billing log

User defined events

HP TRIM Web Client

HP TRIM Web Client is a zero footprint, platform independent Web application.

Page

12

of

95

Installation and Setup Guide

Dataset

A HP TRIM dataset represents a full document and records management system with all the data elements, record objects and repositories.

The dataset consists of a database component on a Relational Database Management

System (RDBMS) and a storage component on any storage device on the network.

Each dataset exists independently of others. There is no communication or connection between datasets. You can use the client software to switch between different datasets while server components manage multiple datasets simultaneously.

The dataset contains record metadata and pointers to the electronic documents in the electronic document stores.

HP TRIM datasets are stored in a back-end database. This database contains all the information that is unique to the dataset.

HP TRIM works with SQL Server, SQL Server Express for installation for demonstrations, and Oracle.

Electronic document stores

The electronic document stores are where the electronic files are stored.

The document stores can be in any location to which you can map a UNC path.

You can also use a pool of document stores to enable handling of large amounts of data, run the store unattended for long periods of time and improve store and storage efficiency.

Documents that cannot be added to a store because of a hardware or network failure are stored in a folder to process them later using the TRIM client.

Document content index

HP TRIM can index the content of electronic documents for searching using Autonomy IDOL indexing software. While HP TRIM comes with an OEM version of IDOL, you can also use an existing implementation of Enterprise IDOL to work with HP TRIM.

See Appendix B Installing and Configuring the HP TRIM CFS Connector in this document

for installation and configuration of the TRIM CFS connector for IDOL, and HP TRIM

Enterprise Studio Help for information on configuring document content indexing.

HP TRIM client

The HP TRIM client contains all the functionality to manage the HP TRIM application including the client interfaces for end users, records managers and system administrators.

HP TRIM Desktop

TRIM Desktop enables users below administrator level to access the HP TRIM search and edit functions without having to use the full HP TRIM client.

Page

13

of

95

Installation and Setup Guide

HP TRIM thin client

The HP TRIM thin client enables you to use MS Office functions like Open and Save and HP

TRIM functions like checking in and out from MS Office applications that have been integrated with HP TRIM without having to use the HP TRIM client interface.

It is designed for users who need to use only HP TRIM integrations and none of the more sophisticated features of the HP TRIM rich client.

HP TRIMWatcher

TRIMWatcher is a process activated by a HP TRIM application and designed to monitor when files are created, modified or deleted on a client computer.

It is triggered by the HP TRIM Software Development Kit (SDK) and is resident until the client logs off the computer.

Its main purpose is to provide dynamic refresh capabilities to HP TRIM compliant applications using the SDK.

TRIMWatcher has no data recording functionality.

Once started, TRIMWatcher will continue to run until the current Windows session is closed.

Citrix launched Offline Records

HP TRIM uses a registry key to stop TRIMWatcher when a user closes Offline Records. This stops Citrix from keeping unused sessions open:

HKEY_LOCAL_MACHINE\SOFTWARE\Hewlett-Packard\HP TRIM \TopDrawer\AllowUnload

.

The value is 18000 by default, which represents milliseconds of inactivity before

trimwatcher.exe

shuts down. 18000 milliseconds are equal to six seconds.

Change this registry key to change the time trimwatcher.exe waits before it shuts down.

Page

14

of

95

Installation and Setup Guide

Relational Database Management System (RDBMS) requirements

See the HP TRIM Specifications and Limitations document TRIM7.33_Spec.pdf on the installation CD or in your installation folder for detailed RDBMS requirements.

RDBMS resource allocation and management

Ongoing dataset storage

As a rule of thumb, the space necessary to store the HP TRIM metadata should be equal to the number of records times 5000, expressed in bytes.

For example, if your site anticipates storing 100,000 items, then you will need to allocate

500MB.

However, you should allow room for growth.

Additionally, you need to allocate space to store electronic documents - for example, word processing files, e-mail messages, spreadsheets, etc. - in your document stores and for the document content index.

The space required to store electronic documents in your document stores depends on the amount of electronic document data in the dataset.

For sizing requirements for your document content index, see Document Content Index in

HP TRIM Enterprise Studio Help.

Oracle

You should identify at least one tablespace with the required storage or create a new tablespace for the express purpose of storing HP TRIM data.

You should make this tablespace the default tablespace for the account you created in RDBMS

Resource Allocation and Management

.

Microsoft SQL Server

Identify at least one filegroup with the required storage - usually the default PRIMARY filegroup - or create a new filegroup for the HP TRIM data.

While we recommend you use at least two logical storage areas - one for data and one for indexes - it is not required and you can disregard this recommendation if you choose to implement advanced storage features such as RAID.

Page

15

of

95

Installation and Setup Guide

3 HP TRIM Installation

Installation disc

You will find the installation files on the installation disc.

Disc file structure:

• HP TRIM

Install

HP TRIM installation .msi packages

Supplementary files

Note

All applications should be closed on the computer before installing HP TRIM software

• When an application that conflicts with the installation is running - for example, Microsoft Word - the installation process will either attempt to close it or display a warning message advising you to close the application.

If you are using the silent installation method, the application cannot be closed and the message to close this program will not appear. This should not be a problem, as silent installations generally run on startup and no programs will be running.

Page

16

of

95

Installation and Setup Guide

HP TRIM environment

HP TRIM is a key desktop application. By design, HP TRIM should be installed on each computer on a per-machine basis.

• HP TRIM's functionality can only be fully realized when it is integrated with other key desktop applications such as word processors, mail systems, spreadsheet applications etc.

All HP TRIM documentation assumes that you followed the recommended method of deployment

Note

Contact HP Software or your national distributor if you have difficulty installing

HP TRIM or for further explanation of any features or functions that may not be fully detailed in either the HP TRIM Installation and Setup Guide

TRIM7.33_Install.pdf

, HP TRIM Enterprise Studio Help or HP TRIM Help.

Prerequisites

For full specifications and requirements, see TRIM7.33_Spec.pdf.

To install the following HP TRIM features, you must have elevated user rights:

WebDrawer ISAPI

Web Service

Web Client

• Web Content Management (WCM)

Page

17

of

95

Installation and Setup Guide

Installation overview

1 HP TRIM Workgroup Servers a Determine the layout of your network architecture including the computers that will host the server components of HP TRIM

Note

All required components of HP TRIM are installed on each computer for component recognition.

During installation, the administrator determines the components to install on each target computer - for example, the Workgroup Server component only on the

Workgroup Servers and the client components only on client computers.

It depends on the network environment which components to install on each computer. b Ensure that HP TRIM supports the server operating system and that it has all the necessary components installed.

See TRIM7.33_Spec.pdf. c

Ensure you have the correct RDBMS client software.

See RDBMS requirements .

d Determine the kind of electronic stores to set up:

– Windows File System

– FTP – not recommended

– Integrated Archive Platform

Also decide whether to use document store pooling or nominated stores.

In the HP TRIM Help file, see Creating Document Stores.

2 Network settings a Create the new domain user HP TRIM uses to create the database and run the

Workgroup Servers.

Typically, this is TRIMServices. See Network user group and the TRIMServices account .

b Add the user to the Workgroup Servers

Note

This account must be a member of the local administrators group and should also have Log on as a Service policy rights. c Create and add a user with full access permissions to the administration group for your RDBMS d Create a domain group - the HP TRIM user group - and add all the network users that require access to HP TRIM, e.g. TRIMUsers

Page

18

of

95

Installation and Setup Guide e Install the HP TRIM components on the appropriate servers.

Find instructions for installing and enabling the components of HP TRIM in

Network installation .

f Using HP TRIM Enterprise Studio, create the HP TRIM dataset.

See HP TRIM Enterprise Studio Help – Creating datasets. g Add the account to your HP TRIM dataset as Location.

User type Administrator with Top security and All Caveats profile is recommended.

In HP TRIM Help, see Creating Locations. h Register the HP TRIM Server components as Windows Services.

See Network Users Group and the TRIMService Account .

Note

For ease of administration, maintenance and secure access, it is recommended you install the HP TRIM components as Windows Services

3 HP TRIM client a Ensure the client computer has a supported operating system and all the necessary components installed.

See TRIM7.33_Spec.pdf. b Install HP TRIM on the client computer c

Create the user as a HP TRIM Location in the dataset.

In HP TRIM Help, see Creating Locations.

64-bit installation

Install HP TRIM in 64-bit environments using the same instructions as for 32-bit environments.

On a 64-bit operating system, 64-bit HP TRIM installs to C:\Program Files.

On a 64-bit operating system, 64 bit HP TRIM uses the same part of the registry as an installation in a 32-bit environment, e.g. HKEY_LOCAL_MACHINE\Software\Hewlett

Packard

\...

Page

19

of

95

Installation and Setup Guide

Installing HP TRIM

You can run the installation manually or automated using Group Policy or batch files.

Both full and Service Pack .msi files enable you to install HP TRIM:

over a network – see Network installation

locally – see Installation dialog boxes

Installing without using Group Policy

1 Click Start, point to All Programs, and then click Accessories.

2 Right-click Command Prompt and then click Run as administrator.

3 Type msiexec.exe /i “<file path>\HPTRIM_xNN.msi” with the correct .msi file name and press Enter

4

Continue the installation from Installation dialog boxes

Page

20

of

95

Installation and Setup Guide

4 Installation types

Network installation

This is the most common installation for most organizations.

Network installation prerequisites

A system administrator with a sound understanding of Windows Services

• You must have administrator or elevated access rights for the target computers

Note

The domain account running the HP TRIM Server requires the Log on as

Service

access permission if it is configured as Windows Service

HP TRIM software is an essential desktop application and therefore, you should install it on a per-machine basis using Group Policy.

Network installation steps

1

Follow the steps in Administrative installation

2

Follow the steps in Group Policy

-- or –

Follow the steps in Batch file installation

3

After completing the installation, continue setup by working through Appendix A Steps to setting up a working system

Page

21

of

95

Installation and Setup Guide

Administrative installation

Overview

1 Perform an administrative installation and set the desired properties using the administrative installation dialog boxes

2 Using Group Policy, use the .msi file that was saved to the administrative install point to install HP TRIM on the target computers.

If you are not using Group Policy, use a batch file to run the .msi file which was copied to the administrative installation point.

This file will use the properties you selected during the administrative installation.

Administrative installation steps

1 Install the relevant Microsoft Visual C++ 2005 Redistributable Package

vcredist_x86.exe

or _x64.exe using your own rollout strategy

2 Install VBRuntimes_x86.msi using your own rollout strategy.

This step is not necessary for 64-bit installations.

3 Install VS2008Runtimes_xNN.msi using your own rollout strategy

4 Use the Windows Run function and type msiexec.exe /a followed by the path to the .msi installation file

For example, msiexec.exe /a "C:\Users\<username>\Desktop\HPTRIM_x86.msi"

<targetdirectory>

The target directory should follow the format \\server\path.

The Administrative Installation dialog appears:

Network installation point - type or browse for the folder to save the administrative installation files to

Page

22

of

95

Installation and Setup Guide

Note

It depends on the options you select in each screen which dialog boxes appear.

Follow the on-screen instructions as the steps here are just an example of an administrative installation process.

5 Click Next.

The Select Features dialog appears.

By default, all features are selected.

See Select Features

for details.

6 Click Next.

The HP TRIM Default Connection Settings dialog appears.

7 Set up your default Workgroup Server connection and click Next.

The HP TRIM Client Configuration dialog appears.

8 Choose the installation options for the HP TRIM client and click Next.

The HP TRIM Server Configuration dialog appears.

9 Enter the server configuration details, if needed, and click Next.

The Existing Web Sites on the Server dialog box appears if you are installing

WebDrawer ISAPI:

10 Fill in the fields:

Web Site Description

Web Site Port Number

Web Site IP

Web Site Header Information

Page

23

of

95

Installation and Setup Guide

11 Click Next.

The Administrative Installation Verify Ready dialog appears:

12 Click Next to create the installation package.

Once completed, the confirmation dialog appears.

13 Click Finish to complete the administrative installation.

Group Policy installation

1

You must have carried out the steps described in Administrative installation before

installing HP TRIM through Group Policy.

2 Use Group Policy to install the configured .msi package on the target computers: a HP TRIM Workgroup Servers b HP TRIM clients

Note

One advantage of a Group Policy rollout is that the installation runs with elevated access rights on the target computer and all repairs or modifications to the installation on the target computer run with elevated access rights.

Page

24

of

95

Installation and Setup Guide

Batch file installation

Note

Batch file installation is an option to install HP TRIM software instead of using

Group Policy.

You do not need to use batch file installation if you are using Group Policy

installation as described in Group Policy installation

1

You must have carried out the steps described in Administrative installation before

installing HP TRIM through a batch file.

2 Create a batch file according to the installation requirements for the client computers.

The HP TRIM .msi installation does not support a parameter file; therefore, you must set each property that you want to install on the command line.

3 Run the batch file on the target computer.

HP TRIM installs with the features you selected.

Note

Batch file installations of HP TRIM cannot ensure that the target computer has

Group Policy set so that installations run using elevated access rights.

If the installation does not use elevated access rights at all or only for the installation and not for any post-installation tasks, then these tasks may not complete correctly, for example, self-repair.

If elevated access rights are not available for the target computer, it is recommended that either:

All users logging on to that computer have sufficient access permissions to perform installation tasks, including writing and deleting files to the

Program Files

and System32 folders and writing to the registry.

-- or --

You make the installation functions in the Windows Control Panel

Programs and Features

function unavailable.

This will prevent users from performing repairs or modifications to the installation.

Page

25

of

95

Installation and Setup Guide

Batch file parameters

When you are using a batch file to install HP TRIM, all installation parameters must be in a single line.

Examples

The sample batch files show all the variables. You can copy it to have a working batch file - although you may have to change paths, network information etc: x64 installation batch file

Rem ADDLOCAL lists the features you want installed. The example below lists all available features

Rem These properties only need to be included if you are installing Webdrawer

ISAPI and only the first two are mandatory:

Rem WEBSITE="Default Web Site"

Rem WEBSITE_PORT="80"

Rem WEBSITE_IP

Rem WEBSITE_HEADER

Rem If using Novell then use the property NOVTREE to set the Novell tree name.

Rem /l*vx "C:\Users\stevel\Desktop\InstallBatch.txt" :-logs the install verbosely to the location defined by the path set

Rem INSTALLDIR defines the path to which HP TRIM will be installed

Rem If you want to use user-specific paths (eg C:\Users\fred\AppData\Hewlett-

Packard\HPTRIM for user Fred and C:\Users\john\AppData\Hewlett-Packard\HPTRIM for user John) leave USER_LEX_FOLDER, CLIENT_APPDATA_FOLDER,

CLIENT_LOCAL_APPDATA_FOLDER and OFFLINE_DATA_FOLDER out of the command line.

Rem If you want to use paths that are not user-specific for USER_LEX_FOLDER,

CLIENT_APPDATA_FOLDER, CLIENT_LOCAL_APPDATA_FOLDER and OFFLINE_DATA_FOLDER then include these properties as shown in the example below. Warning: If you use a common directory for these paths such as C:\Offline, documents checked out by one user may be visible to other users of that computer. This is not

recommended. It does allow setting of a personalised H: drive, however.

"C:\Users\Username\Desktop\HPTRIM_x64.msi" /q /l*vx

"C:\Users\Username\Desktop\InstallBatch.txt" INSTALLDIR="C:\Program

Files\Hewlett-Packard\HP TRIM\"

ADDLOCAL=HPTRIM,Client,StandardData,Server,TRIMWORKGROUP,TRIMENTERPRISESTUDIO,

IDOLSERVICES,WebdrawerISAPI,TRIMRENDER

SERVER_DATA_FOLDER="C:\HPTRIM\ServerData"

SERVER_LOCAL_DATA_FOLDER="C:\HPTRIM\ServerLocalData"

IDOL_LOG_FOLDER="C:\HPTRIM\IDOL" WGS1="PrimaryWorkGroupName"

WGS2="SecondaryWorkGroupName" WINDOMAIN="1" DOMAINNAME="domain"

SERVICEUSER="serviceusername" SERVICEPASS="serviceuserpassword"

WEBSITE="Default Web Site" WEBSITE_PORT="80" DEFAULTDBNAME="DemoDB"

DEFAULTDB="45" PORTNO="1137" LANG="EN" TRIM_DSK="1" EMAIL="TIO" TRIMREF="DSK"

EXCEL_ON="1" PROJECT_ON="1" POWERPOINT_ON="1" WORD_ON="1" STARTMENU_NAME="HP

TRIM" AUTOGG="1" USER_LEX_FOLDER="H:\UserLex"

CLIENT_APPDATA_FOLDER="H:\Appdata"

CLIENT_LOCAL_APPDATA_FOLDER="H:\LocalAppData" OFFLINE_DATA_FOLDER="H:\Offline"

Page

26

of

95

Installation and Setup Guide x32 installation batch file

Rem ADDLOCAL lists the features you want installed. The example below lists all available features

Rem These properties only need to be included if you are installing

WebdrawerISAPI and only the first two are mandatory:

Rem WEBSITE="Default Web Site"

Rem WEBSITE_PORT="80"

Rem WEBSITE_IP

Rem WEBSITE_HEADER

Rem If using Novell then use the property NOVTREE to set the Novell tree name.

Rem /l*vx "C:\Users\Username\Desktop\InstallBatch.txt" logs the install verbosely to the location defined by the path set

Rem INSTALLDIR defines the path to which HP TRIM will be installed

Rem If you want to use user-specific paths (eg C:\Users\fred\AppData\Hewlett-

Packard\HPTRIM for user Fred and C:\Users\john\AppData\Hewlett-Packard\HPTRIM for user John) leave USER_LEX_FOLDER, CLIENT_APPDATA_FOLDER,

CLIENT_LOCAL_APPDATA_FOLDER and OFFLINE_DATA_FOLDER out of the command line.

Rem If you want to use paths that are not user-specific for USER_LEX_FOLDER,

CLIENT_APPDATA_FOLDER, CLIENT_LOCAL_APPDATA_FOLDER and OFFLINE_DATA_FOLDER then include these properties as shown in the example below. Warning: If you use a common directory for these paths such as C:\Offline, documents checked out by one user may be visible to other users of that computer. This is not

recommended. It does allow setting of a personalised H: drive, however.

"C:\Users\Username\Desktop\HPTRIM_x86.msi" /q /l*vx

"C:\Users\Username\Desktop\InstallBatch.txt" INSTALLDIR="C:\Program

Files\Hewlett-Packard\HP TRIM\"

ADDLOCAL=HPTRIM,Client,StandardData,TRIMSCAN,Lotus,TRIMPORT,Server,TRIMWORKGRO

UP,TRIMENTERPRISESTUDIO,IDOLSERVICES,WebdrawerISAPI,TRIMRENDER

SERVER_DATA_FOLDER="C:\HPTRIM\ServerData"

SERVER_LOCAL_DATA_FOLDER="C:\HPTRIM\ServerLocalData"

IDOL_LOG_FOLDER="C:\HPTRIM\IDOL" WGS1="PrimaryWorkGroupName"

WGS2="SecondaryWorkGroupName" WINDOMAIN="1" DOMAINNAME="domain"

SERVICEUSER="serviceusername" SERVICEPASS="serviceuserpassword"

WEBSITE="Default Web Site" WEBSITE_PORT="80" DEFAULTDBNAME="DefaultDB"

DEFAULTDB="45" PORTNO="1137" LANG="EN" TRIM_DSK="1" EMAIL="TIO" TRIMREF="DSK"

ODMA="TRIM" ODMALOCAL="1" EXCEL_ON="1" PROJECT_ON="1" POWERPOINT_ON="1"

WORD_ON="1" STARTMENU_NAME="HP TRIM" AUTOGG="1" USER_LEX_FOLDER="H:\UserLex"

CLIENT_APPDATA_FOLDER="H:\Appdata"

CLIENT_LOCAL_APPDATA_FOLDER="H:\LocalAppData" OFFLINE_DATA_FOLDER="H:\Offline"

The parameters and values:

Application parameters

Client parameters

Integration parameters

Page

27

of

95

Installation and Setup Guide

Application parameters

STARTMENU_NAME

– the name of the shortcut to HP TRIM in the Windows Start menu.

Default: HP TRIM.

USER_LEX_FOLDER

– the installation location of the HP TRIM user dictionary – see

note below

CLIENT_APPDATA_FOLDER

– the location of HP TRIM data files – see note below

CLIENT_LOCAL_APPDATA_FOLDER

– the location of HP TRIM data files see note

below

OFFLINE_DATA_FOLDER

– the location of HP TRIM offline data files – see note below

Note

To use user-specific paths (e.g. C:\Users\fred\AppData\Hewlett-Packard\HPTRIM for user Fred and C:\Users\mary\AppData\Hewlett-Packard\HPTRIM for user

Mary), leave USER_LEX_FOLDER, CLIENT_APPDATA_FOLDER,

CLIENT_LOCAL_APPDATA_FOLDER

and OFFLINE_DATA_FOLDER out of the command line.

To use paths that are not user-specific for USER_LEX_FOLDER,

CLIENT_APPDATA_FOLDER

, CLIENT_LOCAL_APPDATA_FOLDER and

OFFLINE_DATA_FOLDER

, include these properties as shown in the example batch files above.

Use ADDLOCAL to install HP TRIM features, separated by commas:

HPTRIM

– HP TRIM

Client

– client features

TRIMSCAN

– HP TRIMScan

Lotus

– HP TRIM Lotus Notes integration

StandardData

– standard HP TRIM sample data

TRIMPORT

– HP TRIMPort

Server

– server features

TRIMWORKGROUP

– HP TRIM Workgroup Server

TRIMENTERPRISESTUDIO

– HP TRIM Enterprise Studio

IDOLSERVICES

– IDOL OEM version

TRIMRENDER

– HP TRIM Rendering module

WebdrawerISAPI

– WebDrawer ISAPI extension

Page

28

of

95

Installation and Setup Guide

Client parameters

WGS1

– primary Workgroup Server name

WGS2

- secondary Workgroup Server name

PORTNO

– Workgroup Server port number

WINDOMAIN

– the type of network HP TRIM will run on

0

– Novell network

1

– Windows domain - default

DOMAINNAME

– domain name

NOVTREE

– the name of the Novell tree to use when resolving the HP TRIM login name

SERVICEUSER

– user name

<domainname>\<username>

SERVICEPASS

– user password

INSTALLDIR

– installation folder with path

C:\Program Files\Hewlett-Packard\HP TRIM

is default

SERVER_DATA_FOLDER

– Workgroup Server data path

By default, C:\HPTRIM\ServerData\

SERVER_LOCAL_DATA_FOLDER

- Workgroup Server local data path

By default, C:\HPTRIM\ServerLocalData\

IDOL_LOG_FOLDER

– path for IDOL log files

By default, C:\HPTRIM\IDOL

LANG

- client language

EN

- English (International), default

US

- English (US)

FR

- French

NL

- Dutch

DE

- German

IT

- Italian

ES

– Spanish

TRIMREF

– application to use for HP TRIM reference files (*.tr5)

TRIM

– HP TRIM

DSK

– HP TRIM Desktop

TRIM_DSK="1"

– installs desktop shortcuts.

Leave out the parameter to not install the desktop shortcuts.

Page

29

of

95

Installation and Setup Guide

Integration parameters

EMAIL

– e-mail integration

TIO

– HP TRIM in Outlook

GW

– HP TRIM in GroupWise

Leave out the parameter for no e-mail integration.

ODMA

- ODMA integration

TRIM

– HP TRIM

DSK

– HP TRIM Desktop

Leave out the parameter for no ODMA integration.

ODMALOCAL

– local ODMA behavior

0

– no access to Windows FileOpen and Save dialogs

1

– enables access to Windows FileOpen and Save dialogs

EXCEL_ON

– Microsoft Office Excel integration

1

– turns on Excel integration.

No value (″″) – no integration

PROJECT_ON

– Microsoft Office Project integration

1

– turns on Project integration.

No value (″″) – no integration

POWERPOINT_ON – Microsoft Office PowerPoint integration

1

– turns on PowerPoint integration.

No value (″″) – no integration

WORD_ON

– Microsoft Office Word integration

1

– turns on Word integration

No value (″″) – no integration

Page

30

of

95

Installation and Setup Guide

Thin client

Thin client installation prerequisites

The prerequisites are the same as those of the rich client using a network installation.

See Network installation .

Installing HP TRIM thin client

To install the HP TRIM thin client, you must use a batch file installation as described in

Batch file installation by using HPTRIM_x86.msi for a 32-bit installation or HPTRIM_x64.msi

for a 64-bit installation.

The batch file must contain certain parameters that are exclusive to the thin client installation. The commands must be on a single line or else you should use line continuation characters (^). It is recommended you use the example batch file below and edit it as required:

Rem Command Line for Thin Client installation

"C:\Users\Username\Desktop\HPTRIM_x86.msi" /q /l*vx C:\temp\InstallBatch.txt

INSTALLDIR="C:\Program Files\Hewlett-Packard\HPTRIM\" TRIMTHINCLIENT="1"

OFFSHORT_ON="1" EXCEL_ON="1" PROJECT_ON="1" POWERPOINT_ON="1" WORD_ON="1"

WGS1="SLWin7En" WINDOMAIN="1" DEFAULTDBNAME="DemoDB" DEFAULTDB="45" PORTNO="1137"

EMAIL="TIO"

You may have to edit:

Path and name of the .msi file

Path and name of the log file. The sequence /l*vx C:\InstallBatch.txt creates the log file

InstallBatch.txt

in its path.

Other properties as required

For installations under other versions of Microsoft Office, see additionally Utility

TRIMThinClientSetup.exe

.

TRIMTHINCLIENT

- activates the thin client installation

EXCEL_ON – Microsoft Office Excel integration

1

– turns on Excel integration.

No value (″″) – no integration

PROJECT_ON

– Microsoft Office Project integration

1

– turns on Project integration.

No value (″″) – no integration

POWERPOINT_ON

– Microsoft Office PowerPoint integration

1

– turns on PowerPoint integration.

No value (″″) – no integration

WORD_ON – Microsoft Office Word integration

Page

31

of

95

Installation and Setup Guide

1

– turns on Word integration

No value (″″) – no integration

OFFSHORT_ON

– installs the shortcut TRIM – Office Integration in the Start menu with

Office 2007

EMAIL

– e-mail integration

TIO

– HP TRIM in Outlook

When there is no need for MS Outlook integration installation, just leave the property out of the batch file.

Note

With a thin client batch file installation, you should not use the property

ADDLOCAL

.

1

Follow the steps under Administrative installation

2

Follow the steps under Batch file installation by using the batch file described in

Installing HP TRIM thin client .

HP TRIM thin client installs without user interaction.

3

Verify the installation by checking that HP TRIM is installed in the folder you specified in the batch file.

Repairing a thin client installation

1 To repair a HP TRIM thin client installation, use a command prompt with elevated user rights and enter a line similar to this example with parameters appropriate to your environment:

"C:\Users\Username\Desktop\HPTRIM_x86.msi" /q /l*vx C:\temp\RepairBatch.txt

TRIMTHINCLIENT="1" MaintenanceMode="Repair"

HP TRIM attempts to restore HP TRIM thin client to its default settings.

Page

32

of

95

Installation and Setup Guide

Upgrading a thin client installation

You can upgrade any HP TRIM 7 thin client installation to a HP TRIM rich client installation.

However, you cannot modify a HP TRIM rich client installation to a thin client installation.

1 To upgrade a HP TRIM thin client installation, use a command prompt with elevated user rights and enter a line similar to this example with parameters appropriate to your environment:

"C:\Users\Username\Desktop\HPTRIM_x86.msi"

The Application Maintenance dialog appears.

2

Follow the steps under Modify to select features and complete the upgrade

Removing a thin client installation

1

To remove a HP TRIM thin client installation, use a command prompt with elevated user rights and enter a line similar to this example with parameters appropriate to your environment:

"C:\Users\Username\Desktop\HPTRIM_x86.msi"

The Application Maintenance dialog appears.

2

Follow the steps under Remove to remove the installation

Utility TRIMThinClientSetup.exe

This stand-alone application is required for certain environments with versions of Microsoft

Office before Office 2007 for integration with HP TRIM to work correctly. It ensures that the

Office add-ins are registered as expected.

It also enables you to change the thin client settings after installation in these environments, or to repair the settings when the thin client installation did not work correctly. It is in the

HP TRIM installation folder.

Thin client installations under MS Office 2007 or later should work without this utility.

1 When you run it, a dialog box appears with the options:

Integrate HP TRIM with the following Microsoft Office applications:

Microsoft Word

Microsoft Excel

Microsoft PowerPoint

Microsoft Project

Microsoft Outlook

2

Select the applications to integrate the HP TRIM thin client with and click Test to test the integration

3 Click OK when the test is successful

Page

33

of

95

Installation and Setup Guide

Using Autonomy iManage Universal Search (IUS) with TRIM

IUS is available under a separate license and installation. By using components that are supplied with your HP TRIM installation files, it can be set up to search HP TRIM data.

IUS enables you to search across separate HP TRIM datasets. As it is a universal search engine, it can display HP TRIM data in search results along with results from other data sources, including metadata-only paper records.

IUS can enhance the search results from HP TRIM Web client to:

Enable preview of electronic records including hit highlighting

• Display record metadata to perform further actions on the record

Setting up IUS to work with HP TRIM

After you have successfully installed an IUS instance in your environment, make these changes to your IUS files and file structure to improve the level of integration with HP

TRIM. You will find the files from the instructions on your HP TRIM installation disc packaged as iUS.zip in the folder Additional Installations.

After you have made these changes, you can use IUS with HP TRIM.

ius.properties

1 In your copy of the file, insert a key for configParams.trimUrls. It should be set to the database ID and the HP TRIM Web client URL. You can separate multiple datasets or

Web client pairs with a vertical bar ( | ).

Example: configParams.trimUrls=45 http://192.168.0.1/hptrimwebclient//|46

http://192.168.0.2/hptrimwebclient/

datasources.xml

datasources.xml

is located in the folder Program Files

(x86)\Autonomy\UniversalSearch\Webroot\config\ius\

.

1 From the HP TRIM installation disc, open the file datasources.xml

2 From the section starting with <datasource id="ius" extends=”base”>, copy all terms from the <parameter id=”PrintFields”> that are missing and paste them into your copy of

datasources.xml

3 From the section starting with <datasource id="search" extends=”ius”>, copy all terms from the <parameter id=”queryString”> that are missing and paste them into your copy of datasources.xml

4 Copy the sections <datasource id=”recordsTab” extends=”search”> and <datasource

id=”TRIM_45” extends=resultItem”>

and paste them into your copy of datasources.xml.

Replace TRIM_45 with your HP TRIM dataset identifier.

5 Save the changes to your file

Page

34

of

95

Installation and Setup Guide

custom.js and custom.css

1

From your HP TRIM installation disc, copy the file custom.js and custom.css and add them to the folder Program Files (x86)\Autonomy\UniversalSearch\Webroot\includes\.

If there is already a file called custom.js, then add the code from the HP TRIM supplied copy to your copy instead.

Folder json\trim

1 From your HP TRIM installation disc, copy the folder and its content json\trim and save it to \Program Files (x86)\Autonomy\UniversalSearch\Webroot\config\ius\views\json\.

Captions.xml

1 From your HP TRIM installation disc, open the file Captions.xml, copy the code for the

HP TRIM caption group that starts with <group id="TRIM_45">, insert it in your copy of

Captions.xml

and save it

Folder lib\

1

From your HP TRIM installation disc, copy the folder lib and its content and save it to

\Program Files (x86)\Autonomy\UniversalSearch\Webroot\core\lib\

Page

35

of

95

Installation and Setup Guide

Maintenance installation

Use a maintenance installation to change the installed features.

1 Click Start, point to All Programs, and then click Accessories.

2 Right-click Command Prompt and then click Run as administrator.

Type msiexec.exe /i “<file path>\HPTRIM_xNN.msi” with the correct .msi file name and press Enter.

The Application Maintenance dialog box appears:

1 Select one of the options and click Next:

Repair

- see Repair

Remove

- see Remove

Modify

- see Modify

Page

36

of

95

Installation and Setup Guide

Repair

Repair re-installs only the features which were selected during the installation or the latest modification to the installation.

If you have HP TRIM Servers running as services, then you will need to re-type the user password for the services to be re-installed correctly.

Repairing an installation

1

In the Application Maintenance dialog box, select Repair and click Next.

The Ready to Install the Application dialog box appears.

2 Click Next to start the repair.

The dialogue HP TRIM has been successfully installed

appears.

3 Click Finish.

The HP TRIM installation has been repaired.

Remove

Remove

removes HP TRIM from your computer.

Before removing HP TRIM, see Removing HP TRIM .

Removing an installation

1

In the Application Maintenance dialog box, select Remove and click Next.

2 The HP TRIM Uninstall dialog box appears:

3 Click Next to uninstall HP TRIM

4 Follow the on-screen instructions.

The dialogue HP TRIM has been successfully installed appears.

5 Click Finish.

The HP TRIM installation has been removed from the computer.

Page

37

of

95

Installation and Setup Guide

Modify

Modify enables you to add or remove HP TRIM features.

It will only add or remove the features you choose. It will not perform a full reinstallation.

You must use the command prompt to run the .msi file as described in Maintenance installation .

Modifying an installation

1

In the Application Maintenance dialog box, select Modify and click Next.

2

The Select Features dialog box appears.

3 Select the features you want to install

4 Click Next.

5

The HP TRIM Server Configuration dialog box appears.

6 Fill in the details and click Next.

The Click Next to begin installation dialog box appears.

7 Click Next to complete the modification.

The dialog HP TRIM has been successfully installed appears.

8 Click Finish.

The HP TRIM installation has been modified.

Page

38

of

95

Installation and Setup Guide

Installation dialog boxes

This section describes the dialog boxes that appear during a graphical installation.

The order in which the dialog boxes appear depends on the features you select. Therefore, this section is a listing rather than step-by-step instructions.

1 When you run the HP TRIM installation locally, the Welcome dialog appears:

2

Click Next.

The License Agreement dialog appears:

3 Select I accept the license agreement and click Next.

Page

39

of

95

Installation and Setup Guide

The Destination Folder dialog appears.

Destination Folder

– click Browse to change the folder to install HP TRIM in.

The default is C:\Program Files\Hewlett-Packard\HP TRIM.

Start Menu Shortcut Name

– HP TRIM on your computer’s Start menu

4 Click Next.

The Select Features dialog appears:

The installation options for each feature:

Will be installed on local hard drive

Entire feature will be installed on local hard drive

Entire feature will be unavailable

Page

40

of

95

Installation and Setup Guide

5 Select the features to install:

HP TRIM

Default: Will be installed on local hard drive.

Client

- client features.

Default: Will be installed on local hard drive.

Standard Data

– installs standard report layouts, noise words, post codes, samples for desktop integration.

Includes standard report layouts, Australian noise words and postal codes import files and Web publish layouts for importing. Recommended to install.

Default: Will be installed on local hard drive.

TRIMScan –

installs a scanning application which enables you to scan documents, images etc. and check them directly in to HP TRIM.

Not available for 64-bit installation.

Lotus Notes Integration

- select to integrate HP TRIM with Lotus Notes mail clients.

Default: Entire feature will be unavailable.

Lotus Notes files are installed in the folder HP TRIM\Lotus.

Not available for 64-bit installation.

TRIMPort

- installs HP TRIM's data import/export utility.

Recommended for HP TRIM administrators only.

Default: Entire feature will be unavailable.

Not available for 64-bit installation.

Because it is not included in newer operating systems, after installation under Windows 7 or Windows Server 2008 and before running TRIMPort, register the file COMCT232.ocx: a. Run a Windows command prompt as administrator b. Enter CD\Windows\System32 and press Enter c. Enter regsvr32 comct232.ocx and press Enter

If the second command does not complete successfully, you may need to install software like RegUnreg to complete the registration.

If you do not register this file, TRIMPort displays the message Component

'COMCT232.OCX' or one of its dependencies not correctly registered: a file is missing or invalid.

and does not run correctly.

Page

41

of

95

Installation and Setup Guide

Server

Workgroup Server

- installs and registers a HP TRIM Workgroup Server on this computer.

Default: Will be installed on local hard drive.

Workgroup Servers do the bulk of the work in a networked installation of HP

TRIM and should be positioned in your network to provide distribution of load.

Enterprise Studio

- installs utility to manage HP TRIM Workgroup Servers, datasets and the operating environment.

It is recommended for HP TRIM administrators only.

Default: Will be installed on local hard drive.

IDOL Services

– installs services that are required for document content indexing (DCI) using OEM IDOL.

Default: Will be installed on local hard drive.

WebDrawer ISAPI Extension

- installs the WebDrawer ISAPI components.

WebDrawer provides read-only Web access to HP TRIM.

Default: Entire feature will be unavailable.

TRIM Render

- installs a utility to render documents and add the rendition to the record in a fully automated process.

This module is available under a separate license.

Default: Entire feature will be unavailable.

Note

Before choosing to install TRIM Render, ensure the following:

• Your system meets the requirements for the module as specified in

TRIM7.33_Spec.pdf

You have your HP TRIM dataset connection information for the HP TRIM

Default Connection Settings

dialog box, which you will need to enter during the installation process

You use the TRIMServices account or equivalent to install and run TRIM

Render to ensure access to important HP TRIM functions like the document stores

After installing TRIM Render initially, follow the instructions in Appendix C to

configure the printer drivers, security settings and to find information on multiple server installations.

Disk Usage

- displays the HP TRIM Setup dialog

Reset

- sets all the above options to their defaults

Page

42

of

95

Installation and Setup Guide

6 Click Next.

The order in which the next dialog boxes appear depend on the features you selected and whether they are needed:

The HP TRIM Default Connection Settings dialog box:

Use this dialog to set up your HP TRIM client to Workgroup Server default connection settings.

You can change these settings using the HP TRIM client.

Default Database ID

- the unique identifier for the dataset to which the client should connect.

This identifier is set when you create the dataset.

Note

Lower case characters are not supported for the dataset ID; always use upper case characters.

Default Database Name

– name of database, for example, companyDB

Primary Workgroup Server

– name of the computer that runs the Workgroup Server to which the client should connect

Secondary Workgroup Server

– name of the computer that runs the Workgroup

Server to which the client should connect if it cannot connect to its primary

Workgroup Server after three attempts.

Port Number

– port the client should use to connect to the Workgroup Server

Page

43

of

95

Installation and Setup Guide

Note

The Primary and Secondary Workgroup Server fields are for the HP TRIM client to search for a backup secondary Workgroup Server in case the primary

Workgroup Server is unavailable due to server failure, maintenance, etc.

HP TRIM switches to the secondary Workgroup Server seamlessly after a short delay when the primary one is not available.

When the secondary Workgroup Server fails and the primary one is available again, HP TRIM will switch back to the primary Workgroup Server.

If both Workgroup Servers are unavailable, HP TRIM will display a message that the Workgroup Server is unavailable.

The addresses in the two fields should not point to two different datasets.

The HP TRIM Client Configuration dialog box:

Use this dialog to set up the HP TRIM client.

You can change these settings using the HP TRIM client.

File Association

- select the type of HP TRIM client to use to open HP TRIM reference (.tr5) files

HP TRIM Desktop

- HP TRIM Desktop

HP TRIM

- HP TRIM client

E-mail Integration

- select the type of e-mail integration to use with HP TRIM.

Lotus Notes is not listed as it requires additional software to be installed.

No E-mail Integration

Microsoft Outlook

- HP TRIM in Outlook

Novell GroupWise

- enables HP TRIM File menu commands in Novell

GroupWise

Page

44

of

95

Installation and Setup Guide

ODMA Integration

– HP TRIM can integrate with ODMA (Open Document

Management API) applications.

Not available for 64-bit installation.

Select the type of HP TRIM client to use when integrating with ODMA compliant applications:

No ODMA Integration

- no ODMA integration

Integrate HP TRIM with all ODMA compliant applications

- installs the

ODMA integration functions for HP TRIM Desktop

Use ODMA directly with HP TRIM

– select to set HP TRIM to not use Offline

Records integration

Allow access to Windows File Open and Save Dialogs

- enables users to navigate to the standard File Open and File Save dialogs from ODMA applications.

To force users to save to Offline Records or HP TRIM, do not select this option.

Install the Desktop shortcuts for HP TRIM

– select to install shortcuts in the

Desktop

folder for:

– HP TRIM client

– HP TRIM Desktop

– HP TRIM Queue Processor

Automatically Get Global Settings on first startup of TRIM

– select for the HP TRIM client to download TRIM global settings when HP TRIM runs for the first time

Page

45

of

95

Installation and Setup Guide

The HP TRIM Client Folder Settings dialog:

Use this dialog to customize some of the file paths HP TRIM uses:

User Dictionary Path

– user dictionary for spelling checks. By default, this field is blank, which makes HP TRIM use the user’s AppData folder. The path must point to a folder that is unique to the user and it is recommended not to change it.

Client Application Data Path

– path to the user's HP TRIM configuration. By default, this field is blank, which makes HP TRIM use the user’s AppData folder. The path must point to a folder that is unique to the user and it is recommended not to change it.

Client Local Application Data Path

– path to the client document cache. By default, this field is blank, which makes HP TRIM use the user’s LocalAppData folder. The path must point to a folder that is unique to the user and it is recommended not to change it.

Offline Folders Path

– location of the user’s Offline Records folder. By default, this field is blank, which makes HP TRIM use the user’s Documents folder. The path must point to a folder that is unique to the user and it is recommended not to change it.

Note

By design, HP TRIM Offline Records is intended for deployments where the

Offline Records folder is located on the Windows client computer, in the user's profile folders. Although it is possible to modify this configuration to locate Offline

Records in a different location such as a network drive, such a configuration may have a negative impact on performance and reliability of the check-in/check-out function of Offline Records due to environmental network and/or network file system issues and limitations, e.g. file name length restrictions on some Novell file server operating systems, that are beyond the control of HP TRIM. For this reason, HP recommends not changing the default location of Offline Records.

Page

46

of

95

Installation and Setup Guide

The HP TRIM Server Configuration dialog:

Note

Use this dialog to set up your HP TRIM Server configuration.

You do not need to use these settings if you are configuring HP TRIM to run only as a client

• You cannot change these settings using the HP TRIM client

HP TRIM uses the information from this dialog to configure the access permissions set up in your HP TRIM environment and provide the necessary access to users.

The HP TRIM Workgroup Server and WebDrawer Web Server are installed and registered as Windows Services.

The account to run the services is the TRIMServices account.

It depends on the installation method you are using which options are available in this dialog.

Network Type

- select the type of network you are installing HP TRIM on:

Windows Domain

- default

Novell Network

Novell Tree

- for a Novell network, enter the Novell tree to which this computer is connected.

HP TRIM will use this tree for Novell login name resolution.

Note

For a Novell network, the Network Type field defaults to Novell Network and the dialog also contains a Novell Tree field.

Page

47

of

95

Installation and Setup Guide

Domain Name

- for a Windows domain, enter the domain name on which the HP

TRIM services will be running.

HP TRIM appends it to the user name below to create the path

domainname\username

, under which HP TRIM services will run, for example,

mydomain\TRIMServices

Note

If you intend to use a local user to run your services: a Type the name of your computer in the Domain Name field b Specify a local user in the User Name field to run your HP TRIM Services

User Name

- type the name of the user you wish to use to run the HP TRIM services under - usually TRIMServices.

The HP TRIM Workgroup Service and WebDrawer Service log on with this user name.

The user you enter here should have Log on as a Service policy rights on the computer and sufficient permissions to run a Windows Service.

This user also has access permissions to the HP TRIM Workgroup Server.

User Password

- type the password for the TRIMServices domain account user name

Server Data Folder

– server data folder.

It is recommended to keep the default, which is C:\HPTRIM\ServerData.

Server Log Files Folder

– folder for the server log files.

It is recommended to keep the default, which is C:\HPTRIM\ServerLocalData.

IDOL Log Files Folder

– folder for the OEM IDOL Server log files.

It is recommended to keep the default, which is C:\HPTRIM\IDOL. HP TRIM creates the folders TRIM Content Service [number] and TRIM IDOL Service in this location, which contain the logs folders.

The Existing Web Sites on this Server dialog box appears if you are installing

WebDrawer ISAPI.

Select the Web site to install WebDrawer ISAPI to.

7 Click Next

Page

48

of

95

Installation and Setup Guide

The Ready to Install the Application dialog appears:

8 Click Next.

The Updating System dialog appears.

HP TRIM installs on the computer and the dialog box

HP TRIM has been successfully installed

appears:

9 Click Finish.

HP TRIM is installed. Because of changed file paths, some features require your

computer to reboot after installation. See Steps to setting up a working system for what

to do next.

Page

49

of

95

Installation and Setup Guide

Missing Prerequisites dialog box

This dialog lists HP TRIM features that have failed to meet their installation requirements.

For a full list of requirements for HP TRIM features, see TRIM7.33_Spec.pdf.

Files in Use dialog box

This dialog lists applications that need to be closed before being able to continue the installation.

Installation using .msi file rules and behavior

• The HP TRIM installation is managed. This means that Windows Installer keeps tabs on the components of HP TRIM that are installed on the computer.

You need to run the installation with administrator access rights and in some cases with elevated access rights.

If you are not running the installation using Group Policy, you can set these on a computer using Group Policy set by the domain wide Group Policy or on a local computer.

• If the administrator performs the installation through Group Policy, elevated access rights apply to the installation for its life.

If the system administrator does not perform the installation through Group Policy, the installation does repair, modify etc. as long as the user carrying out the task has elevated access rights - for example, is a local administrator, or the computer has elevated access rights set for Windows Installer in its Group Policy

If this is not the case, some installation tasks such as repair or modify will fail because they need elevated access rights to write to the registry and to delete or write files on the computer.

HP TRIM Servers are set to start automatically; however, the .msi package does not start them. Therefore, when a server shuts down or needs to be rebooted, its services start automatically after the reboot.

Page

50

of

95

Installation and Setup Guide

5 Upgrading HP TRIM

Upgrading HP TRIM means not only upgrading the software, but in most cases also your dataset. Therefore, it is essential that you have performed database and dataset maintenance, as the upgrade instructions assume that your database is clean and your dataset up-to-date.

Also, before upgrading your HP TRIM environment, it is strongly recommended you perform a trial upgrade on a copy of your dataset in a test environment.

This test environment should be isolated from your live environment with no chance of confusing any live and test data.

Note

Before any upgrade, backing up your data is essential.

Use HPTRIM_xNN.msi and the relevant other .msi files from the installation disc.

An upgrade installation searches for an installed instance of HP TRIM, installs the new version and removes the previous version, if there is one.

If there is no previous installation, the installer performs a standard installation.

Version support

You can upgrade to this version of HP TRIM only from HP TRIM 6.2 or later.

If you are using older versions of TRIM, upgrade your existing environment to HP TRIM 6.2 first before upgrading to HP TRIM 7.x.

On your TRIM 6.2 installation disc, see TRIMCap2Con.pdf for upgrades from TRIM Captura to TRIM Context and TRIMCon2Con.pdf for upgrades from TRIM Context to TRIM 6.2.

Customized client toolbars and menus

During the upgrade process, HP TRIM resets all toolbars and menus to the defaults.

Page

51

of

95

Installation and Setup Guide

Upgrading from HP TRIM 6.2

About upgrading from TRIM 6.2

The upgrade does not preserve the TRIM 6.2 user environment, i.e. shortcuts, favorites, etc.

You may have to recreate it manually after the upgrade.

The upgrade resets the data for global settings, which is only available after upgrading the servers and should not be used before the server upgrade is complete.

The way peripheral applications are installed has changed significantly and does not always allow for an upgrade from TRIM 6.2 using a .msi file. Therefore, make sure you follow the recommended steps exactly to avoid removing 6.2 data or being unable to fully remove 6.2 peripheral applications.

HP TRIM peripheral applications should always be the same version and build number as the HP TRIM main client software.

Upgrade steps from HP TRIM 6.2 to 7.x

Upgrade HP TRIM from version 6.2 in the following order:

1

Perform database and dataset maintenance tasks as described in Appendix E below

2 Upgrade HP TRIM and its peripheral applications on all the HP TRIM client computers:

In addition to the main HP TRIM client software, client computers may have different

HP TRIM peripheral applications and extensions installed.

Upgrade steps for client computers: a If the computer has Microsoft Excel add-ins for earlier versions of TRIM installed, remove them according to the instructions in your Microsoft Excel addin documentation b Using the Windows Programs function, check which HP TRIM peripheral applications and extensions are installed on the computer and make a note of the ones that need to be available in HP TRIM 7. c If you need to upgrade any Web based applications or applications based on the

HP TRIM Software Development Kit (SDK), prepare and remove them from the upgrade folder, if necessary:

– Web Content Management (WCM) - WCM 6.2 is not compatible with WCM 7.

Make notes about its settings to be able to use them for the new installation.

– WebDrawer ISAPI – if the folders that their virtual directories point to are under the folder Program Files\TRIM Context, copy them to a location unaffected by the upgrade

– WebService – if you have created additional Web sites other than the default

HP TRIM site, and if these Web site’s virtual directories point to folders under Program Files\TRIM Context, move these folders to a location unaffected by the upgrade

– SDK applications – if they are in the folder Program Files\TRIM Context, copy them to a location unaffected by the upgrade

Page

52

of

95

Installation and Setup Guide d Remove all peripheral HP TRIM applications from the computer by using the

Windows Programs function e Remove TRIM Windows Runtimes by using the Programs function f Ensure the client computer has a supported operating system and all the necessary components installed. See TRIM7.33_Spec.pdf. g Install the relevant Microsoft Visual C++ 2005 Redistributable Package

vcredist_x86.exe

or _x64.exe using your own rollout strategy h Install VBRuntimes_x86.msi.

This step is not necessary for 64-bit installations. i

Install VS2008Runtimes_xNN.msi j Upgrade the main HP TRIM client software using HPTRIM_xNN.msi from the installation disc k If needed, use it to also install these features that were separate peripheral application .msi files in TRIM 6.2:

— HP TRIM Rendering module

— HP TRIMScan

— HP TRIM SAP integration l Install the remaining peripheral HP TRIM applications using the respective .msi files from the installation disc. Differences in installation between 6.2x and 7.x:

– Excel integration does not require a separate installation

TRIMContextTomcat.msi

was renamed to KGS_Content_Server_x86.msi, but is obsolete since 7.2. See TRIM7.33_SAPInstall.pdf for SAP integration installation and upgrade instructions. m

If you had to back up Web or SDK application files in step c , move the files back

to the HP TRIM installation folder, by default Program Files\Hewlett-

Packard\HP TRIM

. Alternatively, move your Web files to a more appropriate location and update the virtual directory and other references to reflect the new file locations.

3 Make HP TRIM unavailable for users.

In HP TRIM Enterprise Studio Help, see Dataset availability and messaging.

4 Back up all HP TRIM data.

See Backing up and Restoring your Data .

5

Stop the TRIM Workgroup service

6 Shut down all the Workgroup Servers

7 Upgrade the HP TRIM Workgroup Server software on all Workgroup Servers.

Use HPTRIM_xNN.msi.

8 Nominate one computer as designated administrator computer and install HP TRIM

Enterprise Studio on it using HPTRIM_xNN.msi.

Page

53

of

95

Installation and Setup Guide

9 On the administrator computer you set up in step 7, run the new version of HP TRIM

Enterprise Studio.

To preserve your 6.2x TRIM Enterprise Studio settings as much as possible, copy the file

TRIMconfig.tcfg

from your TRIM 6.2x administrator computer folder ServerData. It may be in a subfolder. Paste it to the HP TRIM 7 administrator computer you set up in step 7, folder ServerData\TRIM. By default, the folder is in C:\HPTRIM.

10 In HP TRIM Enterprise Studio, on the File menu, use Open to open the file

TRIMconfig.tcfg

that you just copied.

Upgrade the dataset schema - in HP TRIM Enterprise Studio Help, see Upgrading a

dataset schema.

11 Perform the additional dataset and database maintenance recommended in Appendix E

below

12 In HP TRIM Enterprise Studio, review the Workgroup Server configuration, in particular event processing.

In HP TRIM Enterprise Studio Help, see Configuring event processing.

13 Make changes as necessary and save the new configuration

14 Start the HP TRIM Workgroup Servers

15 In HP TRIM Enterprise Studio, deploy the new configuration

16 If there are outstanding events in the event processing monitor, convert them using the

Repair

function in the event processing monitor.

In HP TRIM Enterprise Studio Help, see Monitor Event Processing dialog box.

17 Bring HP TRIM online

The upgrade is complete.

Page

54

of

95

Installation and Setup Guide

Upgrading from HP TRIM 7

Upgrade steps from HP TRIM 7

Note

If you are upgrading HP TRIM from version 7.2.0 build 2264 and have customized the default OEM IDOL setup by installing additional IDOL Content Servers in the default installation folder, back up the contents of this folder for restoration after the upgrade. The upgrade process from that HP TRIM version and build does not preserve the additional servers.

Upgrade HP TRIM from version 7 in the following order:

1 Back up all HP TRIM data.

See Backing up and Restoring your Data .

2

Perform database and dataset maintenance tasks as described in Appendix E below

3 Upgrade HP TRIM and its peripheral applications on all the HP TRIM client computers.

See Upgrading client computers from version 7 .

4 Make HP TRIM unavailable for users.

In HP TRIM Enterprise Studio Help, see Dataset availability and messaging.

5 If there are HP TRIM IDOL services running, stop them

6 Stop the HP TRIM Workgroup service

7 Shut down all the Workgroup Servers

8

Upgrade the HP TRIM Workgroup Server software on all Workgroup Servers.

Use HPTRIM_xNN.msi.

9 Nominate one computer as designated administrator computer. If the computer has HP

TRIM in a version before 7.2 installed, modify the installation to remove the Server feature Demonstration Database, if it is installed.

10

On the administrator computer, install or upgrade HP TRIM Enterprise Studio using

HPTRIM_xNN.msi

.

11 On the administrator computer, run the new version of HP TRIM Enterprise Studio and use it to upgrade the dataset schema.

In HP TRIM Enterprise Studio Help, see Upgrading a dataset schema.

12

Perform additional dataset and database maintenance recommended in Appendix E

below

13 In HP TRIM Enterprise Studio, review the Workgroup Server configuration, in particular event processing.

In HP TRIM Enterprise Studio Help, see Configuring event processing.

14 Make changes as necessary and save the new configuration

15 Start the HP TRIM Workgroup Servers

Page

55

of

95

Installation and Setup Guide

16 In HP TRIM Enterprise Studio, deploy the new configuration

17 Bring HP TRIM online. The upgrade is complete.

Upgrading client computers from version 7

In addition to the main HP TRIM client software, client computers may have different HP

TRIM peripheral applications and extensions installed.

These should always be the same version and build number as the HP TRIM main client software.

Upgrade steps for client computers:

1 If the computer has Microsoft Excel add-ins for earlier versions of TRIM installed, remove them according to the instructions in your Microsoft Excel add-in documentation

2

Using the Windows Programs function, check which HP TRIM peripheral applications and extensions are installed on the computer

3 Remove those peripheral applications which are no longer required on the computer by using the Windows Programs function

4 Ensure the client computer has a supported operating system and all the necessary components installed.

See TRIM7.33_Spec.pdf.

Upgrade the main HP TRIM client software using HPTRIM_xNN.msi from the installation disc.

5 Restart the computer

6 Upgrade the remaining peripheral HP TRIM applications using the respective .msi files

from the installation disc. See Upgrading HP TRIM peripheral applications from version

7 .

Upgrading HP TRIM peripheral applications from version 7

Upgrading WebDrawer ISAPI from version 7

1 Take a note of all WebDrawer ISAPI configuration details

2 Remove WebDrawer ISAPI 7.x

3 Install new version of WebDrawer ISAPI

4 Configure new version of WebDrawer ISAPI manually according to the instructions in

TRIM7.33_WebDrawer.pdf

Page

56

of

95

Installation and Setup Guide

Mixed environments

To minimize downtime in very large organizations, HP TRIM 7.x runs in mixed environments, i.e. environments with clients and servers using the same version of HP TRIM

(e.g. 7), but different build numbers. 2.0.x represents the build number. You can see version and build numbers in the HP TRIM client by clicking HelpSetup InformationSoftware

Versions

.

However, as a general rule, HP TRIM clients in mixed environments must have build numbers the same or later than the HP TRIM Workgroup Server/s they communicate with.

For example, with a Workgroup Server on version 7.2.75, the clients should not use any build of version 7.0 or 6. However, they could use HP TRIM 7.2.0.92, for example.

Without this ability, downtime would include the time it takes to roll out HP TRIM 7 to all clients.

With this backward compatibility, in most cases, you can reduce the downtime to the dataset and server upgrades. This can make a significant operational difference where HP TRIM is now considered to be a critical system.

With the above in mind, a mixed environment provides an acceptable level of functionality for the period of the rollout, but it cannot:

• provide the full functionality of the latest release

• provide the same degree of stability of a single-build implementation.

Mixed environments are not suitable for either testing or training purposes.

Upgrade steps for mixed environments

Upgrade in the following order:

1 Client computers.

See Upgrading client computers from version 7 .

2 Server computers

3 Database schema, if necessary

Note

All Workgroup Servers must be at the same revision level.

Page

57

of

95

Installation and Setup Guide

Upgrading OEM IDOL

With the evolving HP TRIM system, the IDOL default configuration files may change in terms of their parameters from time to time.

As you may well have customized your IDOL configuration files in your previous version of

HP TRIM, the HP TRIM upgrade process will not overwrite your existing configuration files, but rather save the new default configuration files in addition to your files.

You should therefore update your custom configuration files manually after the upgrade to include the parameters that the new default configuration files contain.

Upgrading your document content indexes

HP TRIM before version 7.2 used ISYS for document content indexing (DCI). From version

7.2, HP TRIM uses Autonomy IDOL for DCI, which is not compatible with the legacy ISYS engine.

If you are upgrading HP TRIM from HP TRIM before 7.2, use HP TRIM Enterprise Studio to remove the ISYS index and then create the new IDOL index. Depending on your version of

HP TRIM, you may not have to remove the ISYS indexes. For data security, it is recommended you delete the legacy ISYS index files.

If you are upgrading HP TRIM from HP TRIM 7.2x, then after the HP TRIM upgrade, edit the existing IDOL configuration files to include the additional parameters from the new configuration files. To do that, stop all IDOL services on the indexing computer, make the changes and re-start the IDOL services. Contact HP TRIM Software Support for details.

While it is theoretically possible to keep using your existing ISYS indexes, as all commands in HP TRIM Enterprise Studio are available, it is not recommended as ISYS content indexing in HP TRIM will not be developed or maintained any further. There is also no way of creating new ISYS indexes in HP TRIM Enterprise Studio.

Upgrading Offline Records

It is recommended users check in their Offline Records files and folders before an upgrade to version 7.

Before upgrading to a 64-bit HP TRIM client, you must check in all documents from Offline

Records to prevent data loss.

HP TRIM 7 converts an existing TRIM 6.2 Offline Records Jet database in the default location to an Offline Records database and deletes the Jet database when the user accesses

Offline Records for the first time.

HP TRIM 7 does not take a backup of the Jet database, however, after a successful conversion, you will find the old copied database as trimtd.mdb.copied in the folder.

The Offline Records database is stored in the file OfflineRecords.dat in the user's data folders along with the actual Offline Records documents.

After accessing Offline Records for the first time, users should press F6 in HP TRIM to see the records. Offline Records should be in its default location.

Page

58

of

95

Installation and Setup Guide

6 Removing HP TRIM

1 Use the Windows Control PanelPrograms function to remove all peripheral HP TRIM applications, modules and components, for example:

LabeLink

Kofax, etc.

2 Remove HP TRIM using the Windows Control Panel Programs function

3 Remove HP TRIM Visual Basic runtimes

4 Remove HP TRIM Visual Studio runtimes

5 Optionally, remove the Microsoft Visual C++ 2005 Redistributable Package

vcredist_x86.exe

or _x64.exe

The installer requires the Microsoft .NET Framework3.5 SP1 to remove HP TRIM.

You can remove it when all HP TRIM components are removed.

Note

User data folders – the installation program does not remove the user's

Application Data

and Local SettingsApplication Data folders when removing

HP TRIM, as these folders may contain user-created data.

By default, these folders are located in the user's profile area, for example,

C:\Documents and Settings\<USER>\Application Data\Hewlett-Packard\HP TRIM

and C:\Documents and Settings\<USER>\Local Settings\Application

Data\Hewlett-Packard\HP TRIM

.

Page

59

of

95

Installation and Setup Guide

7 Network user group and the TRIMServices account

1 In Computer ManageLocal Users and Groups, create the individual network user names that will log on to HP TRIM, if they do not exist

2 Add these network login names eventually to the HP TRIM database so that the users can log on to HP TRIM directly using their network logins

3 Create a TRIMServices account which will be used to run HP TRIM Server components

Note

Write down the account name and password you have chosen as you will need it later.

Ensure you have created the account with the necessary permissions before proceeding. You will need no other accounts for the RDBMS.

Caution

The installation process does not add the services user to the Log on as a Service policy for any computer running a HP TRIM service.

To start any of the HP TRIM services, include the services user in the Log on as a

Service

policy on the computer; otherwise the services will fail to start and cause the error message:

Services

Could not start the HP TRIM Workgroup Server services on Local Computer.

Error 1069: The Services did not start due to a logon failure.

The solution is to re-type the password for the services user in the properties of one of the services, which will add the user to the Log on as a Service policy and return the message:

Services

The account mydomain\trimservices has been granted the Log On As A Service right.

The Log on as a Service policy is in Local Security Settings under User Rights

Assignments

.

The TRIMServices account is the proxy that enables communication between the HP

TRIM Servers.

Page

60

of

95

Installation and Setup Guide

8 Backing up and Restoring your Data

It is important that you back up the contents of your HP TRIM dataset including electronic stores regularly, preferably daily.

You will find the recommended backup strategy in the following topics of this document.

Remember that this is your data and it is your responsibility to make adequate backups.

Your business relies on this data to survive; therefore it is very important that you make appropriate backups to protect your data.

We urge you not to be complacent. Loss of data is quite a common occurrence. Some of the reasons for losing data are listed in the following topics.

Reasons for backing up

A number of factors can result in the loss of data:

Power fluctuation or blackout

System failure

• Theft

• Operator error

Communications (network) failure

• Malicious damage

Backup strategy

To ensure optimum performance of your HP TRIM dataset, we recommend regular maintenance and to consider the following as part of a comprehensive backup and recovery plan.

This is not an exhaustive list:

Back up before initial installation and upgrades

Back up daily - this is the minimum recommended

• Maintain multiple generations of backups to protect against backup corruption, for example, three generations of each backup media before re-use

Backup media should be verified regularly

Make sure you know how to restore from your backup, should the need arise, i.e. regular practice of restoration to verify the process and ensure personnel are familiar with the requirements

• Off-site storage of backup media in case of fire, theft, local disaster etc.

Page

61

of

95

Installation and Setup Guide

Dataset components

The components that should be backed up on a regular basis for your particular environment require thought and planning.

All the components combine to create a matched set of data.

To ensure the integrity of your data, it is recommended you back up the data as one set and if necessary, restore it as a complete set. In most instances, all data as one set would be ideal; but as a minimum, you should back up all primary data.

Splitting the database components into primary and ancillary data results in these lists:

Primary data

Database tables (relational database metadata)

Electronic document stores

• Document content search indexes

Audit logs

Ancillary data

User Offline Records folders

• User configuration files

Queue processing folders

Document content search indexes

• Audit logs

Both document content search indexes and audit logs appear under each of the headings above. Whether either is considered primary or ancillary data is site specific.

You can regenerate the entire structure of document content search indexes from the documents themselves; therefore you may consider these non-core structures. However, it can take so much time to regenerate a full set of content indexes that you should consider them to be primary data.

Audit logs are used to varying degrees depending on the implementation of HP TRIM.

Whether you consider audit logs primary or ancillary data depends on the use of such logs by your organization - simple reference item, critical security feature or something else?

A backup and recovery plan must decide under which category each falls, and treat them appropriately.

The purpose of backups is to ensure that you can recover your data, should something go wrong. Whatever the reason for the loss of data may have been - if you have adequate backups, you can minimize or even eliminate loss of service and data.

Backups are an integral part of your everyday computer housekeeping and should be regular practice.

You should use incremental backup mechanisms only with extreme care and after due consideration.

Page

62

of

95

Installation and Setup Guide

Backup techniques

You can perform two types of backups on a database:

Hot - while the database is online and usable

Cold – while the database is closed and not available to users

A cold backup for a HP TRIM environment is straightforward: All components - relational database, document stores, etc. - are captured in their inactive state.

For a hot backup, you need to be careful and consider how to back up all the primary and optionally ancillary data components of a HP TRIM system.

You essentially need to ensure the backup can capture the primary disk structures, like electronic stores, in a stable fashion at the same point in time you are performing a hot backup on the relational database.

Some options to consider:

Using utility software to take a snapshot of the files and folders

Using software or hardware replication or mirroring techniques, for example RAID, and associated mirror breaking and recovering features to capture one copy of the files and folders as a point-in-time snapshot

• Using a combination of the above or custom approaches

Always remember, treat your primary and optionally ancillary HP TRIM data as one set.

Recovery techniques

Many systems include recovery facilities that enable you to restore to a particular point in time - which may not necessarily be the same point in time of a backup.

Such point-in-time recovery features usually use a database's transaction log to replay activity since a known backup point. This is sometimes referred to as rolling forward.

While you can use such a facility with your HP TRIM relational database, remember the collateral impact and therefore steps required on other primary and ancillary data structures. File systems, FTP Servers etc. that hold your other HP TRIM data structures do not have a transaction log on which to rely - so rolling forward or rolling back your database requires some effort by you to keep these structures synchronized.

Several options are available if you need a point-in-time recovery:

• Roll forward/back only to a point in time at which a synchronized set of backups is available

Roll forward/back to a desired point with a plan to accommodate any orphaned or ghost information

Always remember, treat your primary and optionally ancillary HP TRIM data as one set.

Page

63

of

95

Installation and Setup Guide

A Steps to Setting up a Working System

This section outlines a sequence of steps you need to go through to set up a working system.

This is often the task of a system administrator. Some of the points below are mandatory for any system to work, whereas some functions are optional. It depends on how you choose to administer your paper and electronic records. Refer to the HP TRIM Help file TRIM.chm topics and chapters specified for a detailed explanation of each function and further guidance on how to complete each step.

Bookmark this section so that you can come back to it while you complete the steps.

The mandatory steps have an asterisk behind them.

1

Install RDBMS software on the server to host the dataset*

2

Install HP TRIM software on the designated Workgroup Server computers*

3

Using HP TRIM Enterprise Studio, create and register the HP TRIM dataset*

4 Using HP TRIM: a Set up the security levels and security caveats.*

See Security levels administration and Security caveats administration. b Set up postcodes.

See Postal codes. c Set up the internal and external Locations (Contacts and Organisations)*.

See Locations. d Set up user profiles - login accounts for staff who will use HP TRIM*.

See Profile tab. e Set up a Thesaurus.

See Thesaurus. f Set up Classifications.

See Classifications. g Set up Archive Retention Schedules.

See Archive Retention Schedules. h Set up system options.

See System Options. i Set up the HP TRIM calendar.

See Calendar editor for administrators. j Set up noise words, title words and notes words.

See Word indexes. k Recreate word indexes to index the Classifications, Retention Schedules,

Thesaurus and other text fields.

See Recreate word indexes. l Set up document content indexing and searching.

In HP TRIM Enterprise Studio Help, see Document content index. m Set up document stores.

See Document stores.

Page

64

of

95

Installation and Setup Guide n Set up Record Types - after you have set up your Record Types, you can begin to create records*.

See Record Types. o Set up New Record forms.

See Creating New Record forms. p Set up Additional Fields.

See Additional Fields. q Set up Lookup Sets.

See Creating Lookup Sets. r Set up Actions and Procedures.

See Action tracking. s Set up Workflow and Workflow Activities.

See Workflow. t Set up record Holds.

See Holds. u Set up report layouts.

See Report layouts. v Set up Web publisher layouts.

See Web Publisher. w Set up barcode scanners.

See Barcode scanners. x Set up Space management - the storage space environment that will contain your archived or stored records.

See Space management. y Set up electronic document management - desktop integration with other software packages.

See Electronic document management. z Set up the user layout options of your HP TRIM interface.

See Options and Customising and creating toolbars.

HP TRIM is configured.

You can now start creating records.

See HP TRIM Help topic Creating records.

Page

65

of

95

Installation and Setup Guide

B Installing and configuring the HP TRIM CFS

Connector

The HP TRIM CFS connector is connecting your HP TRIM installation with your existing

Enterprise IDOL installation, keeping the IDOL indexes up-to-date with changes to the HP

TRIM database and applying TRIM security to TRIM records in IDOL.

You can also use the TRIM connector with your OEM version of IDOL to send indexing requests. This is not recommended unless instructed to do so by HP TRIM Software Support.

Prerequisites

These instructions assume you have already successfully installed and configured:

HP TRIM 7.3 or later

• Your own installation of Enterprise IDOL.

This is not the OEM installation of IDOL that comes with HP TRIM.

-- or –

The OEM installation of IDOL that comes with HP TRIM.

Installing the HP TRIM CFS connector

The TRIM CFS connector should be installed on a computer that has a HP TRIM Workgroup

Server installed.

1 On your installation medium, locate the installation file and run it as administrator:

For 32-bit computers: TRIMConnector_[version]_WINDOWS.exe

For 64-bit computers: TRIMConnector_[version]_WINDOWS_X86_64.exe

The installation dialog appears:

Page

66

of

95

Installation and Setup Guide

2 Click Next.

The License Agreement dialog appears:

3 Select I accept the terms of the License Agreement and click Next.

The Choose Install Folder dialog appears:

4 Change the installation folder if the default is not suitable and click Next.

You can use the button Restore Default Folder to change your custom location back to the default location.

Page

67

of

95

Installation and Setup Guide

The Service Name dialog appears:

5 In the field Service Name, enter the name that the TRIM CFS connector should appear with in the Windows Services dialog box and click Next.

The name will appear with Autonomy in front of what you entered here. For example, if you entered TRIM Connector, the service would appear as Autonomy TRIM Connector in the Windows Services panel.

The Service Port dialog appears:

6 In the field Service Port, enter the port number that you want the connector to listen on and click Next.

This is not a server name, as implied by the default value in this field. For example, enter 7302.

Page

68

of

95

Installation and Setup Guide

The License Server Configuration dialog appears:

7 In the fields License Server Host and License Server Port, enter the details of the IDOL

License Server and click Next.

The DRE Database dialog appears:

8 In the field DRE Database, enter the name of the IDOL database instance that TRIM has been configured to use and click Next.

You can find this information in TRIM Enterprise Studio by right-clicking the dataset to connect to, and then on the Content Index menu, clicking Properties. On the Content

Index Properties

dialog, it is in the field Instance name for TRIM data.

Page

69

of

95

Installation and Setup Guide

The TRIM Connector Configuration dialog appears:

9 In the fields TRIM Workgroup Server, TRIM Workgroup Port and TRIM Dataset Id, enter the details of the main Workgroup Server and then click Next.

The Connector Framework Server dialog appears:

10 Choose whether to install a new connector framework service (CFS):

Install New CFS

– if there is no CFS installed on this computer

Use Existing CFS

– if there is already a CFS installed on this computer, for example when there are other IDOL connectors installed

Then click Next.

Page

70

of

95

Installation and Setup Guide

The Choose CFS Install Folder dialog appears:

11 Change the installation folder if the default is not suitable and click Next.

You can use the button Restore Default Folder to change your custom location back to the default location.

The Connector Framework Installation Name dialog appears:

12 In the field Installation Name, enter the name for the connector framework service (CFS) to appear as in the Windows Services dialog, and click Next.

The installer does not add a prefix to what you enter here.

The Connector Framework Service Settings dialog appears:

Page

71

of

95

Installation and Setup Guide

13 In the field Service Port, enter a port number for the connector framework to use. This port must not be in use by any other services on this computer.

Then click Next.

The DRE Settings dialog appears:

14 In the fields IDOL Server Hostname and ACI Port, enter the details of the IDOL Server and click Next.

The Connector Framework Server ACI Port dialog appears:

15 In the field ACI Port, enter the port number of the port that the TRIM connector should use to communicate with the connector framework and click Next.

Page

72

of

95

Installation and Setup Guide

The Pre-Installation Summary dialog appears:

16 Click Install and wait for the next dialog.

The TRIM connector Start Service dialog appears with the question, Do you wish to

start the <Name> service now?

17

Select No and then click Next.

You need to make some changes to the configuration files first.

The connector framework Start Service dialog appears with the question Do you wish to

start the <Name> service now?

Page

73

of

95

Installation and Setup Guide

18 Select No and click Next.

The Install Complete dialog appears:

19 Click Done.

20 Do not start the TRIM connector service or the connector framework service until you have made all the configuration changes described below.

Page

74

of

95

Installation and Setup Guide

Configuring the TRIM connector for use with OEM IDOL

Do not use the instructions in this section if you are using an Enterprise version of IDOL

If you are using the TRIM connector with OEM IDOL, which comes with HP TRIM, then make the following manual changes to the TRIM Connector configuration files:

Add LicenseKey.dat

1 In the TRIM IDOL Service installation directory, by default C:\Program Files\HP

TRIM\IDOL\TRIM IDOL Service

, locate the file licensekey.dat.

2

Copy licensekey.dat to the root directories of both the TRIM connector, by default in

C:\Autonomy\TRIMConnector

, and the connector framework, by default in

C:\Autonomy\ConnectorFramework\

.

Modify the TRIM connector configuration file

1 Using a text editor, open the file TRIM Connector.cfg, by default in

C:\Autonomy\TRIMConnector\

2

In the [License] section, delete everything down to the next section, which is usually

[Service]

Modify connector framework configuration file

1 Using a text editor, open the file TRIM ConnectorFramework.cfg, by default in

C:\Autonomy\ConnectorFramework\

2 In the [License] section, delete everything down to the next section, which is usually

[Service]

Page

75

of

95

Installation and Setup Guide

Configuring the TRIM connector for use with Enterprise IDOL

Install OmniGroupServer

The OmniGroupServer component is only necessary when setting up the TRIM connector in an environment that is using Enterprise IDOL. For environments that use HP TRIM OEM

IDOL, ignore OmniGroupServer installation and setup.

After installing OmniGroupServer, you need to make some configuration changes to the configuration files for OmniGroupServer, the TRIM CFS connector and the IDOL Server.

1 On your installation medium, locate the installation file

OMNIGroupServer_[version]_WINDOWS.exe

and run it as administrator:

The installation Introduction dialog appears:

2 Click Next.

The Enter installation basename dialog appears:

3 In the field Basename, enter the name for the OmniGroupServer to appear with in the

Windows Services dialog and click Next.

Page

76

of

95

Installation and Setup Guide

The Choose Install Folder dialog appears:

4 In the field Where Would You Like to Install?, change the installation folder if the default is not suitable and click Next.

You can use the button Restore Default Folder to change your custom location back to the default location.

The Choose Install Set dialog appears:

5 In the field Install Set, select Custom.

In the field below, select Text.

Clear all other options in this field and click Next.

Page

77

of

95

Installation and Setup Guide

The Service and Server Settings dialog box appears:

6 In the fields Service Port and ACI Port, enter the port numbers of the OmniGroupServer.

These should be ports that are currently unused on this computer.

Take a note of the ACI port and then click Next.

The Pre-Installation Summary dialog box appears:

7 Review the installation details and click Install.

OmniGroupServer installs to the computer.

Modify the TRIM connector configuration file

This is not required for environments using HP TRIM OEM IDOL.

1 Locate the file TRIM Connector.cfg, which by default is in

C:\Autonomy\TRIMConnector

, and open it in a text editor

Page

78

of

95

Installation and Setup Guide

2 In the [TrimGroups] section, insert the following parameters:

[TrimGroups]

DatabaseId=[DBID]

WorkgroupServer=localhost

EnableGroupServerSecurity=true

GroupServerHost=localhost

GroupServerPort=3057

GroupServerRepository=Text

For

DatabaseId

TRIM connector.

, use the TRIM database ID that you used when you installed the

For

WorkgroupServer

Server.

, use the computer name or IP address of the main Workgroup

GroupServerHost

should be the computer name or IP address that the

OmniGroupServer was installed on.

GroupServerPort

should be the ACI port of the OmniGroupServer.

2 Save and close the configuration file

Modify the OmniGroupServer configuration file

This is not required for environments using HP TRIM OEM IDOL.

1 Locate the file OMNIGroupServer.cfg, which by default is in

C:\Autonomy\OMNIGroupServer

, and open it in a text editor

2 In the [Text] section, insert the following parameter:

Textfile= C:\Autonomy\OMNIGroupServer\TextDir\TextGS.txt

3 Save and close the configuration file

Modify the IDOL configuration file

This is not required for environments using HP TRIM OEM IDOL.

1 Locate the file AutonomyIDOLServer.cfg, which by default is in C:\Program

Files\Autonomy\IDOLServer\IDOL

, and open it in a text editor

2 In the section

[Field Processing]

end of the list of numbered items: section, insert the following parameter at the

19=DetectTrimExt_V4Security

The number should be the next unused number.

3 At the end of the section

[FieldProcessing]

, add:

[DetectTrimExt_V4Security]

Property=SecurityTrimExt_V4

PropertyFieldCSVs=*/SECURITYTYPE

PropertyMatch=TrimExt

Page

79

of

95

Installation and Setup Guide

4 In the

Properties

section, add:

[SecurityTrimExt_V4]

SecurityType=TrimExt_V4

5 In the

Document Security

section, and in the

[Security]

section, add:

5=TrimExt_V4

In

[Security]

, add it to the end of the list of numbered items, and the number should be the next unused number.

6 At the bottom of the

Document Security

section, insert:

[TrimExt_V4]

SecurityCode=28

Library=C:\Program

Files\Autonomy\IDOLServer/IDOL/modules/mapped_security

Type=AUTONOMY_SECURITY_V4_TRIM_CONTEXT_EXT_MAPPED

ReferenceField=*/AUTONOMYMETADATA

EscapedEntries=True

7 Locate the

User Settings

section, and in the

[UserSecurity]

block, insert:

[UserSecurity]

6=TRIM

Add it to the end of the list of numbered items in [UserSecurity], and the number should be the next unused number.

8 At the bottom of the

UserSecurity

section, insert:

[Trim]

CaseSensitiveUserNames=FALSE

CaseSensitiveGroupNames=FALSE

DocumentSecurity=TRUE

V4=TRUE

GroupServerHost=12.345.678.901

GroupServerPort=3057

SecurityFieldCSVs=username

DocumentSecurityType=TrimExt_V4

GroupServerPrefixDomain=False

GroupServerHost

should be the server name or IP address of the OmniGroupServer

GroupServerPort

should be the ACI port of the OmniGroupServer

9

Save the AutonomyIDOLServer.cfg file, and restart the IDOL service for the changes to take effect

Start the services for OEM or Enterprise IDOL

1 After installing the required components out of TRIM Connector Service, the connector framework and the OmniGroupServer, and after making all the configuration changes above, make sure the IDOL Server and the IDOL Licensing Server are both running before starting the TRIM Connector Service and the Connector Framework Service

2 Start all the new services. Your TRIM CFS connector setup is complete.

Page

80

of

95

Installation and Setup Guide

C Troubleshooting

Troubleshooting the Workgroup Server

Workgroup Server does not start

1

Check login parameters

2 Check Windows event viewer

3 Check the Workgroup Server log files

Crashdump files

When the Workgroup Server experiences a general protection fault, by default, it creates:

• one large .dmp file per crash per hour.

You can adjust the frequency by using the registry dword crashdumpfrequency and the value means files per day.

• one small .dmp file per crash

• one log file per crash

You can use a registry key to modify the type of data that the large .dmp file includes:

HKEY_LOCAL_MACHINE\SOFTWARE\Hewlett-Packard\HP

TRIM\WorkgroupServerConnection

with the dword CrashDumpType.

The value should be one of the ones listed in this site: http://msdn.microsoft.com/enus/library/ms680519(VS.85).aspx

, for example 0x1227.

A Workgroup Server saves the diagnostic files to:

C :\Program Files\Hewlett-Packard\HP TRIM\ServerLocalData\Log\<crash-filenumber>.log

C :\Program Files\Hewlett-Packard\HP TRIM\ServerLocalData\Log\<crash-filenumber>. dmp

A HP TRIM client computer by default, saves crashdump files to:

C:\Documents and Settings\<user>\Application Data\Hewlett-Packard\HP TRIM\<dataset

ID>\Temp

.

Contact HP TRIM Software Support to examine the log file to identify the cause of errors.

Page

81

of

95

Installation and Setup Guide

Rendering module output does not appear

When the HP TRIM rendering module fails to render the long-term storage format of documents, it may record the message in the render log file:

Error: Printer output file did not appear: [7: printer file failed to appear within timeout]

[Info: C:\Users\trimservices\AppData\Local\Hewlett-Packard\HP TRIM\out.pdf]

This is usually due to incorrect print processor configuration.

To fix this issue:

1 In the Windows Printers dialog box, right-click TRIMRender_PDF, click Properties.

The TRIMRender_PDF Properties window appears.

2 On the Advanced tab, click Print Processor

3 For Print processor, select PrintOnstream Driver and for Default data type, select NT

EMF 1.003

Page

82

of

95

Installation and Setup Guide

D Rendering Module Configuration

Security

Overview

As users may choose to render high security or classified documents, HP Software recommend you use security settings for the printer driver, folders, services and the render monitor. These settings ensure that all documents used with HP TRIM Render are secure from unauthorized access.

If you wish to modify the security settings for these elements, please do so in accordance with your IT infrastructure policy.

Securing the print drivers

Follow the process of applying security settings to the driver TRIMRender_PDF.

Repeat the process for the driver TRIMRender_TIFF driver.

1 In the Windows Printers dialog box, right-click TRIMRender_PDF

2 Click Properties.

The TRIMRender_PDF Properties window appears.

3 Select the Security tab

4 Click Add to add the TRIMServices account and the other Groups/users that need to administer the printer

5 Click the Advanced button.

Page

83

of

95

Installation and Setup Guide

The Advanced Security Settings for TRIMRender_PDF window appears.

6 Click Add or Edit.

The Select User, Computer, or Group window appears.

7 Select the users, computers or group you want to apply security settings for

8 Click OK.

The Permission Entry for TRIMRender_PDF window appears.

9 Make your selections for Apply to and Permissions

10 Click OK

11 In the Advanced Security Settings for TRIMRender_PDF window, choose the settings you require

12 Click OK twice to apply the settings and close the dialog boxes

13 Repeat steps 1-12 for the driver TRIMRender_TIFF

Securing the service and render monitor

You may want to apply additional security settings to comply with the security policy of your organization.

You can set up a local Security Group on the server called Render Administrators. Using

Group Policy, you can then grant the group access to objects on the server that are locked for unauthorized access.

This allows you also to deny the Rendering Administrators Group access to other files on the server.

Remote access

HP TRIM Render runs locally on a server. In case the Rendering Administrators do not have physical access to the server, you need to give them remote access. Apply security settings in accordance with your IT infrastructure policy.

Page

84

of

95

Installation and Setup Guide

Printing preferences

Overview

The HP TRIM Rendering module uses the Onstream systems print driver to render documents into renditions. The drivers come with default settings which may not necessarily suit your needs.

To ensure seamless operation with Microsoft Word files, it is highly recommended to install

Microsoft Word on the computer that is running the TRIMRender Service.

Changing the settings

1 In the Printers and Faxes folder, right-click the TRIMRender_PDF driver and select

Properties

.

The TRIMRender_PDF Properties window appears.

2 Click the button Printing Preferences.

The TRIMRender_PDF Printing Preferences window appears.

3 In the Device Settings tab, change the Paper Size settings to suit your needs: a Select a specific paper size to scale the source document to fit b Select Variable Paper Size from the drop-down list to render the source document to the same size c

Change the Graphic Resolution settings to suit your needs d Apply more printing preferences as needed

Using multiple servers

Setup example

All records of Record Type 3 and finalized

1 Using the Select tab, set it to add records that are Finalized

2 Using the Filter tab, set it up to Include only Records of Record Type 3.

Rendering Server 1 will add all records of Record Type 3 AND that are finalized to the queue.

Page

85

of

95

Installation and Setup Guide

All records of Record Type 15 and registered 5 or more days ago

1

Using the Select tab, set it up to add records With Date Registered Older Than 5 days.

2 Using the Filter tab, set it up to Include only Records of Record Type 15.

Rendering Server 2 will add all records of Record Type 15 AND that were registered 5 days ago or longer to the queue.

Queuing

The HP TRIM Rendering module maintains only one queue; therefore, all the records the different processors select will be added to the same queue.

Processing

The HP TRIM Rendering module service processes all the records in the queue. It simply selects the next 20 records for processing. There is no filtering at the processing stage.

Like in the example above, you may have set up two servers to put specific items in the queue; however, the two or more rendering services that are running will process the next 20 records from the queue respectively, regardless of how they were added to the queue and what criteria they match.

Print verbs

Overview

In a Windows environment, when you right-click a file in Windows Explorer and click Print, the associated application, e.g. XYZ, opens, prints the file and exits, displaying as little as necessary to complete the task.

It does so because it invokes the verb print.

The HP TRIM Rendering module also invokes the verb print programmatically during the rendering process.

When the installed application is not printing .xyz documents correctly and you want to print them using a command other than the default print verb, it may be necessary to manually edit the print verbs in the registry.

Page

86

of

95

Installation and Setup Guide

Changing a print verb

Warning

Only qualified Administrators should make changes to the registry.

Please make a backup of your registry before proceeding.

Mistakes changing registry settings can lead to unrecoverable errors and the computer being unusable.

For more information on print verbs and how to print, for example, .xyz files with a different application that has a command line switch for printing, please refer to Microsoft documentation. Depending on your knowledge, this could be a starting point: http://msdn2.microsoft.com/en-us/library/aa969321.aspx#anyfiletype

See TRIMRender.chm for information about functionality and operation of the HP TRIM

Rendering module.

Page

87

of

95

Installation and Setup Guide

E Demonstration database

Installation and setup

Overview

The HP TRIM installation disc contains a HP TRIM database you can use as a demonstration or test database. It contains sample data including Record Types, a

Thesaurus, Classifications, Actions, Procedures, different Location types, records and attached electronic documents. It is designed to be a stand-alone version of a HP TRIM database to demonstrate what you can store in HP TRIM and how its components work together.

Setting up the demonstration database

Prerequisites

HP TRIM must be installed

• Microsoft SQL Server 2008, 2008 R2 or later or one of their Express editions must be installed

The user must be a member of the computer group

SQLServerMSSQLUser$<computer name>$SQLEXPRESS

or their equivalents

Extracting the file

The file on the HP TRIM installation disc is Demonstration Database\DemoDB.zip.

1 Unpack the file DemoDB.zip.

It unpacks to the sub-folder DemoDB with a directory structure for the document store

(\45\2\00), which is required for the demonstration database to function correctly.

You can move the document store structure to any writable location; however, for ease of use, it is recommended that you keep them in the same directory structure as the demonstration database.

Page

88

of

95

Installation and Setup Guide

Setup

1

In SQL Server, create a new database and name it DemoDB

2 Using SQL Server2008, 2008 R2 or later, restore the database backup DemoDB.bak from the HP TRIM installation disc to a new destination folder in C:\HPTRIM\ServerData\, for example, DemoDB.

The HP TRIM installation creates the folder ServerData. However, for the restore, you can use any location outside the folder Program Files that you can write to.

The restore creates the files DemoDB.mdf and DemoDB.ldf in your destination folder.

3 Start HP TRIM Enterprise Studio

4 Right-click Datasets and click Register Dataset.

The dialog Register New Dataset – Identification appears.

5

Fill in the fields:

Dataset Name

– enter DemoDB

Dataset Identifier

– enter 45

6 Select Microsoft SQL Server or MSDE

7 Click Next.

The dialog Register New Dataset – Connection appears.

8 In the field OLE DB Connection String, click KwikSelect and in the dialog Data Link

Properties

, set up the database connection: a In the field Select or enter Server name, enter your computer name followed by

\SQLEXPRESS

, if you are using SQL Server Express b Under Information to log on to the server, select Use Windows NT Integrated

security

c Under Select the database on the server, select DemoDB d Click Test Connection. If the connection fails, check you followed the previous steps correctly. e Click OK. The dialog Data Link Properties closes and you are using the dialog

Register New Dataset – Connection

again.

9 For Guest Login, enter DEMO in upper case and click Next.

The dialog Register New Dataset – Options appears.

10 Click Next.

The dialog Register New Dataset – Document Store appears.

11 In the field Path for Default Document Store, click KwikSelect to select the folder

DemoDB

.

12 Click Finish.

A warning message about UNC paths may appear, which is not relevant for a demonstration setup. You can ignore it and click OK.

The dataset appears in the list of datasets.

13 Configure event processing so that document content processing is enabled

14 Right-click the dataset and create an IDOL content index

Page

89

of

95

Installation and Setup Guide

15 Start HP TRIM and click FileOpen.

The dialog Open HP TRIM Dataset appears.

16 Click Add.

The Add Datasets – Choose Machine dialog appears.

17 Select Choose Local Datasets and click Next.

The dialog Add Datasets – Available Datasets appears.

18 Tag the new dataset and click Finish.

19 In the dialog Open HP TRIM Dataset, select the new dataset and click OK to open it.

You are now logged on to the database as Peter Abbott, who is a HP TRIM administrator.

20 Create a new login for yourself you can use for future logins

21 In HP TRIM, create the document content index by using the Reindex function.

The setup is complete.

Page

90

of

95

Installation and Setup Guide

F Database and dataset maintenance tasks

Overview

The following steps are recommended to best prepare existing production datasets of HP

TRIM versions 5.2, 6.1, 6.2 and 7.x for upgrades, but also for regular maintenance. Not all steps apply to all versions.

These instructions are intended for HP TRIM administrators and database administrators.

Back up all databases before performing maintenance.

If in doubt about a step, contact your regional HP TRIM Support team.

Steps

1 Using HP TRIM Enterprise Manager/Studio depending on your version of TRIM, run an integrity/constraint check on the HP TRIM production dataset. See HP TRIM Enterprise

Manager/Studio Help for detailed instructions.

If errors are listed at the end of the log file, run the check again with the option Repair… selected. If errors still remain, contact HP TRIM Support for assistance.

2 Use HP TRIM Enterprise Manager/Studio to run a schema repair

3 Use the HP TRIM rich client as an administrator to run a document store integrity check. See HP TRIM Help for detailed steps.

4 If files are missing, the HP TRIM administrator has to decide whether to run it again with the option Repair… selected, which replaces missing files with a textual stub, or find the files from a backup and restore them

5 Clean up the table TSEVENTDAT:

Delete from tseventdat where edDateTime < (select min(epLastEventTime) from tseventpro where uri > 0) and uri > 0

This SQL statement removes all processed events and leaves only currently queued events. Ideally, all events have been processed before the upgrade. Quite often, the backlog of this table becomes very large. In HP TRIM 7, this table no longer keeps a record of processed events, and instead deletes them immediately after processing.

6 Clean up the table TSEVENTPRO:

DELETE FROM TSEVENTPRO

This SQL statement removes the Event Server configuration. This includes all errant entries not cleared from migrations, i.e. Workgroup or Event Servers that are no longer in use. HP TRIM recreates this table automatically after restarting the HP TRIM services and after using the HP TRIM Enterprise Studio command Deploy.

Page

91

of

95

Installation and Setup Guide

7 Clean up the table TSURICLAIM:

DELETE FROM TSURICLAIM WHERE ucTableId > 0

This SQL statement removes all URI claims, especially those that may be lingering from migrations, i.e. Workgroup or Event Servers that are no longer in use. HP TRIM recreates these URI claims automatically after restarting the HP TRIM services and after using the HP TRIM Enterprise Studio command Deploy and using the particular

HP TRIM business object (records, Locations, Schedules, etc).

8 Verify the dataset identifier is correct in the database:

SELECT value FROM TSTWRSYS WHERE code = 'DBID'

It should match the production dataset identifier in the HP TRIM Enterprise

Manager/Studio dataset properties.

If the dataset identifiers do not match, update it:

UPDATE TSTWRYS SET value = '<proper DBID>' WHERE code = 'DBID'

9 In preparation to rebuild the word index in HP TRIM 7, manually clear out the indexing tables in the following order: a

DELETE FROM TSLOCWORDA WHERE uri > 0

Deleting from TSLOCWORDA is only necessary for 6.2.x datasets. b

DELETE FROM TSTMWORD WHERE uri > 0

c

DELETE FROM TSSCHWORD WHERE uri > 0

d

DELETE FROM TSFPWORD WHERE uri > 0

e

DELETE FROM TSRECWORD WHERE uri > 0

f

DELETE FROM TSINDEXWOR WHERE uri > 0

10

When upgrading, follow the next upgrade steps from page 51 until after the schema

upgrade

Additional maintenance tasks after the schema has been upgraded

1 Using HP TRIM Enterprise Studio, recreate the word index.

See HP TRIM Enterprise Studio Help for details.

2 Using HP TRIM Enterprise Studio, recreate the document content index.

Because HP TRIM 7 uses new and improved ways of content indexing, this is much easier than using an existing one. You can find detailed instructions for recreating the document content index in HP TRIM Enterprise Studio Help.

To optimize document content indexing, you can recreate it as a parallel process. See HP

TRIM Knowledge Base article KM762544 for details.

3 If you are migrating HP TRIM to a development/test/staging environment before the production dataset upgrade, please also refer to HP TRIM Knowledge Base article

KM762551, which describes steps for migrating a dataset.

Page

92

of

95

Installation and Setup Guide

G Automatic Deployment Tool

Automatic deployment tool

The HP TRIM AutoDeploy tool assists in updating the current user configuration of HP

TRIM.

It is also used to keep the current user's configuration details up to date.

If the current user has not accessed the computer, the HP TRIM AutoDeploy tool will create the registry keys and files required to run HP TRIM.

Once installed, it launches a software update, if there is one available.

Note

You must have Group Policies set to allow .msi files to install with elevated access rights for ordinary users.

This feature will not update HP TRIM Workgroup Servers.

On the initial software rollout to desktop computers, the rollout parameters should include the primary Workgroup Server for each computer.

AutoDeploy checks this server to see whether a software update is available.

When a user logs on, AutoDeploy checks whether a file called AutoDeploy.ini exists in a share named AutoDeploy on the desktop computer's designated primary Workgroup Server.

The share must allow users read permission for itself and its contents.

If the file does not exist, AutoDeploy will exit after checking the current user's configuration.

If the file does exist, AutoDeploy will look up two values from the .ini file. AutoDeploy will expect the .ini file to be formatted like this:

[AutoDeploy Detail]

Auto_DepVersion=7.3.X.XXXX

Script_Name='Setup.bat'

• Auto_DepVersion is the full version of the upgrade

Script_Name is the name of the script that AutoDeploy must execute if the Service Pack upgrade of that date has not yet been installed on this computer.

This can be any executable file or the .msi file itself. It should not include a path and the file is expected to be in the AutoDeploy share.

For example, the script name could be HPTRIM_x86.msi, which should be in the

AutoDeploy share.

If the value of Auto_DepVersion is different to the version of HP TRIM installed on the computer – HP TRIM Enterprise Studio will check the version of HP.HPTRIM.SDK.dll - the script will be executed to install the latest Service Pack upgrade.

The registry update will run after that.

Page

93

of

95

Installation and Setup Guide

AutoDeploy changes to the current user

• AutoDeploy sets HP TRIMAppData, HP TRIMLocalAppData paths if they were configured in the rollout parameters.

If they were not, the registry will have blank values for these keys and HP TRIM will use the defaults.

If the current user has not executed HP TRIM previously, AutoDeploy configures the

ODMA settings

• It sets the spelling checker defaults and the location of user spelling checker dictionaries

If no default database is set for the current user, it copies the computer default

If Microsoft Outlook mail clients are registered and the required current user settings are not available, AutoDeploy sets them for the current user

Current user configuration

Initial software installation can mostly configure details for the computer (All Users) and for new users on that computer - those with no existing profile.

However, due to local environment inconsistencies, configuring a computer environment for a user with an existing profile can be quite difficult.

The HP TRIM AutoDeploy tool handles this challenge using the file TRIMAutoDeploy.exe.

It is set to run when a user logs on to a computer that has HP TRIM installed.

It checks:

• Whether this user has a configured HP TRIM environment

• Whether the environment was configured no earlier than the initial HP TRIM software installation or last update using a Service Pack upgrade

HP TRIM AutoDeploy does this by comparing the registry key date values of:

HKEY_CURRENT_USER\Software\Hewlett-Packard\HP TRIM\MSI Setup\CuDepDate

with

HKEY_LOCAL_MACHINE\SOFTWARE\Hewlett-Packard\HP TRIM\MSI Setup\Depdate

If the first one is not equal to the second one or does not exist at all, then either this user is not configured to run HP TRIM or their configuration may need updating.

In this case, HP TRIM AutoDeploy reads the registry to determine the original rollout, installation or update parameters stored in

HKEY_LOCAL_MACHINE\SOFTWARE\Hewlett-Packard\HP TRIM \MSI Setup

and implements a current user configuration accordingly - under the key, HP TRIM looks for a string value containing a server name.

It then checks whether this server has a shared directory called AutoDeploy.

Page

94

of

95

Installation and Setup Guide

Note

Autodeploy will not trigger an update if the computer you are using is running a

Workgroup Server or Event Server. It needs to be a client only installation.

The registry key value of HKEY_LOCAL_MACHINE\SOFTWARE\Hewlett-Packard\HP

TRIM\MSI Setup\Depdate

updates when you first install HP TRIM or when you perform a Service Pack upgrade.

Deactivating HP TRIMAutoDeploy

You can use the following script and Group Policy object to turn off HP TRIM AutoDeploy through the registry for non-HP TRIM users of a computer.

The registry key for HPTRIM_AutoDeploy.wsm called TRIMAutoDeploy_On is in

HKEY_CURRENT_USER\Software\Hewlett-Packard\HP TRIM\MSISettings

and has a default value of 1.

TRIMAutoDeploy.exe

checks this value and will only run if it is set to 1.

You can change this through Group Policy to be 0 for users that are not supposed to see HP

TRIM.

The process works through a combination of a script and a Group Policy object.

The following script will prevent TRIMAutoDeploy from creating HKCU registry keys. It should be saved in the %system%\system32 \GroupPolicy\User\Scripts\Logon folder.

Set Sh = CreateObject("WScript.Shell")

Key = "HKEY_CURRENT_USER\"

SH.RegWrite Key & "Software\Hewlett-Packard\HP TRIM\MSI

Setup\TRIMAutoDeploy_On", 0, "REG_DWORD"

Applying to Group Policy

1 From the Start menu, select Run and type GPedit.msc

2 Select User Configuration Windows Settings Scripts (Logon/Logoff) Logon

3 Right-click and select Properties

4 Click Add.

5 The logon script you saved earlier should appear in the default scripts folder.

6 Select it and click OK twice.

Page

95

of

95

advertisement

Key Features

  • Comprehensive records management
  • Secure and reliable storage
  • Intuitive user interface
  • Scalable architecture
  • Integrated search and retrieval
  • Workflow automation
  • Compliance reporting

Frequently Answers and Questions

What are the system requirements for installing HP TRIM software 7.33?
You can find the detailed system requirements in the HP TRIM Specifications and Requirements document, TRIM7.33_Spec.pdf, located on the installation CD or in your installation folder.
How do I install HP TRIM software 7.33 on a network?
This is the most common installation for organizations. You can find detailed instructions on how to perform a network installation in the Installation and Setup Guide, Chapter 4.
What are the different installation types for HP TRIM software 7.33?
This guide describes different installation types for HP TRIM software 7.33, including network installation, administrative installation, Group Policy installation, batch file installation, and thin client installation.

Related manuals

Download PDF

advertisement

Table of contents