EMC Documentum Site Caching Services

Transcription

1 EMC Documentum Site Caching Services Version 6.5 Installation Guide P/N A01 EMC Corporation Corporate Headquarters: Hopkinton, MA

2 Copyright EMC Corporation. All rights reserved. Published July 2008 EMC believes the information in this publication is accurate as of its publication date. The information is subject to change without notice. THE INFORMATION IN THIS PUBLICATION IS PROVIDED AS IS. EMC CORPORATION MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Use, copying, and distribution of any EMC software described in this publication requires an applicable software license. For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on EMC.com. All other trademarks used herein are the property of their respective owners.

3 Table of Contents Preface... 7 Chapter 1 Site Caching Services Overview... 9 Introducing Site Caching Services... 9 What Site Caching Services does Creating the publishing folders Creating documents for publication Defining publication details Publishing documents How Site Caching Services works Initiating publication Implementing data transfer Publishing documents to the website Chapter 2 Planning for Site Caching Services Installation Site Caching Services prerequisites Required hardware and software Host requirements Connection Pooling on the Content Server host Installing Site Caching Services in multi-server configurations Required directories Database requirements OCI and OCI/JDBC libraries on Oracle String attributes and multibyte characters on SQL Server JDBC connection string JDBC connection types Internationalization Network requirements and topologies Required accounts and permissions Preinstallation checklist Chapter 3 Installing, Uninstalling, and Upgrading Site Caching Services Before you start Effects of installing Site Caching Services Source host components Target host components Upgrading Site Caching Services Upgrading on Windows hosts Upgrading on UNIX or Linux hosts Installing Site Caching Services on a source host Installing the source software Configuring the repositories on the source host Configuring a multi-server environment for Site Caching Services UNIX and Linux repositories EMC Documentum Site Caching Services Version 6.5 Installation Guide 3

4 Table of Contents Windows repositories Troubleshooting source installation Installing Site Caching Services on a target host Installing the target software Configuring the target software Configuring the target without a database Configuring the RDBMS target Configuring the XML Store (Standalone) target Completing the installation process Running the webcache_root_task on UNIX and Linux Creating new digital authentication certificates Creating certificates on a Windows host Creating certificates on a UNIX or Linux host Validating the RDBMS database connections Validating the database connection string on the source host Validating the database connection string on the target host Viewing Site Caching Services source status Validating the installation process Uninstalling Site Caching Services Uninstalling Site Caching Services from Windows hosts Uninstalling from UNIX and Linux hosts Appendix A Site Caching Services Attributes and Keys Site publishing configuration attributes Required site publishing configuration attributes Optional site publishing configuration attributes The agent.ini file Configuring non-database targets Required agent.ini keys for non-database target Optional agent.ini keys for non-database targets Configuring RDBMS targets Required agent.ini keys for RDBMS targets Optional agent.ini keys for RDBMS targets Configuring XML Store (Standalone) database targets Required agent.ini keys for XML Store (Standalone) database targets Optional agent.ini keys for XML Store (Standalone) database targets Appendix B Troubleshooting Database Connections RDBMS database connections Oracle preinstallation requirements Oracle JDBC connection string Oracle JDBC_DRIVER key Sybase preinstallation requirements Sybase JDBC connection string Sybase JDBC_DRIVER key SQL Server preinstallation requirements SQL Server JDBC connection string SQL Server JDBC_DRIVER key DB2 preinstallation requirements DB2 JDBC connection string DB2 JDBC_DRIVER key XML Store (Standalone) database connections General troubleshooting tips EMC Documentum Site Caching Services Version 6.5 Installation Guide

5 Table of Contents Avoiding publishing failures after changing XML Store (Standalone) database installation folder Errors connecting to XML Store (Standalone) database Appendix C Output of an End-to-End Test EMC Documentum Site Caching Services Version 6.5 Installation Guide 5

6 Table of Contents List of Tables Table 1. Minimum hardware and software requirements Table 2. Required accounts and permissions Table 3. Preinstallation checklist Table 4. Required site publishing configuration attributes Table 5. Optional site publishing configuration attributes Table 6. Required agent.ini keys for non-database targets Table 7. Optional agent.ini keys for non-database targets Table 8. Required agent.ini keys for RDBMS targets Table 9. Optional agent.ini keys for RDBMS targets Table 10. Required agent.ini keys for XML Store (Standalone) database targets Table 11. Optional agent.ini keys for XML Store (Standalone) database targets EMC Documentum Site Caching Services Version 6.5 Installation Guide

7 Preface This manual contains the information and instructions you need to successfully install, uninstall, or upgrade Documentum Site Caching Services (SCS). SCS allows you to publish documents from a repository directly to a website. SCS provides services required by Documentum Web Publisher but you can use SCS without Web Publisher. For information on using SCS, refer to the Site Caching Services User Guide. Intended audience This manual is intended for people who plan SCS installations and install the software. Typically, system administrators install, upgrade, and uninstall SCS. Revision history The following changes have been made to this document: Revision history Date July 2008 Description Initial publication. EMC Documentum Site Caching Services Version 6.5 Installation Guide 7

8 Preface 8 EMC Documentum Site Caching Services Version 6.5 Installation Guide

9 Site Caching Services Overview Chapter 1 This chapter contains a brief overview of Site Caching Services and outlines a typical Site Caching Services installation. It gives a basic description of the Documentum environment and relates the Site Caching Services components within the installation. This chapter contains the following sections: Introducing Site Caching Services, page 9 What Site Caching Services does, page 10 How Site Caching Services works, page 12 Introducing Site Caching Services Documentum Site Caching Services publishes documents from a Documentum repository directly to a website, allowing you to combine the versioning, workflow, document lifecycle, and other content management capabilities of Documentum with the accessibility of a website. SCS allows you to identify groups of documents to publish to the web, which version and format to publish, and when to publish the documents. This ensures that content on your website is accurate and timely. SCS also allows you to export document attributes to a database on the web server. You can use the exported attributes to customize the documents you publish by inserting attributes into HTML META tags and to control the content made available to users of the website. For example, a website for music lovers might classify documents by type of music. Classical music lovers see content related to symphony orchestras, while country music fans see content related to country singers and groups. You can use SCS by itself or with custom applications you develop. Application servers such as BEA WebLogic and IBM WebSphere can access the repository of documents and attributes created by SCS (called an SCS repository) and provide application and personalization services based on this data. EMC Documentum Site Caching Services Version 6.5 Installation Guide 9

10 Site Caching Services Overview SCS is also a prerequisite for using Documentum Web Publisher. What Site Caching Services does SCS publishes documents directly from a repository to a website. Documents are developed using Documentum client products, such as Web Publisher, and controlled and maintained using Content Server and a repository. When it is appropriate to transfer documents to the website, use SCS for publishing. You do not need to transfer documents manually or manage them outside of a repository. You can publish documents from an existing repository. The repository can include whatever cabinets and folders your business processes require. There are no special repository configuration requirements other than installing SCS. You do not need to define additional objects to support SCS. SCS can publish any document whose object type is a subtype of dm_sysobject, including custom objects and objects with no associated content file. In addition to publishing documents, SCS can export document attribute values from the repository to a database instance that is available from the website host. Applications you create can then use these values to customize content for individual visitors to the site. In support of Media Transformation Services, SCS can publish the values of certain attributes from the dmr_content object type and the dm_format object type. Refer to the section called Publishing Media Transformation Services Attributes in the Site Caching Services User Guide for complete information on this feature, and to Site publishing configuration attributes, page 59 for information on parameters in the site publishing configurations that relate to this feature. Before you publish documents, plan your website. You must decide what kinds of documents the website requires, whether to use an application server or create custom applications, whether to use document attributes to personalize the content served to individual users, and how to structure the website. After the website is planned, create the publishing folders in the repository and the documents to publish. You then define the publishing details and publish the documents. Creating the publishing folders SCS publishes only documents that are stored in or linked to repository cabinets or folders called publishing folders. (Documentum Web Publisher refers to publishing folders as delivery cabinets.) Each publishing folder can include as many subfolders as necessary. 10 EMC Documentum Site Caching Services Version 6.5 Installation Guide

11 Site Caching Services Overview When you publish, the hierarchy of a publishing folder is duplicated exactly on the web server host. The publishing folder hierarchy in the repository must match the structure planned for the website. On Windows, the length of the repository (folder) path to an object to be published, plus the length of the object name, plus the length of the export directory on the Content Server host is limited to 255 characters. On UNIX and Linux, there is no length limitation. Creating documents for publication Content providers can create a document for publication using any appropriate tool. The content can be in any format. SCS can also publish documents that do not have associated content files. Documents can be checked in to the repository using any Documentum client or application. They must be checked in or linked to a publishing folder in order to be published. De ning publication details The details of publication are stored in site publishing configurations. You can create multiple site publishing configurations to cover multiple publication scenarios. Each site publishing configuration contains the information SCS needs for a single publishing operation. The publishing operation can be performed manually or a job can be created to publish automatically at scheduled intervals. For example, some website content, such as press releases, might be updated daily. Other content, such as event calendars, might be updated monthly. The site publishing configuration is primarily stored in two objects in the repository, the webc config object and webc target config object. The scs_admin_config object (on the source) and agent.ini file (on the target) also contain information used by SCS during a publishing operation. A site publishing configuration includes the following information: Where to find the documents to publish (the publishing folder) Which document formats and versions to publish Whether to publish document attributes What directories to use during the publication process How to connect to the website host EMC Documentum Site Caching Services Version 6.5 Installation Guide 11

12 Site Caching Services Overview Whether to run any scripts before or after publication and which scripts to run What account to use to publish the documents Publishing documents When the publishing process is initiated, SCS uses the site publishing configuration to determine which documents to publish and which folder to find them in. SCS then bundles together the documents and any attributes identified by the site publishing configuration and exports them to the Content Server host s file system. SCS transfers the documents and attributes from the Content Server host to the web server host. SCS runs any scripts that are required to be run before the website is synchronized with the repository, then updates the website and runs any scripts that are required to be run after the update. Five types of publication are possible: A full refresh publishes every document in the publishing configuration that meets the criteria defined in the publishing configuration. An update property schema publishing operation updates the database schema but does not republish all content files and metadata. An incremental refresh publishes only documents that have changed. A force refresh overwrites all published content files and attributes. A single-object publish publishes only one designated document. The first time you publish, SCS automatically performs a full refresh. For more information on publishing documents, refer to Chapter 2, Publishing Documents, in the Site Caching Services User Guide. How Site Caching Services works SCS runs on a TCP/IP network that incudes Content Server and a website host, to which SCS must be able to transfer files. SCS connects to the database used by Content Server and, if you choose to export attributes, a database available from the website host. The SCS software is composed of two separately installed components: source software and target software. The source software is installed on a repository host. Content Server and a repository are prerequisites for installing the SCS source software. One SCS source instance serves all repositories in a Content Server installation, and each repository must be configured to use SCS. The target software is installed on a website host. The target software can be installed on multiple hosts, allowing a single repository and SCS source to support multiple websites. 12 EMC Documentum Site Caching Services Version 6.5 Installation Guide

13 Site Caching Services Overview SCS is associated with two initialization files: The webcache.ini file is stored on the Content Server host. It is created when Content Server is installed. The function of the webcache.ini file changed in SCS version 6.0. SCS no longer uses webcache.ini to store any configuration information. It now uses the scs_admin_config object to store configuration information such as JDBC Driver and database connection information. However, the SCS source reads database connection information and JDBC driver information from the webcache.ini file during installation, and stores it in scs_admin_config for later use. The agent.ini file is stored on the target host. It is created when the SCS software is installed on the target host. The agent.ini file contain database connection information, timeout information for different SCS processes, file-compression information, security information, and other configuration information. Some keys are set when SCS is installed. Other keys are set when a site publishing configuration is created. Initiating publication After documents and a site publishing configuration are created, the documents are published to the website. Publication can be initiated in three ways: Using Documentum Administrator or the HTTP_POST method By running a scheduled publishing job By promoting a document to a lifecycle state that requires publication If you are using Web Publisher, documents are published automatically according to the requirements of the document lifecycle attached to each document. For more information about initiating publication, refer to the Site Caching Services User Guide. When publishing is initiated, the SCS source software connects to the repository and locates the required site publishing configuration. Each site publishing configuration identifies the following components: A publishing folder An export directory on the Content Server host A target root directory on the website host The documents to publish (version and format) Whether to export document attributes How to connect to the website host What account SCS uses (the transfer user account) EMC Documentum Site Caching Services Version 6.5 Installation Guide 13

14 Site Caching Services Overview For more information on creating site publishing configurations, refer to the Site Caching Services User Guide. When SCS locates the site publishing configuration, it exports all appropriate documents and attributes from the repository and bundles them into an export data set. The export data set is stored temporarily on the Content Server host in the export directory. The documents and attributes are now ready for transfer to the website. Implementing data transfer Data transfer requires a directory on the website host called the data transfer directory. The data transfer directory is identified as part of the target software installation process. To effect the transfer, the SCS source software connects across the network to the SCS target software, using the transfer user account identified in the site publishing configuration. SCS then transfers the export data set from the export directory on the Content Server host to the data transfer directory on the website host. The export data set is transferred using either HTTP or HTTPS. The appropriate protocol is identified at target installation time and must be also be designated in the site publishing configuration. Typical network topologies locate the Content Server host inside a firewall. The website is typically outside the firewall. The transfer user account must be one that can be authenticated from outside the firewall. Publishing documents to the website Publication is completed when the SCS target software transfers the export data set from the data transfer directory to the target root directory for the website, a process that synchronizes the website with the repository. The target root directory is identified in the site publishing configuration. If the export data set includes attributes, the target software also connects to a database. The site publishing configuration can optionally specify the use of an online synchronization directory, which minimizes the impact of the publishing process on website users. 14 EMC Documentum Site Caching Services Version 6.5 Installation Guide

15 Site Caching Services Overview During publishing, SCS can also run scripts that perform any arbitrary action on the website host. The scripts can run before or after the export data set is transferred from the data transfer directory to the target root directory. EMC Documentum Site Caching Services Version 6.5 Installation Guide 15

16 Site Caching Services Overview 16 EMC Documentum Site Caching Services Version 6.5 Installation Guide

17 Chapter 2 Planning for Site Caching Services Installation This chapter provides the information you need to plan to install Documentum Site Caching Services (SCS). It describes the requirements for installing SCS, and outlines the necessary preinstallation tasks. The chapter includes the following topics: Site Caching Services prerequisites, page 17 Network requirements and topologies, page 25 Required accounts and permissions, page 26 Preinstallation checklist, page 28 Site Caching Services prerequisites Installing SCS in your environment may require changes to the following components: Hardware and software Host systems Directory structure Databases Network topologies Required hardware and software SCS runs under Microsoft Windows Server, Solaris, HP-UX, AIX, and Linux on both source and target. The source and target machines can run different operating systems, provided the combination is certified by Documentum. For complete information on operating system versions, refer to the Site Caching Services Release Notes for the version you are installing. EMC Documentum Site Caching Services Version 6.5 Installation Guide 17

18 Planning for Site Caching Services Installation Table 1, page 18 lists the minimum hardware and software requirements for running SCS. The disk space requirements listed are the minimum recommended amounts. The amounts you need depend on your business requirements, the configuration of your hardware, the size of your Documentum repositories, and the number and size of documents you publish to websites. Refer to the documentation for each component for full information on the hardware (CPU, disk space, and RAM) required by that component. Table 1. Minimum hardware and software requirements Component Content Server RAM on Content Server host Web server Website host Disk space on website host Requirement Install the software version certified for your version of SCS. For information about the certified version, see the Site Caching Services Release Notes. The Content Server host must have 80 MB of free disk space for installing the SCS software. All Content Servers and repositories in a particular server installation must be running and accessible when you install SCS. SCS is not supported in repository federations, distributed configurations, or when replication is used. Microsoft Cluster Services is supported. After SCS is installed the host must still have sufficient disk space available for export data sets. Meets the requirements for installing and running Content Server and a repository. The appropriate web server for any web applications or application servers running on the website. Meets the requirements for installing and running an HTTP server and the SCS target software. Approximately 45 megabytes for installing SCS. 18 EMC Documentum Site Caching Services Version 6.5 Installation Guide

19 Planning for Site Caching Services Installation Component Disk space for publishing on website host RDBMS or XML Store (Standalone) Requirement At least three times the amount of disk space required by your website. Refer to the Site Caching Services Release Notes for information on which database versions are certified with SCS: Required for the SCS source software Optional for the SCS target software Host requirements The SCS software is typically installed on two or more machines. The source software must be installed on a repository host. It can also be installed on remote hosts running additional servers for the repository. The target software must be installed on a website host. If your network includes multiple repositories or website hosts, multiple instances of the source software and target software can be installed. If your network includes a server farm, it is not necessary to install the target software on every website host. Documentum Site Deployment Services (version 5.3.x) can be used to broadcast web content from a single target host to the servers in the farm. For more information, refer to the documentation for Site Deployment Services. If you are using the optional database replication feature of Site Deployment Services 5.3.x with Site Caching Services 6.5, consult the Site Caching Services Release Notes for installation information. Note: XML Store (Standalone) databases do not support database replication. When you install the SCS source software, all repositories in the server installation must be running and accessible. The SCS source software serves all repositories in the installation. On Windows systems, there can be only one server installation per host. On UNIX and Linux systems, there can be multiple server installations per host. Each installation can have multiple repositories and servers. SCS is not supported in repository federations, distributed configurations, or when replication is used. However, Microsoft Cluster Services is supported. For more information on Content Server installations, refer to the Content Server Installation Guide. Ensure that the temporary directory used by the Java Virtual Machine has 300 MB free during the installation process. On UNIX and Linux, this is usually /var/tmp or /tmp. On Windows, it is typically C:\Documents and Settings\<user_name>\Local Settings\Temp. If you are using SCS with Web Publisher, you must create separate SCS repositories and site publishing configurations for Web Publisher s three required document lifecycle EMC Documentum Site Caching Services Version 6.5 Installation Guide 19

20 Planning for Site Caching Services Installation states. These repositories can reside on a single host or on separate hosts. To create multiple SCS repositories on a particular host, run the target configuration program once for each repository. For more information on Web Publisher s configuration requirements, refer to the documentation for Web Publisher. If you are not using Web Publisher, you can still install the target on multiple hosts. For example, you might publish to more than one website from a single repository. Each website can be located on a different host. If you use different target root directories on a single host, more than one website can be located on a host. For more information on the target root directory, refer to Required directories, page 21. Caution: Do not publish to a single website from multiple publishing folders or repositories. This corrupts the website. You can install both the source and target software on a single host, as long as it is a repository host. However, because in a typical operating environment website hosts are outside the firewall and repositories are inside the firewall, such a configuration is not secure. Install the software on a single host only for development or testing. For more information about recommended network topologies, refer to Network requirements and topologies, page 25. Connection Pooling on the Content Server host We recommend that you set connect_pooling_enabled to TRUE in the dmcl.ini file. Installing Site Caching Services in multi-server con gurations A repository can be served by multiple Content Servers running on the repository host or on remote hosts. You can optionally install the SCS source software on each host where a Content Server is installed, and publishing can then be initiated by connecting to the remote servers as well as from the local server. In a multi-server configuration, the export directory and the $DOCUMENTUM/dba/config directory must be on a shared drive. Refer to Configuring a multi-server environment for Site Caching Services, page 39 for information on setting up the shared drive for the $DOCUMENTUM/dba/config directory. In multi server configurations, site publishing configurations must be created or modified while you are connected to the primary server. 20 EMC Documentum Site Caching Services Version 6.5 Installation Guide

21 Planning for Site Caching Services Installation Required directories SCS requires certain directories on the source and target hosts. On the Content Server host, you designate an export directory when you create a site publishing configuration. The export directory is where the export data set is stored after it is exported from the repository and before it is transferred to the target host. Use an existing directory as the export directory, or, if you do not designate an export directory, SCS uses the default directory $DOCUMENTUM/share/temp/web_publish. If SCS is installed in a multi-server configuration, the export directory must be on a shared drive. Note: On Windows, the length of the repository path to an object to be published, plus the length of the object name, plus the length of the export directory on the Content Server host is limited to 255 characters. On UNIX and Linux, there is no length limitation. On the target host, where the website resides, you designate a data transfer directory at install time and a target root directory (webroot) when you create a site publishing configuration. The data transfer directory is the directory to which the export data set is transferred from the Content Server host. Create the data transfer directory before you install SCS, or the installer creates it during target installation. The default is SCS_target_install_dir/data/portno, where SCS_target_install_dir is the directory in which you are installing SCS and portno is the port where SCS listens. The target root directory (webroot) is the directory from which documents are served by the web server. The target root directory must be in the hierarchy of your web server s document root; for example, C:\Inetpub\wwwroot\mywebsite. You can also optionally designate an online synchronization directory to use when data is transferred to a live website. You can create the data transfer directory, target root directory, and online synchronization directory when you are planning and designing your website. If the website already exists when you begin to use SCS, any arbitrary directories can be designated as data transfer directory and online synchronization directory. The target root directory is the root of the website hierarchy. Database requirements Different database requirements apply to the SCS source and target software. The source software must have access to the database instance used by the repository. The database can be on the Content Server host or on a remote host. For a complete description of the database requirements for Content Server and the repository, refer to the Content Server Installation Guide. EMC Documentum Site Caching Services Version 6.5 Installation Guide 21

22 Planning for Site Caching Services Installation The target software requires access to a database only if you export document attributes as part of the publication process. The database can be either on the website host or remote. If you run Oracle, DB2, or XML Store (Standalone), ensure that the database SCS uses is created before you install SCS (SCS can create the tablespaces, but not the database). Use of a database by the target software imposes two additional requirements: A user name and password must be available for SCS to use to connect to the database. A database system user name and password must be available to allow SCS to create a new tablespace at install time. When a target database is used, it is typically the same type as the database used by Content Server. Some certified configurations support the use of systems from two different vendors. Refer to the Site Caching Services Release Notes for your version to see which configurations are supported. SCS 6.5 is supported on Oracle 10g and 11g. At installation time, the SCS source configuration program chooses the correct JDBC driver to install. If there are multiple repositories on a host and the repositories use different versions of Oracle, the JDBC driver corresponding to the most recent Oracle version is installed. For example, if Oracle 10 and Oracle 11 are used by different repositories, the Oracle 11 driver is installed. A type 2 JDBC connection is used for the most recent Oracle version and a type 4 JDBC connection for the earlier versions. On the target host, the Oracle 10 driver is always installed and a type 4 JDBC connection is used. OCI and OCI/JDBC libraries on Oracle Ensure that the Oracle OCI and JDBC/OCI interface libraries are installed correctly. If they are not installed correctly, publishing with a Type 2 JDBC connection fails, but the publish will continue and succeed with a Type 4 JDBC connection. However, we recommend setting up the OCI and JDBC/OCI interface libraries so that a Type 2 connection is used. On UNIX and Linux platforms, the OCI libraries are typically in the $ORACLE_HOME/lib directory and they are named libocijdbc.*. On Windows, the OCI libraries are typically in /bin directory and they are named ocijdbc*.dll. For more information, refer to the Oracle documentation and your DBA. On UNIX and Linux, ensure that the source installation owner, who is also the Documentum Server installation owner, has the Oracle library directory, $ORACLE_HOME/lib, in the shared library path environment variable. On Solaris, this is the LD_LIBRARY_PATH. On HP-UX, this is SHLIB_PATH. On AIX, this is LIBPATH. 22 EMC Documentum Site Caching Services Version 6.5 Installation Guide

23 Planning for Site Caching Services Installation The Oracle library directory may vary depending on which JVM you use. For example, on HP-UX, if you are using the 32 bit JVM, include $ORACLE_HOME/lib32 in the shared library path environment variable before $ORACLE_HOME/lib. If you use the HP-UX 64 bit JVM, include $ORACLE_HOME/lib before $ORACLE_HOME/lib32. String attributes and multibyte characters on SQL Server SQL Server has a limit of 8,060 bytes per row. By default, Documentum string attributes stored in the SQL Server database are in the nvarchar format. This allows multibyte characters, such as metadata in Japanese or Korean, to be stored. When nvarchar is used, some characters other than Japanese and Korean characters take more bytes to store than under varchar, and database inserts may fail because the total length of all columns in a row is longer than 8,060 bytes. The value of the mssql_store_varchar key in the site publishing configuration is used to determine how string attributes are stored. The default value (when not set) is FALSE and string attributes are stored as nvarchar. To store string attributes in the SCS source catalog and target database using varchar instead of nvarchar, set the mssql_store_varchar key to TRUE. If you set mssql_store_varchar to TRUE, you cannot store multibyte string attributes in the source catalog and target database. How to change from nvarchar to varchar depends on which JDBC driver you use: With the JDBC-ODBC driver, set the value of mssql_store_varchar to TRUE and run either a recreate property schema publish or an update property schema publish. With the Microsoft JDBC Driver, set the value of mssql_store_varchar to TRUE and run a recreate property schema publishing operation. JDBC connection string When you install SCS on the target host, the installer attempts to construct a correct JDBC connection string. You can test the connection to the database during the installation procedure. In some cases, the JDBC connection string does not allow SCS to connect to the database. If the connection attempt fails, we recommend that you complete the installation and then examine the value of the database_connection key in the agent.ini file (on the target host) and the scs_admin_config object (on the Content Server host). For complete information on the correct values for the JDBC connection string for each certified database, refer to Appendix B, Troubleshooting Database Connections. EMC Documentum Site Caching Services Version 6.5 Installation Guide 23

24 Planning for Site Caching Services Installation JDBC connection types On the Content Server host, Oracle and SQL Server, SCS uses Type 2 JDBC drivers. On the Content Server host, Sybase and DB2, SCS uses Type 4 JDBC drivers. On the target, SCS uses Type 4 JDBC drivers. Internationalization On UNIX and Linux hosts (source or target), ensure that the LC_ALL environment variable is set to C in the installation owner s environment. If you use Oracle, Sybase, or DB2, create the database using the UTF-8 code page. If you use SQL Server, refer to the Content Server Installation Guide for information on configuring SQL Server for internationalization. If you are using SQL Server with the Shift-JIS code page, install the Microsoft Type 4 JDBC driver for SQL Server. To install the Microsoft JDBC driver: 1. Download the Microsoft SQL Server 2005 Driver for JDBC from the MSDN download site ( 2. Stop the source and target software. 3. Copy the following file from the driver to the source and target hosts: sqljdbc.jar 4. On the source host, copy the files to $DOCUMENTUM_SHARED\jboss4.2. 0\server\DctmServer_WEBCACHE\deploy\scs.ear\APP-INF\lib. 5. Navigate to Administration/Site Publishing/SCS Administration. 6. Select the config object. Right-click to view its properties. a. Also on the Info tab, change JDBC_DRIVER to: JDBC_DRIVER=com.microsoft.sqlserver.jdbc.SQLServerDriver b. On the Info tab, locate the database_connection attribute. Modify this attribute to: 7. Select OK. database_connection=jdbc:sqlserver://database_host:1433; SelectMethod=cursor 8. On the target host, copy the files to SCS_install/product/jre/nt/JavaSoft/JRE/1.2/lib/ext. 9. Open the agent.ini file. 24 EMC Documentum Site Caching Services Version 6.5 Installation Guide

25 Planning for Site Caching Services Installation 10. Change the JDBC_DRIVER key to: JDBC_DRIVER=com.microsoft.sqlserver.jdbc.SQLServerDriver database_connection=jdbc:sqlserver://database_host:1433; SelectMethod=cursor 11. Save the agent.ini file. Network requirements and topologies SCS does not impose any unusual topology requirements on a properly-configured TCP/IP network. Typically, the repository host is inside a firewall, while the website host is outside the firewall. Host requirements are described in Host requirements, page 19. The SCS source software must be able to transfer data to the target software. Therefore, you must know what ports are available for connecting through the firewall, and the transfer user account identified in the site publishing configuration must be an account whose authenticity the target software can verify outside the firewall. You must decide at target installation time whether to use the HTTP (non-secure) or HTTPS (secure) protocol for data transfers to the target host: The HTTP protocol sends unencrypted data, but data is transferred faster. If your network is secure and traffic between the Content Server host and the SCS target host is secure, you can safely use an non-secure connection. The HTTPS protocol sends encrypted data and provides more security for your operations. A secure connection can be up 30% slower than an non-secure connection. You must determine which ports are available on the host machine and which ports use secure (HTTPS) or non-secure (HTTP) communications. The services file on the host machines indicates which ports are used by which applications. SCS can use ports numbered from 1024 to During source installation, you provide two port numbers. These ports are for internal communication between JBoss and Content Server. You can use any available port numbered between 1024 to Use ports that are not exposed through your firewall. Ensure that you do not use the same ports used by the JBoss instance that acts as the Java Method Server for Content Server. For more information on the Java Method Server, refer to the Content Server Installation Guide. The primary port is where JBoss listens for SCS-related HTTP requests issued by Content Server. The administrative port is used for JBoss administration and does not affect SCS. These ports must not be used by any other application. If you install the SCS source software on a Windows host that is a member of a workgroup rather than a domain, use the host name when the installer requests the EMC Documentum Site Caching Services Version 6.5 Installation Guide 25

26 Planning for Site Caching Services Installation installation owner s domain name (for example, cressida or eng2695). Do not leave the domain name blank, or the SCS service will not start. When a site publishing configuration is created, a target host name or IP address must be provided. All target host names must have DNS entries. Otherwise, the host s IP address must be used. Required accounts and permissions This section discusses the Documentum, operating system, and database accounts that are required, as well as the permissions a user must have to install SCS. During SCS target installation, you must have the database system user name and password available if you are installing with a database for exported attributes. On UNIX and Linux target systems, either you must know the root password at the time you install, or a particular task must be performed after installation by a user who knows the root password. XWindows must be installed on the UNIX and Linux target host to run the graphical installer and the xterm program must be in the SCS target installation owner s path. The xterm program may be installed in various locations depending on your operating system and software packages installed. Some sample locations are: On Solaris: /usr/openwin/bin On HP-UX and AIX: /usr/bin/x11 On Linux: /usr/x11r6/bin Verify that the xterm program is in one of the above paths or in an alternate location and add that location to your PATH variable. You can also install remotely using Exceed. Ownership of a live website may be determined by the web server; SCS places no additional restrictions on ownership of the live website. However, the user who runs SCS on the web host must have full access to the website and to the alternate webroot, if one is used. Table 2. Required accounts and permissions Required account Required to Comments Documentum installation owner Documentum installation owner or repository owner Install SCS on the Content Server host. Modify the site publishing configuration. The Content Server installation owner. 26 EMC Documentum Site Caching Services Version 6.5 Installation Guide

27 Planning for Site Caching Services Installation Required account Required to Comments SCS target installation owner Database administrator account (name and password) for target database Database user account and password for target database Install SCS on the target host. Create the database user account when installing SCS on the target host machine, if configuring SCS with a database. Access the database, if SCS target runs with a database. Must have access to directories required by SCS. On Windows, the person installing SCS must be a member of the Windows Administrators group and must have the Windows privilege act as part of operating system. On UNIX or Linux, if you use system authentication on the target host, one installation task requires knowing the root password. The task can be completed during or after installation. (Installation can be completed without this step.) For more information, refer to Running the webcache_root_task on UNIX and Linux, page 49. On UNIX or Linux, xterm must be in the path of the person installing the SCS target software. This is the sa account on Sybase and SQL Server; SYSTEM on Oracle. On DB2, the database user account must be an operating system account. EMC Documentum Site Caching Services Version 6.5 Installation Guide 27

28 Planning for Site Caching Services Installation Required account Required to Comments Transfer user account and password On UNIX and Linux target systems, the root account password Transfer the export data set from the source host to the target host. Install SCS. Each site publishing configuration can have a different transfer user. Any user with an operating system account can be designated as the transfer user. Preinstallation checklist Before you install SCS, complete the following tasks: Table 3. Preinstallation checklist Requirement Review the Site Caching Services Release Notes. Review Appendix B, Troubleshooting Database Connections. Review your hardware configuration to ensure that it meets the minimum requirements for running Documentum Content Server and a web server. Review the operating systems on the Content Server host and web server host to ensure that they meet the minimum requirements. Install Content Server and a repository and ensure that they are properly installed and configured. For more information Refer to the Site Caching Services Release Notes for the version you are installing. Content Server Release Notes and documentation for the web server and its host. Content Server Release Notes and documentation for the web server and its host. Content Server Release Notes and Content Server Installation Guide. Decide whether to use a target database. Database requirements, page EMC Documentum Site Caching Services Version 6.5 Installation Guide

29 Planning for Site Caching Services Installation Requirement If you plan to use a target database: Confirm that the source and target databases constitute a certified combination. Install the database and ensure that it is accessible from the website host. Install the database with the UTF-8 code page. Ensure that the database system user name and password are available during SCS installation. Obtain the port number to use for the database s JDBC connection. Obtain the ports to use for internal communications with the SCS source software. Ensure that you have access to the accounts and passwords necessary for installing and configuring SCS. Decide whether to transfer information from the Content Server host to the website using secure (HTTPS) communications or non-secure (HTTP) communications. Designate an account to use as the transfer user or create an account to use as transfer user. If you are running the SCS target on Windows, identify the domain where SCS authenticates the transfer user name and password used to transfer data from the Content Server host. On UNIX and Linux target systems, obtain the root password. Obtain the information necessary for constructing the JDBC connection string for your database. If you use SQL Server for the target database, set up a valid ODBC datasource. For more information Site Caching Services Release Notes and Database requirements, page 21. For database installation procedures, consult the documentation for the database you are using. Appendix B, Troubleshooting Database Connections Appendix B, Troubleshooting Database Connections Network requirements and topologies, page 25 Required accounts and permissions, page 26 Network requirements and topologies, page 25 Required accounts and permissions, page 26 Required accounts and permissions, page 26 Appendix B, Troubleshooting Database Connections Documentation for SQL Server EMC Documentum Site Caching Services Version 6.5 Installation Guide 29

30 Planning for Site Caching Services Installation Requirement If you use Sybase, determine: Which version of the Sybase jconnect JDBC Driver is used. The Sybase device names that already exist. Device numbers that already exist. Device file names that already exist. The location to which the $SYBASE and $DSQUERY environment variables point. Ensure that the SCS license key is available. Install Documentum Administrator 5.3 or later. On the source host, ensure that previous versions of SCS are uninstalled and that the installation directory is empty. (On the target host, the software is upgraded in place.) For more information Consult your database administrator. Documentation for the version of Documentum Administrator you are using. Upgrading Site Caching Services, page EMC Documentum Site Caching Services Version 6.5 Installation Guide

31 Chapter 3 Installing, Uninstalling, and Upgrading Site Caching Services This chapter contains instructions for installing, uninstalling, and upgrading Site Caching Services. Review the following sections before installing or upgrading SCS: Before you start, page 31 Effects of installing Site Caching Services, page 32 If a prior version of SCS exists on the host, follow the procedures in Upgrading Site Caching Services, page 33 for upgrading to the 6.5 version. New installations of SCS are discussed in these topics: Installing Site Caching Services on a source host, page 36 Installing Site Caching Services on a target host, page 42 Completing the installation process, page 48 After you install SCS, refer to the Site Caching Services User Guide for information on publishing documents, customizing SCS, and maintaining SCS. To uninstall SCS, refer to Uninstalling Site Caching Services, page 54. Before you start Before you begin installation, read Chapter 2, Planning for Site Caching Services Installation, review the Site Caching Services Release Notes for the version you are installing, and complete the pre-installation checklist in Preinstallation checklist, page 28. You must follow different procedures to install SCS on the source and target hosts. The Windows and UNIX/Linux installation procedures are identical. Which target procedure you follow depends on the database with which you run SCS. You can install SCS on source and target machines running different operating systems and databases. For example, you might install SCS on a source machine running Windows with SQL Server and a target machine running Solaris with Oracle. In such a EMC Documentum Site Caching Services Version 6.5 Installation Guide 31