OpenText Content Server - Installation Guide PDF
OpenText Content Server - Installation Guide PDF
OpenText Content Server - Installation Guide PDF
Installation Guide
LLESCOR100012-IGD-EN-1
OpenText Content Server
Installation Guide
LLESCOR100012-IGD-EN-1
Rev.: 2013-Aug-31
This documentation has been created for software version 10.0.0 plus Service Pack 2 Update 12.
It is also valid for subsequent software versions as long as no new document version is shipped with the product or is
published at https://knowledge.opentext.com.
Open Text SA
Tel: 35 2 264566 1
Tel: +1-519-888-7111
Toll Free Canada/USA: 1-800-499-6544 International: +800-4996-5440
Fax: +1-519-888-0677
Email: support@opentext.com
FTP: ftp://ftp.opentext.com
For more information, visit http://www.opentext.com
Disclaimer
Every effort has been made to ensure the accuracy of the features and techniques presented in this publication. However,
Open Text Corporation and its affiliates accept no responsibility and offer no warranty whether expressed or implied, for the
accuracy of this publication.
Table of Contents
PRE Introduction v
i About this document .......................................................................... v
ii Contact information .......................................................................... vi
This guide assumes that you possess the following knowledge and skills:
Note: If you copy command line examples from a PDF, be aware that PDFs
can contain hidden characters. OpenText recommends that you copy from
the HTML version of the document, if it is available.
KEY NAMES
Key names appear in ALL CAPS, for example:
Press CTRL+V.
<Variable name>
Angled brackets < > are used to denote a variable or placeholder. The user
replaces the brackets and the descriptive content with the appropriate value. For
example, <server_name> becomes serv01.
Internal cross-references
Click the cross-reference to go directly to the reference target in the current
document.
External cross-references
External cross-references are usually text references to other documents.
However, if a document is available in HTML format, for example, in the
Knowledge Center, external references may be active links to a specific section
in the referenced document.
Warnings, notes, and tips
Caution
Cautions help you avoid irreversible problems. Read this information
carefully and follow all instructions.
Important
Important notes help you avoid major problems.
ii Contact information
OpenText Online (http://online.opentext.com/) is a single point of access for the
product information provided by OpenText. You can access the following support
sources through OpenText Online:
• Communities
• Knowledge Center
If you need additional assistance, you can find OpenText Corporate Support
Contacts at http://support.opentext.com/.
Content Server is immediately deployable, out of the box. Its standards-based, open
architecture allows Content Server to integrate seamlessly with multiple platforms,
information repositories, third-party applications, and legacy systems. Its modular
design provides your organization with the highest levels of scalability, extensibility,
accessibility, and security. And, because it is entirely web-based, end users need
only a web browser to use it.
The information in this chapter is intended to help you make important decisions
about how to deploy your Content Server system before you begin to build it.
However, because every Content Server deployment is unique and the potential
variability is wide, the architecture and configuration issues addressed in this guide
are discussed in very general terms. Your specific circumstances may require much
more specific approaches. Contact OpenText Global Services at http://
www.opentext.com/services/ for help with specific system-design issues.
Users interact with Content Server through the web server when using the standard
browser interface, or they may communicate directly with the Content Server using
a desktop application, such as OpenText Explorer.
• Oracle Server®
• Microsoft SQL Server®
Note: For more information about servlets and application servers, see the
section called “The Content Server Java Framework” on page 15.
• Web browsers on client workstations. Content Server supports the following web
browsers:
• Apple Safari™
• Microsoft® Internet Explorer®
• Firefox™; However, because Firefox does not support ActiveX, you will
encounter limitations in using Firefox with Content Server.
• Google Chrome
• An external file system or other data storage system (optional, but
recommended). For example, the OpenText Content Server – Archive Storage
Provider. See the OpenText Content Server – Archive Storage Provider Installation,
Upgrade and Configuration Guide on the Knowledge Center (https://
knowledge.opentext.com/).
This guide includes instruction for configuring third-party components to work with
Content Server. However, you should always refer to the documentation for those
products for complete setup and configuration information.
In addition to U.S. English (the default), the Content Server GUI is available in:
• French
• German
• Japanese
A servlet is a Java object that processes requests and generates dynamic content and
responses, providing an environment for Java code to run in cooperation with a web
server. Java servlets offer some advantages over CGI, including security and the
wide acceptance and use of standard Java APIs.
Servlets are run and managed by a process called a servlet container. An application
server is a set of additional features and capabilities packaged with a servlet
container.
patch will overwrite any customizations you may have made to your Content Server
system.
Note: If you intend to use the IBM WebSphere application server, the
application must be packaged as a WAR file. It is subsequently extracted by
WebSphere. See “Deploying LLServlet on IBM WebSphere” on page 56
To use Content Server features written in Java, you must add an application server
to your Content Server system configuration. See “Configuring the Access Tier”
on page 30
Content Server features are divided into core modules that deliver the product's
basic functionality (such as document management) and optional modules, which
add such capabilities as electronic forms management or email integration.
Content Server can handle web client transactions using CGI, a Java servlet, or ISAPI
(Internet Server API, an API for Microsoft Internet Information Services web server).
The Secure Sockets Layer (SSL) protocol can be used to ensure that only authorized
personnel can access information. Desktop applications can also interact with
Content Server. For example, OpenText Enterprise Connect is an optional module
that enables you to access Content Server using Windows Explorer.
As the number of users increase, the Data Tier begins to require more resources to
provide adequate performance. The standard scaling path in this case is to move
Content Server components, such as the database server, to a dedicated computer.
The database, external file store, and search indexes can each be moved to a
dedicated server, possibly located on a storage area network or SAN. (A SAN is a
dedicated subnetwork that connects storage devices and servers in a pool, providing
consolidated storage and storage management. SANs have become a common
component of enterprise storage systems.)
Note: If you install the Content Server database on a separate computer, you
must install the necessary RDBMS client software (transaction handlers) on the
Content Server computer. See the documentation supplied by your database
software vendor.
As the system grows further, the Admin server begins to require more resources.
The next step of the scaling path is to move the Admin server and its managed
processes to a dedicated computer.
This architecture employs a dedicated Admin server to run the Enterprise search
infrastructure on a separate computer. In particular, this architecture improves
search performance by running the Content Server processes that handle search and
update requests on a separate computer. This also gives the Content Server more
resource to handle the operations for which it is responsible, such as user log-ins,
page serves, file uploads and downloads, and so on.
For optimum performance and scalability, OpenText recommends that you design
your Content Server system with multiple Admin servers running on dedicated
computers, with each handling particular indexing and searching processes. As with
the Enterprise index, you can place other indexes (such as the Directory Walker and
the Index Engine) on one or more additional computers. In such configurations, the
computer on which the Content Server service runs is known as the Content Server
host , the first Admin server is known as the primary Admin host), and the computers
on which additional Admin servers run are called secondary Admin host. See
OpenText Content Server Admin Online Help - Search Administration (LLESWBS-H-
AGD).
If you decide to follow this recommendation, you must install and register an
Admin server on each additional computer. To accomplish this, you install Content
Server on a computer as normal, but enable only the Admin server to run on that
computer. See “Registering a Secondary Admin Server” on page 87. For more
information about the tasks involved in installing and setting up an additional
computer, see the following:
Note: You can run multiple Admin servers, but there can be only one instance
of Content Server running at a time unless you configure a server cluster to
serve as the Content Server computer. See the section called “Content Server
Cluster Architecture ” on page 20.
From this point, further scaling is accomplished by adding multiple Content Server
instances and using a network load balancer.
To enable organizations to configure a Content Server client and the Content Server
service on different computers, possibly across a firewall, OpenText provides the
Content Server Secure Extranet Architecture (SEA). The chief component of the SEA
is the OpenText Content Server Servlet. The servlet, also known as LLServlet, is a
J2EE servlet component that enables the successful implementation of the secure
extranet architecture using the recognized security capabilities provided by the J2EE
standard. In this architecture, a Content Server proxy client sends document files to
the Content Server by tunneling through port 2099.
The Content Server Servlet can be deployed using any application server that
implements and conforms to the Java Servlet Specification. For a complete list of the
application servers that have been officially tested by OpenText, consult the Content
Server Release Notes.
• With internal storage, Content Server stores both an item (such as a text file) and
its metadata (such as the file’s creation date) in a database.
• With external storage, only the metadata is stored in the database; the actual file
is stored on an external file system.
External document storage normally provides faster read performance than internal
document storage. Most implementations (and virtually every production
implementation) of Content Server should use external document storage, but
internal storage can be appropriate for a test or development implementation of
Content Server, containing a small number of documents that are not frequently
accessed.
Note: When using external storage, Content Server assigns files a numeric file
name. For example, if a user adds a file called ExpenseReport.xls, its name in
the external storage folder may become 2934856.dat. Content Server uses a
numbering algorithm so that it can keep track of multiple versions of the same
file.
The fastest external storage option is to store document content on a separate disk
located on the same computer as Content Server and the web server. If you place the
external store on the Content Server computer, writing and retrieving documents
may be slightly faster because there is no network delay. The improvement may be
more significant if the Content Server computer is located on a network that is
typically very busy. In such an environment, you should consider placing the
components of the Content Server system on their own, isolated subnet.
With external storage, your backup and recovery strategy may be more complex,
because of the necessity of synchronizing your database and file store backups. One
option is to take the Content Server database and external document store offline
when you create backups. This has the benefit of creating a static data set and a
backup that is synchronized with the metadata in the Content Server database.
However, taking the Content Server database offline may not be a viable option for
global organizations that must operate 24 hours a day. In this case, more complex
backup and recovery strategies may be necessary. For example, if you back up the
external document store while it is online, you then need to synchronize the backup
of the database with that of the external file store. Since the database can be backed
up incrementally, you should make sure that the external file store is also backed up
as frequently as the database. Otherwise, when restoring the data, the database may
include documents for which no external file exists.
• You must create the folder that you want to use as the external document store
before you create the Content Server database. Content Server does not create the
folder if it does not exist.
• If the external document storage folder is not on the Content Server computer,
you must map or mount the folder on the Content Server computer. For UNIX
and Linux, use an NFS mount. For Windows, map a drive to the external
document storage folder.
Note: The external folder that you map to must be specified in the External
Document Storage field. See “Configuring Content Server“ on page 47.
• A remote external document store on Windows must be owned by the user who
runs the Content Server. To achieve this, you need to create a user with the same
name, password, and privileges on both the Content Server computer and the
remote computer where the external document store is located. Content Server
and Admin server need to run as this user, and the document store folder on the
additional computer must be owned by this user. A good practice is to set up a
domain user account for this purpose. For more information about the privileges
that the Windows user must have, see “Creating a Windows User” on page 34.
• After you create and map or mount the external document store folder on an
additional computer, test whether you can access and write to it by connecting to
it from the Content Server computer as the operating-system user that you
created to run Content Server. If you encounter permission or ownership
problems when performing this test, correct the problems before you create the
Content Server database.
To determine the architecture and configuration options that best suit your needs,
you must consider a number of factors:
• The number of named users that will use Content Server
• The anticipated transaction rate
• The amount of data that needs to be stored in the Content Server database
• The presence of legacy systems or applications that need to integrate with
Content Server
• The Content Server hardware environment, including:
• The state of the existing network architecture
• The CPU speed and memory capacity of the various servers
• System storage capacity, speed, and configuration
• Security best practices
Tip: OpenText Professional Services can help you with specific system-design
issues.
Performance Recommendations
Different Content Server system architectures support different transaction rates,
which are expressed as transactions per second (TPS). In general, a capacity of one
transaction per second is sufficient to support 500 named users and 50 active users at
a rate of one transaction per user per second.
The following list contains some of the most basic and widely applicable tips that
will help achieve this level of performance:
• The key bottlenecks to performance of a Content Server system are the CPU
power allocated to Content Server and to the database server, the amount of
RAM available, and network bandwidth and latency. These are the best
performance factors in which to invest.
• Content Server Dynamic Thread Loading creates the minimum number of
threads when it starts and then creates additional threads, as needed, up to the
maximum number. The default minimum and maximum values are 8 and 32.
However, creation of new threads is a relatively intense and time-consuming
process, so better performance can be obtained by setting Content Server to start
the maximum number of threads your system requires, once you have
determined that number through monitoring and observation.
• You can determine an optimal number of threads for your system to run by
closely monitoring the system and making adjustments as necessary. A
reasonable number to start with is eight threads, which is the default minimum
number. The Content Server Monitoring Agent is a useful tool for performing a
performance analysis in real time, while the Content Server Performance
Analyzer is suited for performance analysis using Content Server log files
collected over a period of time. For more information about these tools, see the
Knowledge Center (https://knowledge.opentext.com/).
• When installing Content Server, it is usually best to run the database server,
Content Server, and the Admin server each on its own, dedicated computer.
Most large organizations deploy Content Server using a load-balanced cluster
architecture. See “Understanding OpenText Content Server Architecture”
on page 17.
• OpenText recommends that you consistently monitor your database, your
network, and your web server with their own supplied monitoring tools. This is
especially useful when you first roll out your system. As you monitor the system
and notice peaks in usage, you can use Content Server's audit trail, logs, and
LiveReports to determine what was happening at the time the peaks occurred.
Then, you can make any necessary adjustments.
Database Recommendations
The Content Server must be stored in a relational database management system
(RDBMS) that is listed as supported in the Content Server Release Notes. Your RDBMS
must be installed for UTF-8 compliance.
Content Server's database schema is normalized, which means that the schema has
been designed to reduce the chance of having multiple versions of the same data.
Indexes are provided out of the box on the columns that Content Server uses in its
standard operations. In some cases, however, it may be helpful to build indexes on
additional database table columns, which will speed up the retrieval of information
from SELECT statements (at the cost of increasing overhead when new information is
added to the table because both the table and the index will have to be updated).
Security Recommendations
For most customers, maintaining the security of your organization's Content Server
system is a primary concern. While there is no single correct way to secure a Content
Server system, the following are some general recommendations by OpenText:
• OpenText recommends that you configure your web server to serve only HTTPS,
refusing incoming HTTP connections, in order to employ data encryption and
client authentication safeguards.
• OpenText strongly recommends that you restrict read permissions on the
<Content_Server_Home>/config/ folder as much as possible. Ideally, the only
user with read access should be the operating-system user created specifically for
the Content Server and, (if applicable), the Admin server. Also, make sure to
disable browsing the <Content_Server_Home>/config/ folder through the web
server running on the Content Server computer.
• For organizations that want to enable access to Content Server from an external
network (while adhering to most common organizational IT security policies),
OpenText has developed the Content Server Secure Extranet Architecture (SEA).
See the section called “OpenText Content Server Secure Extranet Architecture
(SEA)” on page 21.
Before you can install Content Server, you must prepare the environment for
installation. Content Server must be installed on a supported operating system, and
requires the presence of a supported web or application server, and a supported
database. This information in this chapter helps you to prepare for installing Content
Server by providing recommendations on the installation and configuration of web
servers, database servers, your operating system and client web browsers.
Note: Fields marked with an asterisk (*) represent information you need
before you install Content Server. You generate the information in the other
fields as you install and set up Content Server.
Save the information you record on these worksheets and store them in a secure
place. You will need this information if you upgrade Content Server.
Consult your application server vendor to obtain the specific plug-in and
documentation for configuring a redirector.
This guide provides guidelines to help ensure that you select the installation options
that Content Server requires to work with your database software and configuration.
For information about how to install and configure your database software, refer to
the documentation supplied by your database software vendor.
Choose the installation guidelines that apply to your supported database platform.
• “Oracle Database Installation Guidelines” on page 31
• “Microsoft SQL Server Installation Guidelines” on page 33
• OracleStartORCL
• OracleServiceORCL
• OracleTNSListener
• Record the Oracle HOME folder or the Oracle SID on Table 3-1: “Oracle Database
Worksheet” on page 27. You will need this information when you install Content
Server on the Content Server computer.
• Oracle recommends that you change the default passwords of the internal, sys,
and system users immediately following installation. The internal user has
privileges to start or stop the database service; the system and sys users have
database administrative privileges. The default password for internal and
system is manager. The default password for sys is change_on_install.
• Record the password for the user system on Table 3-1: “Oracle Database
Worksheet” on page 27. You will need this user name and password when you
create the Content Server database.
• Refer to the Content Server Release Notes for information about any Oracle
software patches that may be required to use your version of Oracle Database or
client software with Content Server. If patches are required, additional
information and support may be available in the Knowledge Center (https://
knowledge.opentext.com/).
On a Content Server computer, you can use the same user for Content Server and
the web server, or you can use different users. It is not necessary to create a
Windows user for Microsoft Internet Information Services, because this is done
automatically during the installation of Microsoft Internet Information Services.
Note: Use an identical Windows user to run all Content Server services on the
Content Server computer and each additional computer. For more information
about assigning user names to Content Server services, see “Setting Up and
Starting the Content Server Services” on page 70. Also, if you are using an
external document store on an additional computer, create an identical user on
that computer to own the external document folder.
Create one or more Windows users to run the Content Server and the web server.
Each user must:
The user that runs the Content Server services must have at least Modify permission
for the <Content_Server_home> folder, and for any other folders that Content
Server accesses, including (if applicable), the index folder, external file store folder,
and upload folder. The exact folders and permissions required depend on your
specific environment.
Record the name and password of the Windows user that you create for Content
Server on Table 3-5: “Content Server Installation Worksheet” on page 29.
Note: If you do not use the same UNIX or Linux user to run the web server as
you use to run the Content Server, you must make sure that the user that runs
the web server has write permissions for the Content Server directory tree.
To create a UNIX user account, you must log in to the Content Server computer as
the superuser root.
Tip: Use the same UNIX user name and password to run all servers on the
Content Server computer and each additional computer. The servers run as the
user that invoked them, so you must always start the servers as the user that
you created for them.
Record the name and password of the UNIX or Linux user that you create for
Content Server on Table 3-5: “Content Server Installation Worksheet” on page 29.
Record the name and password of the Oracle Solaris user that you create for Oracle
iPlanet Web Server on Table 3-4: “Oracle iPlanet Web Server Worksheet” on page 28.
Content Server typically does not require custom configuration settings for web
browsers. If you are using the latest version of a supported browser, you may be
able to use Content Server without changing any default browser settings. However,
if you have special requirements, you may need to make some configuration
changes. If you want to display and enter data in a language different from your
default system language, you must install fonts and input methods for the language.
For example, to view and edit Japanese documents on English Windows, you should
install Japanese fonts and input methods.
You may also wish to tailor your browser’s behavior if Content Server does not open
documents in the manner you expect. See Table 3-7: “Common Issues When
Opening Documents from Content Server” on page 36 for information about
configuring browsers to work with Content Server.
Web browsers on all client computers need to meet the following requirements for
use with Content Server:
How MIME type options are set depends on the web browser version. Microsoft
Internet Explorer and Mozilla Firefox include an extensive set of default settings,
which you can modify as required. OpenText recommends that users open files of
the different types they use and note the default behavior. To change the default
behavior, users can adjust either their web browser settings (Mozilla Firefox) or their
operating system settings (Microsoft Internet Explorer). The following table
describes common issues when opening documents from Content Server.
Table 3-7: Common Issues When Opening Documents from Content Server
Note: For specific platform versions, see the Content Server Release Notes for the
version you are installing.
Before you install Content Server, create a Windows user to run the Content Server
and make sure that the necessary supporting software—including the database
server and client, web server, application server, and web browser—is installed and
properly configured. Detailed information about these and other tasks that you need
to perform before you install Content Server is provided in “Preparing to Install
Content Server“ on page 27.
If you install multiple Content Server instances on one computer, you must ensure
that the installation folder, URL mappings, server ports, and program folder name
of each instance are unique. In addition, verify that all the data flow processes,
search servers, and index servers associated with each existing Content Server
installation are running.
a. Double-click the executable file and then click Run to begin the installation.
b. In the Welcome dialog box, click Next.
c. In the License Agreement dialog box, enable I accept the terms in the
License Agreement, and then click Next.
d. In the Install Location dialog box, accept the default destination folder, or
click Browse to select a different folder, and then click Next.
e. In the Content Server Configuration dialog box, do the following, and then
click Next:
• In the Service Name box, type a unique name for the Content Server
services. The default is OTCS. Use only alphanumeric characters, and do
not include spaces.
Note: The service name you provide appends to the server entries
for the Content Server and Admin services in the Windows
Services window. It also becomes the URL prefix (virtual folder
alias) mapped to the <Content_Server_Home>/cgi/ folder in
your web server.
• In the DNS Name box, accept the default value, localhost, or type the
fully qualified Domain Name Service of the Content Server computer.
Use the format <host.domain.suffix> (for example,
intranet.yourdomain.com).
You must provide the fully qualified DNS name if any of your users
want to connect to Content Server from outside your network. Content
Server uses this name to create links to items in Content Server
notifications and elsewhere. Without the fully qualified DNS name,
these links may not work for remotely connected users.
Tip: To look up the DNS name if you have a static IP address, type
nslookup<hostname> at the Windows command prompt.
• In the HTTP Server Name box, type the host name of the computer on
which the web server resides, or accept the default value.
Note: For HTTP servers, the default port is 80. For HTTPS servers,
the default port is 443.
f. In the Content Server Mapping dialog box, accept the default URL prefix (/
img/) for the support folder, or type a new prefix in the URL Prefix box,
and then click Next.
• In the Service Port box, type an unused port number for the Content
Server service. Valid port numbers range from 1025 to 65535. The
default is 2099.
• In the Admin Port box, type an unused port number for the Admin
server service. Valid port numbers range from 1025 to 65535. The
default is 5858.
• In the RMI Port box, accept the default port number or type a new port
number to be used by RMI to obtain client sockets for RMI calls.
Note: The mappings.tbl file is a text file that contains the URL prefix
(virtual folder alias) path names that you need to map when you
configure your web server or application server. The mappings.tbl
file is available to view at any time in your <Content_Server_Home>
folder.
k. Click Finish.
Important
Do not start the Content Server services at this point. Apply any
required Updates and Hotfixes first.
3. Apply the latest Content Server Update, if your Content Server installation file
does not already integrate the latest Update.
4. Apply any required Hotfixes. If there is more the one Hotfix, apply each one in
ascending numerical order. Extract the contents of each Hotfix file into the
<Content_Server_home> folder (C:\OPENTEXT, by default), overwriting any files,
as necessary.
5. Set up and configure the virtual folders for the Content Server web server.
Follow the instructions at “Mapping Content Server URL Prefixes in a Web
Server” on page 60, and then continue to the next step.
7. Start the Content Server services and continue the Content Server installation.
a. From the Start menu, click OpenText Content Server (OTCS), and then
click Content Server Administration.
b. On the Configure Server Parameters page, type the administrator password
in the Administrator Password and Verify Password boxes.
Note: You should change the Admin password after the initial sign in
to Content Server.
c. In the License Key section, type the company name, license expiration date,
and number of users the license is for, as provided by OpenText, in the
appropriate boxes.
d. Modify any of the other available settings, or accept the default values, and
then click the Save Changes button. For information about the additional
settings, see “Configuring General Settings” on page 74.
e. On the Select Default Metadata Language page, select the language you
want to use with Content Server from the drop-down list and then click
Continue.
f. Proceed to Chapter 7, “Creating the Content Server Database“ on page 77.
Before you install Content Server, you must create a UNIX/Linux user to run the
Content Server. You must also ensure that the database server and client, web
server, and web browser are installed and properly configured. See “Preparing to
Install Content Server“ on page 27.
For optimum performance, OpenText recommends that you install only one Content
Server instance on a given computer, especially for your corporate Content Server
system. For testing and prototyping with Content Server, you may find it convenient
to install more than one Content Server instance on a given computer.
If you do install multiple Content Server instances on one computer, you must make
sure that the installation directory, URL mappings, server ports, and program folder
name of each instance are unique. In addition, verify that all the data-flow processes,
search servers, and index servers associated with each existing Content Server
installation are running. See System Object Administrator in the Content Server
Administrator Online Help.
Note: OpenText recommends that you run the installation program only after
installing and configuring your database. Although the installer will install
Content Server without a database being present, you should not do so. Press
CTRL + C to exit the installation program if your database is not properly
installed and configured.
1. Log in as the UNIX or Linux user that you want to run the Content Server. See
“Creating a UNIX or Linux User” on page 35.
2. For the version of UNIX/Linux you are running, unzip and unpack the setup
utility into the appropriate directory.
5. At the prompt that asks about the installation directory, do one of the following:
To accept the default installation directory, press ENTER.
To specify a different directory, type the absolute path of the installation
directory, and then press ENTER.
6. If the directory you specified in step 5 does not exist, type Y at the prompt that
asks whether you want to create it.
7. At the prompt that asks if you want to install Content Server, type Y.
8. At the prompt that asks you for the port number on which you want the
Content Server to run, type a number between 1025 and 65535, or accept the
default number, 2099.
Tip: The port number you choose must not be in use by any other process.
To find out what port numbers are currently in use on a given computer,
use the command netstat –a.
9. At the prompt that asks you to specify the RMI port number, type a number or
accept the default value, 1099.
10. At the prompt that asks you for the port number on which you want the Admin
server to run, type a number between 1025 and 65535, or accept the default,
5858.
11. At the prompt that asks you for the default URL prefix for the
<Content_Server_Home>/cgi/ directory, type the prefix or accept the default
prefix, OTCS.
If you have multiple instances of Content Server on the same computer, the RMI
registry port must be unique for each instance.
12. At the prompt that asks you to specify a temporary directory for document
conversion, type the absolute path of the directory, or accept the default, /tmp.
Tip: OpenText recommends that you accept the default value because this
improves the performance of the document conversion processes that
generate full-text indexes in Content Server.
13. At the prompt that asks if you will be using an Oracle database, type Y.
14. At the prompt that asks you to specify the Oracle SID or the Oracle HOME
directory, accept the default value, ORCL, or specify the SID or alternate HOME
directory.
15. If you specified a nonexistent Oracle HOME directory in the previous step, the
installation program asks you to verify that you still want to use the supplied
value.
16. After the core Content Server software installs, the installation program asks
whether you want to start the Content Server. Type Y to start the service.
After you install Content Server, you must map two Content Server folders to your
web server and configure your Content Server system.
Note: The instructions in the chapter presume that you have already installed
an application server listed as Supported or Certified in the Content Server
Release Notes.
An application server can host multiple web applications. Each web application
consists of at least one servlet and resides in its own folder. Every web application
has a configuration file named web.xml located in a folder named WEB-INF. This file
defines one or more servlets and a URL that maps information to a virtual folder. In
Content Server's case, the web.xml file also contains the location of the
opentext.ini file, from which it obtains other configuration information.
To run LLServlet, you must ensure that the application server can connect to
Content Server's root installation folder (the <Content_Server_Home> folder). You
must also configure the application server to run the LLServlet Java classes, which
are located in the <Content_Server_Home>/application/WEB-INF/lib/
llservletclient.jar file.
This section describes two methods of deploying Content Server using LLServlet:
The value of the docBase parameter in the sample XML files is a Windows
path. For a UNIX installation, use forward slashes to separate folder names.
For example, docBase="/home/opentext/support/"
Tip: For a default installation of Content Server, name this file OTCS.xml.
Tip: If the logon page appears, but has no images, verify that the
<context_name>support.xml file is correctly configured.
Note: The following procedure presumes that you have already installed
Content Server on the Content Server host.
• <Content_Server_Home>/temp/
• <Content_Server_Home>/viewcache/
• <Content_Server_Home>/config/
• <Content_Server_Home>/filters/
• <Content_Server_Home>/logs/
• javaserver.stubs.xml
• javaserver.login.config
• view.tpt
6. Modify the following opentext.ini file and save it on the servlet client host in
the <Content_Server_Home>/config/ folder:
• In the [general] section, change the Server and Port parameters so that
they point to the Content Server host. By default, the value of Port is 2099.
To verify the correct value, open the Content Server Administration page,
and then click the Specify Server Port link in the Server Configuration
section.
• In the filters section, replace <Content_Server_Home> with the
<Content_Server_Home> folder on the servlet client host.
• Copy the htmlImagePrefix= line from the [general] section of the
opentext.ini file on the Content Server host and use it to replace the line
that reads: htmlImagePrefix=<corresponding value from Content Server
host>.
• To use streaming for file uploads, change the value of the useStreaming
parameter to TRUE (the value is FALSE by default).
• To configure a Document Conversion Service (DCS) for use with LLServlet,
specify the hostname and port parameters of an Admin server in the
[ExternalDCS] section of the opentext.ini file on the client servlet host.
Tip: The Admin server may reside on the Content Server host or on a
different computer.
To find the DCS port, open the Content Server System page on the
Admin server. Click the Functions menu of the Admin server, and then
click Properties > Document Conversion Service.
[general]
Port=<port>
Server=<IP address or domain name of Content Server host>
Logpath=.\logs\
OTHOME=<Content_Server_Home>
UploadDirectory=<Content_Server_Home>\temp\
htmlImagePrefix=<corresponding value from Content Server host>
useStreaming=TRUE
Debug=11
[security]
Authentication=Livelink
[filters]
tptFile=<Content_Server_Home>\temp\config\view.tpt
cachePath=<Content_Server_Home>\viewcache\
lastIdFile=<Content_Server_Home>\viewcache\lastid.dat
filterPath=<Content_Server_Home>\filters\
eraseNo=10
autoRecMimeTypes=application/octet-stream
relativeLinkMimeTypes=text/html,application/pdf
[Locale]
Default=_en_US
_en_US=1
[client]
ReceiveBeforeSend=TRUE
[servlet]
wantStreamLogs=TRUE
[ExternalDCS]
host=<IP address or domain name of Content Server Admin
Server>
port=<DCS port on Content Server Admin Server>
viewcache=<Content_Server_Home>\filters\viewcache\
cachesize=10
[DCSParameters]
HHdefaulttype=ANSI8
HHhtml=generic
HHgraphics=none
HHinterlace=False
HHquality=100
HHgraphicsizemethod=smooth
HHtimeout=280
HHgraphicoutputdpi=70
Pipeline=View
Note: The path to the opentext.ini file is referenced four times in the
web.xml file. All four locations must point to the location of the
opentext.ini file on the servlet client host.
9. Create the Content Server XML context files. For more information, see “To
create the Content Server XML context files:“ on page 48.
• temp
• viewcache
[filters]
tptFile=C:\OPENTEXT\config\view.tpt
cachePath=C:\OPENTEXT\viewcache\
lastIdFile=C:\OPENTEXT\viewcache\lastid.dat
eraseNo=10
autoRecMimeTypes=application/octet-stream
relativeLinkMimeTypes=text/html,application/pdf
[XML]
LogPath=C:\XMLlogs\
[Locale]
Default=_en_US
_en_US=1
[client]
ReceiveBeforeSend=TRUE
[servlet]
wantStreamLogs=FALSE
[ExternalDCS]
host=10.20.30.40
port=5863
viewcache=C:\OPENTEXT\viewcache
cachesize=10
[DCSParameters]
HHdefaulttype=ANSI8
HHhtml=generic
HHgraphics=none
HHinterlace=False
HHquality=100
HHgraphicsizemethod=smooth
HHtimeout=280
HHgraphicoutputdpi=70
Pipeline=View
[JavaModulesConfig]
rmiPort=1099
baseURL=/OTCS/livelink
urlPath=/OTCS
The following sample LLServlet context files for the servlet client host presume that
you have used the default installation settings of Content Server.
You must add the following line to the [Filters] section of the SEA opentext.ini:
filterPath=xxxx, where xxxx is the path to the filters folder for the Content
Server installation.
The Secure Enterprise Architecture Support module reads in a file and saves it to a
temporary folder on the Content Server computer. It then modifies the location
parameter in the request to point to the location in Content Server where the file is to
be stored. Content Server obtains the file from the temporary folder, stores it in the
desired folder, and then deletes the file from the temporary folder when it is finished
processing.
For streaming uploads to function correctly, you must specify the temporary folder
on the servlet computer where streamed files are to be stored during the upload
operation. In the [general] section, of the opentext.ini file of the servlet
computer, add the following line:
UploadDirectory=<full_path_to_directory>
To configure a DCS for use with the servlet, you supply values for the hostname and
port parameters of an Admin server in the [ExternalDCS] section of the
opentext.ini file on the servlet computer.
For instructions on adding the context files, see “To create the Content Server XML
context files:“ on page 48.
Note: Each time you apply a cumulative patch or a filter patch update, you
must redeploy the LLServlet server. When it is redeployed, it overwrites the
configuration files with the default files. Before redeploying the LLServlet
WAR file, be certain to back up these configuration files and then reapply them
after redeploying the WAR file.
/support
/temp
/viewcache
/WEB-INF
4. Expand the Applications menu, and then click Install New Application.
5. Select Local file system or Remote file system and then type the path to the
WAR file in the associated field.
6. In the Context Root field, type the application context path. The context path is
the virtual directory name that you map to the Content Server URL prefix. For
example, if you type /aurora in the Context Path field, access to Content Server
through LLServlet is done through the following URL:
http://<host_name>/aurora/contentserver.exe
where <host_name> is the name of your Content Server installation.
7. Click Next.
8. When the page refreshes, select Generate Default Bindings, and then click
Next.
9. When the page refreshes, leave the default settings and click Next.
10. When the page refreshes, in the Clusters and Servers field, type the servers that
you want to install the WAR file to, and then click Next.
11. When the page refreshes, select the check box for LLServlet, click the
appropriate virtual host from the corresponding drop-down menu, and then
click Next.
13. When the page refreshes, click Save to Master Configuration and then click
Save.
2. Select all of the files inside the directory and compress them as a zip file, using a
WAR extension.
When using IBM WebSphere application server, the Content Server Web
application must be packaged as a WAR file.
Note: If you are deploying Content Server using LLServlet and an application
server, you map the Content Server URL prefixes in the servlet’s context files.
See “Deploying and Configuring LLServlet” on page 47
• For Windows versions of Content Server, the mappings.tbl file that is generated
at the end of the primary Content Server installation contains the URL prefix
mappings for your web server for Content Server's <Content_Server_Home>/
cgi/ and <Content_Server_Home>/support/ folders.
After Content Server is installed on the server, you will need to open the
mappings file. This file is located in the root of the Content Server install
directory. By default, this location is C:\OPENTEXT\ (in Windows).
• For UNIX or Linux versions of Content Server, the URL prefix mappings are
written to the screen at the end of the Content Server installation.
a. Right-click the Default Web Site node, and then click Add Virtual
Directory.
b. In the Add Virtual Directory dialog box, complete the following steps:
i. In the Alias box, type the Directory Name that appears in the
Document Directory Mapping section of the mappings.tbl file. By
default, the alias is img.
ii. In the Physical Path box, type the Directory Path that appears in the
Document Directory Mapping section of the mappings.tbl file.
a. In the Connections pane of IIS Manager, right-click Default Web Site, and
then click Add Application.
b. In the Add Application dialog box, complete the following steps:
i. In the Alias field, type the Directory Name that appears in the CGI BIN
Mapping section of the mappings.tbl file. By default, the alias is OTCS.
ii. Click the Select button and choose Content Server in the Application
Pool drop-down list, and then click OK.
iii. In the Physical Path field, type the Directory Path associated with the
CGI BIN Mapping found in the mappings.tbl file.
i. Type (or browse to) the path to the cs.exe file in the ISAPI or CGI
path field.
ii. In the Description field, type a description for the executable.
iii. Select the Allow extension path to execute check box.
a. In the Connections Pane of the IIS Manager, click the <server_name>, and
then double-click Handler Mappings.
To access the Request Filtering settings that apply to Content Server, open IIS
Manager, click the Content Server website on the left, and then click Request
Filtering in the middle pane. In the right pane, click Open Feature, and then click
Edit Feature Settings. The Edit Request Filter Settings dialog appears:
If you use OpenText WebDAV with Content Server, you should add the
following verbs:
• PROPFIND
• PROPPATCH
• MKCOL
• DELETE
• PUT
• COPY
• MOVE
• LOCK
• UNLOCK
• OPTIONS
• SEARCH
If you do not have optional Content Server modules to install, proceed to one of the
following sections:
• If you want to set up a secondary Content Server host, proceed to “Performing a
Secondary Installation” on page 68.
• If you do not want to set up a secondary Content Server host, proceed to “Setting
Up and Starting the Content Server Services” on page 70.
This section describes the first stage of installing a module. The second stage is
described in “Installing Optional Content Server Modules: Stage 2” on page 85.
1. On the host computer where Content Server is installed, run the module's
module_name.exe file.
4. Select the Content Server installation to which you want to add the module.
(You can select only one.)
5. Click Next.
The installation program copies files to the <Content_Server_Home>\staging\
folder, and then informs you that this part of the installation is complete.
6. Click OK, and repeat steps Step 1 to Step 5 for each module you want to install.
The modules now reside in the <Content_Server_Home>\staging\ folder.
Later in the installation process, you integrate them into your Content Server
system. See “Installing Optional Content Server Modules: Stage 2” on page 85.
When you extract the modules, the extraction has to be done using the same user/
group that you use for running Content Server.
2. At the shell prompt, type the following command, and then press ENTER:
tar -xvf<module_name>.tar
All necessary files are extracted in the <Content_Server_Home>/staging/
directory.
3. Repeat the previous steps for each module that you want to install.
The modules now reside in the <Content_Server_Home>/staging/ directory.
Later in the installation process, you integrate them into your Content Server
system. See “Installing Optional Content Server Modules: Stage 2” on page 85.
Note: This guide is structured so that you install a secondary Content Server
host at the proper time during a first-time installation of your overall Content
Server system. You can use the following procedures to perform a secondary
Content Server installation at any time after the initial setup of your Content
Server system. If you are doing so, you must also:
• Set the startup options of the Admin server on the secondary Content Server
host, as described in “Setting Up and Starting the Content Server Services”
on page 70.
• Register the Admin server on the secondary Content Server host, as
described in “Registering a Secondary Admin Server” on page 87.
1. On the host computer that you want to make a secondary Content Server host,
log in as a user that belongs to the Administrators group.
2. Install Content Server as described previously in this guide, but do not start the
services.
3. Right-click the My Computer icon on your desktop, and then choose Manage.
4. In the left pane of the Computer Management window, expand the Services
and Applications node, and then click Services.
5. Double-click Services.
6. In the right pane, right-click the name of the Content Server, and then choose
Properties.
8. Click OK.
9. Repeat this procedure on each computer that you want to set up as a secondary
Content Server host.
10. Proceed to “Setting Up and Starting the Content Server Services” on page 70.
1. On the host computer that you want to use as a secondary Content Server host,
log on with the user name that the Content Server service uses.
2. Install Content Server as described previously in this guide, but do not start the
services.
3. At the operating system prompt, change to the directory where Content Server
is installed, and then type ./stop_llserver.
5. Repeat this procedure on each computer that you want to set up as a secondary
Content Server host.
6. Proceed to “Setting Up and Starting the Content Server Services” on page 70.
• Set up the two Content Server services on the Content Server host to run as the
Windows user that you created for Content Server.
• Start the Content Server services.
Note: On each Windows computer, use the same user name and password to
run all Content Server services.
4. If you automatically started the Content Server services at the end of the
installation procedure, the Service status field reads Started. Click Stop to stop
the Content Server <service name> service.
5. Click the Log On tab.
6. In the Log on as tab section, click This account, and then click Browse.
7. In the Names list on the Add User window, click the user that you created to
run Content Server, click Add, and then click OK.
The Add User window closes, and the selected user name appears in the This
account field.
8. Type a password for this user in the Password and Confirm password fields,
and then click OK.
9. Open the General tab.
10. Click Start, which is located under Service status.
After the window refreshes, the Service status changes to Started.
On UNIX/Linux systems, there are different ways to set up Content Server services
to start automatically after restarting the computer. One method is to add the path
<Content_Server_Home>/start_llserver to the boot script of the UNIX/Linux
computer running the Content Server services. The start_llserver script
automatically starts the Content Server and Admin servers. Since you need to log in
as the superuser root to make changes to the boot script, you may need to ask your
UNIX/Linux system administrator to set this up for you.
To start all Content Server services on the Content Server host, or to start the
Admin server on a secondary Content Server host:
• If you are starting the Content Server services on the Content Server host,
type the following command, and then press ENTER:
./start_llserver
This command starts both the Content Server and the Admin server.
• If you are starting the Admin server on an additional (secondary) host, type
the following command, and then press ENTER:
./start_lladmin
You can modify the following Admin server logging settings for each additional
Content Server host:
• Location and name of Admin server log file
• Admin server logging level
• Whether or not you want to log the data stream between the Content Server and
the Admin server
The logging level does not apply to the default admserv.log file, which is always at
the default (level 1) logging level. You can only modify the logging level if you
specify a custom log file name and/or location.
4. To write the Admin server logs to a file other than the default, do the following:
Add the following line to the [OTAdmin] section:
logfile=<path>
where <path> is the absolute path of the file that you want to use for Admin
server logging on the secondary Content Server host.
Add the following line:
loglevel=<n>
where <n> is the desired log level (1 = default, 2 = verbose, 3 = debug).
5. To log the data stream flowing into the Admin server from the Content Server,
add the following line to the [OTAdmin] section:
logoutput=<path>
where <path> is the absolute path of the file that you want to use for logging the
data output of the Admin server on the secondary Content Server host.
To log the data stream flowing from the Admin server to the Content Server,
add the following line to the [OTAdmin] section:
loginput=<path>
where <path> is the absolute path of the file that you want to use for logging the
data input to the Admin server on the secondary Content Server host.
6. Save and close the opentext.ini file.
7. Restart the Admin server.
Note: This procedure documents only the settings that you need to specify to
initially configure Content Server. For details about all Content Server settings,
see OpenText Content Server Admin Online Help - Content Server Administration
(LLESWBA-H-AGD).
<protocol>://<host>:<port>/<URL_prefix>/cs.exe?func=admin.index
where <protocol> is either HTTP or HTTPS, <host> is the name of the web server host,
<port> is the port on which your web server listens, and <URL_prefix> is the URL
prefix (virtual directory alias) mapped to the <Content_Server_Home>/cgi/ folder
in the web server (or application server).
Note: UNIX and Linux deployments (and most deployments that use an
application server) do not use the EXE extension.
For more information, see “Accessing the Content Server Administration Page”
on page 97.
To set the Content Server Administrator password and enter license key
information:
1. Launch your web browser, and type the URL for the Content Server
Administration page.
Because Content Server is not configured yet, the system redirects you to the
Configure Server Parameters page.
2. On the Configure Server Parameters page, enter the password that you want the
Administrator to use to log in to the Content Server.
3. In the License Key section, enter the Company Name, Expiration Date,
Number of Users.
After you successfully configure Content Server, you must set up the Content Server
database. You can create a new database for use with Content Server or connect
your new Content Server installation with an existing Content Server database. This
section describes how to create a new database. If you have an existing Content
Server database that you want to use with the new Content Server version you
installed, see the OpenText Content Server Upgrade Guide.
2. On the Select RDBMS Type page, click Oracle Server, and then click Continue.
• In the System User Name field, type the Oracle administrator user name.
This is usually system.
Note: The service name is typically the same as the host name of the
computer on which Oracle Server is installed. If you installed Oracle
Server using the guidelines in this guide, you recorded this information on
the “Database Installation Worksheets” on page 27. You can find the
service name (database alias) in the tnsnames.ora file. You may need to
consult your Oracle administrator to obtain this information.
4. Click Log-in.
5. On the Create Content Server Tables page, click Oracle Server Maintenance
link.
• In the Create New Tablespace section, in the Tablespace Name field, type a
unique name for the tablespace.
You can find out what tablespace names are already in use by looking at the
Oracle Server Maintenance page. Look in the Create New User section, in
the Default Tablespace drop-down list.
• In the File Specification field, type the absolute path of the tablespace data
file that you want to create. For example, c:\oracle\database
\filename.ora or /user/oracle/database/filename.dbf.
The directory that you specify must already exist. The Windows or UNIX/
Linux user that runs the Oracle Server must have permission to write to it.
• In the Size field, type a size in MB for the tablespace data file, following the
guidelines on the Oracle Server Maintenance page. The minimum is 5 MB.
Tip: You can estimate an appropriate size using the following formula:
documents X versions X KB-per-avg-doc-size = tablespace-size
• In the User Name field, type a unique name for the Oracle user who will
own the tables.
• Type a password for this user.
• In the Default Tablespace drop-down list, click the name of the tablespace
in which you want to create the tables of the new Content Server database.
Note: Record the user name, password, and the default table space name
on the “Database Installation Worksheets” on page 27.
11. Click Create User.
12. Click Return to previous page.
The Create Content Server Tables page reappears. The User Name and
Password fields are automatically populated with the data you provided on the
Oracle Server Maintenance page.
13. Do one of the following to specify whether you want to use internal or external
document storage:
Tip: Before you specify internal or external document storage, consider the
implications of each option. See “Internal and External Document Storage”
on page 21.
• To store documents and other Content Server items inside the database,
clear the External Document Storage check box.
• To store documents and other Content Server items outside the database on
the file system, select the External Document Storage check box, and then
type the absolute path of the directory where you want the Content Server
database to store items in the adjacent field.
Note: The directory that you type in the External Document Storage
field must already exist and the Windows or UNIX/Linux users under
which the Oracle Server and Content Server run must have permission
to write to it.
14. Click Create Tables.
15. Type the password for the Admin user, and then scroll to the bottom of the
page.
16. Click Continue.
17. Do one of the following:
2. On the Select RDBMS Type page, click Microsoft SQL Server, and then click
Continue.
Note: The server alias is typically the same as the name of the computer
where the Microsoft SQL Server resides. You may need to consult your
Microsoft SQL Server administrator to obtain this information.
• In the System User field, type the Microsoft SQL Server administrator user
name (usually sa ), and then type the corresponding password in the
System Password field.
• In the Master Database Name field, type the name of the system database
(usually master).
4. Click Log-in.
5. On the Create Content Server Tables page, click the Microsoft SQL Server
Maintenance link.
6. On the Microsoft SQL Server Maintenance page, click the Create a New
Microsoft SQL Server Database link.
7. In the Create a New Microsoft SQL Server Database section, do the following:
• In the Database Name field, type the name that you want to assign to the
database. For example, Content Server.
Note: Do not start the name with a number. While SQL Server allows
this, Content Server does not.
• In the Data File Specification field, type a path and file name. For example,
C:\Store\ContentServer.mdf.
• In the Data File Size field, type a size in MB for the Data File. The minimum
is 5 MB.
Tip: You can estimate an appropriate data file size using the following
formula:
# documents X # versions X # KB avg-doc-size = tablespace
size
• In the Log File Specification field, type a path and file name. For example,
C:\Store\ContentServer.ldf.
• In the Log File Size field, type a size in MB for the file (minimum is 5 MB).
Use the Data File Size example as a guide.
9. On the Microsoft SQL Server Maintenance page, click the Create a New User
link.
10. In the Create a New User section, provide the following information:
• The name that you want to use for the new Microsoft SQL Server user.
• A password for the new Microsoft SQL Server user.
In the Database Name drop-down list, select the name of the Microsoft SQL
Server database (for example, Content Server) in which you want the
Microsoft SQL Server user to store its tables.
Tip: Record the SQL user name and password and the SQL database name
on Table 3-2: “Microsoft SQL Server Worksheet (Windows only)”
on page 28.
• To store documents and other Content Server items inside the database,
clear the External Document Storage check box.
• To store documents and other Content Server items outside the database on
the file system, select the External Document Storage check box, and then
type the absolute path of the directory where you want the Content Server
database to store items in the following field.
15. Type the password for the Admin user, and then scroll to the bottom of the
page.
16. If you want to install optional modules, see “Installing Optional Content Server
Modules: Stage 2” on page 85 before continuing.
17. If you do not want to install any of the modules displayed under Installable
Modules (or none are displayed), do one of the following:
This chapter explains how to complete the installation and setup of Content Server.
It assumes that you have successfully completed the tasks described in “Creating the
Content Server Database“ on page 77.
To complete your installation of Content Server, perform the tasks described in the
following sections in the order shown:
• “Installing Optional Content Server Modules: Stage 2” on page 85
• “Registering a Secondary Admin Server” on page 87
• “Creating the Enterprise Index” on page 89
• “Creating the Help Indexes” on page 92
• “Additional Tasks to Perform Before Users Connect” on page 94
After you set up the Content Server database, Content Server displays the Install
Modules page, where you perform the second stage of installing optional Content
Server modules.
To continue the installation and setup of Content Server from the Install
Modules page:
• If you do not want to install any of the modules displayed in the Installable
Modules section (or none are displayed), click Continue.
The Create New Enterprise Data Source page appears. Proceed to Step 5.
• If you want to install any of the modules displayed in the Installable
Modules section, select each module that you want to install.
Note: When you select a module that requires the installation of other
modules, Content Server automatically selects the check boxes of its
dependent modules.
2. Click Install.
The procedure in this section assumes that you are registering a secondary Content
Server host during the installation of Content Server, continuing from the end of the
procedure described in “Installing Optional Content Server Modules: Stage 2”
on page 85. It also assumes that the Create New Enterprise Data Source page is
displayed in your web browser.
To register the Admin server of a secondary Content Server host after the
installation and initial setup of Content Server, see the OpenText Content Server
Admin Online Help - Content Server Administration (LLESWBA-H-AGD).
Before you perform the following procedure, make sure that the Admin server is
running on the secondary host, as described in “Setting Up and Starting the Content
Server Services” on page 70.
Do not register a particular Admin server with more than one Content Server host.
Note: If you want to create all indexes and related data-flow processes on the
Content Server host, see “Creating the Enterprise Index” on page 89.
1. Leave the current web browser window open, and open a new web browser
window.
2. In the new web browser window, open the Content Server Administration
page.
3. In the Search Administration section, click Open the System Object Volume.
On the System Objects Volume page, the Content Server Admin server host
(named Default) appears in the Admin Servers table.
5. On the Content Server Add: Admin Server page, in the Alias Name field, type a
name for the secondary Admin server .
6. In the Host Name field, type the name of the computer where the secondary
Admin server is installed.
7. In the Port Number field, type the port number on which the secondary Admin
server listens.
Content Server records this port number in the <Content_Server_Home>/
config/opentext.ini file on the secondary host. It is in the port parameter in
the [OTAdmin] section.
8. If prompted, type the Admin server password.
9. To have this Admin server manage the storage folder, select the Enable check
box located in the File Cache section.
10. To enable the file cache, enter the address of the file cache In the Directory field.
11. To enable the Document Conversion Service for this server to manage, select the
Enable check box.
12. Click Add.
13. Proceed to “Creating the Enterprise Index” on page 89.
The information in this section assumes that you are continuing from the end of the
procedure described in “Creating the Content Server Database“ on page 77, if you
intend to create the Enterprise index on the Content Server host. It also applies if
you are continuing from the end of the procedure described in “Registering a
Secondary Admin Server” on page 87, where you intend to create the Enterprise
index on a secondary Content Server host. At the end of either of these procedures,
the Create New Enterprise Data Source page is displayed in your web browser.
Note: The Create New Enterprise Data Source page does not appear if you
connected this new Content Server installation to an existing Content Server
database. If this is the case, proceed to “Changing the Admin User Password
and Profile” on page 96.
If other primary Content Server installations already exist on this host, make sure
that the servers and data-flow processes of those existing installations are running
before you create the data-flow processes of the new Enterprise index. This allows
Content Server to automatically detect the port numbers that are already in use. See
the System Object Administration section of the Content Server Administrator help.
Note: Default values for all fields are provided on the Create New Enterprise
Data Source page. It is not necessary to change them for a default Admin
server deployment.
1. On the Create New Enterprise Data Source page, type a unique identifier for all
the system objects that are associated with this indexing data flow in the
Processes Prefix field.
Tip: If you are not continuing a new Content Server installation, you can
access the Create New Enterprise Data Source page from the System
Object Volume administration pages.
Refresh your webpage to display new hosts in the Host drop-down list.
2. Optional To specify the number of partitions into which this index should be
divided, type a number in the Partitions field.
3. In the Port field, type a value representing the first of a series of 12 port
numbers on which you want the processes that are associated with this data
source to listen. For example, if you enter 2500, the ports 2500 through 2511 are
used.
Note: The port number that you specify and the next 11 (at least)
consecutive port numbers must not be used by another data source in your
system. The number of consecutive port numbers that will be used
depends on the number of partitions that you specify in the Partitions
field. Creating an Enterprise index requires eight port numbers, and for
each partition, four additional port numbers. Valid values range from 1025
to 65535.
4. In the Producer Information area, in the Host menu, select the Content Server
Admin server on which you want the Enterprise Extractor process to run.
5. In the Producer Information section, in the Write Base Directory box, type the
absolute path of the directory (relative to the Content Server Admin server on
which the Extractor runs) where you want the Enterprise Extractor process to
write data. By default, the write directory is the <Content_Server_Home>/
index/enterprise/ directory on the default primary Content Server host. You
must choose a directory on a drive on a primary Content Server host, and the
directory must differ from the write directories of other Enterprise data sources.
7. In the Read Base Directory box, type the absolute path of the directory where
you want the Document Conversion process to read data.
Specify the directory path as it is mapped or mounted on the host of the Admin
server on which the Document Conversion process runs. This directory must be
the same directory as the write base directory that you specified in the Producer
Information section.
9. To start the data flow processes as soon as they are created, enable Start
Processes in Data Flow.
11. On the Data Flow Creation Status page, click the Continue button.
If you add, uninstall, or upgrade a module after you create the user help index, you
must restart the data flow Directory Walker process so that Content Server indexes
the help files that are associated with the new module.
Content Server creates the user help index on the Content Server host, which is
represented by the alias (usually Default) of its Admin server.
The procedure in this section assumes that you are continuing from the end of the
procedure described in “Creating the Enterprise Index” on page 89, and that the
Congratulations page is displayed in your web browser.
3. On the Content Server System page, in the Add Item menu, select User Help
Data Source.
4. On the Create New User Help Data Source page, in the Base Directory field,
type the absolute path of the folder in which you want to create the Help index.
The default is the<Content_Server_Home>/index/help/ folder.
5. To change the default process prefix from Help, type a new unique identifier in
the Process Prefix field.
Note: In addition to being used as a label for all objects associated with
this index in the System Objects Volume, the text you type in the Processes
Prefix field is also the name used for this index's search slice in the Search
list on the Quick Search and Advanced Search pages.
7. Click Continue.
The System Objects Volume page reappears, displaying the contents of the
Content Server System folder.
If you add, uninstall, or upgrade a module after you create the Admin help index,
you must restart the data flow Directory Walker process so that Content Server
indexes the help files that are associated with the new module.
2. On the Content Server System page, in the Add Item menu, select Admin Help
Data Source.
3. On the Create New Admin Help Data Source page, in the Base Directory field,
type the absolute path of the directory in which you want to create the Admin
help index. The default is the <Content_Server_Home>/index/adminhelp/
folder.
4. In the Process Prefix field, type a unique identifier for all the system objects that
are associated with this data source.
6. Click Continue.
Note: Content Server allows you to alter the look and feel of certain user
interface elements by modifying system cascade style sheets. See “Appendix A
– Understanding Cascading Stylesheets“ on page 115.
Task Description
Creating Users and You must create a Content Server user for each member of your
Groups organization who will use Content Server, and then organize these users
into groups.
Task Description
Setting Permissions OpenText recommends that you create a Folder hierarchy in the Enterprise
Workspace for the various departments in your organization. When you
do this, you need to set the base permissions on these Folders. For
example, if you create a Folder called “Contracts”, you may want to
configure it so that only members of the Legal department have
permission to view its contents.
Setting the Date Content Server allows you to modify the default date and time formats
Format used for entering dates and displaying short- and long-format dates. The
default date format is as follows:
• Month/day/year
• Month displayed as two digits (for example, June is 06)
• Year displayed as four digits (for example, 1998)
• Time displayed according to the 12-hour clock (for example, 1:45 PM)
Creating Attributes Each type of item in the Content Server database has a default set of
and Categories attributes, and all items are part of the system category. You may want to
create custom attributes and categories for the items that users add to the
Content Server database, as this can assist in managing and searching the
contents of the database.
Setting Item By default, all users have the ability to create all types of Content Server
Creation Privileges items (with the exception of Content Server LiveReports). If you want to
restrict the creation of certain types of items to certain users or groups, you
should do this before users connect.
Configuring If you installed optional modules, consult the documentation that
Optional Modules accompanies those modules to see if you need to configure them before
they can be used.
Configuring Access You can set access right restrictions in the system that prevents certain
Control events from updating an item's modified date stamp.
User Display Name You can set the format in which Content Server displays user names in the
Format system for others to see. The format that displays is the user's log-in ID, a
combination of the first name and last name, or a combination of the first
and last names and middle initial.
Set Audit Interests Allows you to specify the item types that you want audited in the Content
Server database.
Administer You can specify events that trigger an update to an item's modified date
Modified Date stamp in Content Server.
Triggers
Password Settings You can specify password settings for users who are new to the system
and or existing users who must change their password based on an
expiration date you set.
Notifications You enable or disable Notifications for the entire system and as well as
specify settings for email, reports, and SMTP.
Scheduled Activities You can set the Content Server to monitor various activities in the system
and give you reports on them. You can also specify whether you want to
keep the data or purge it once a report is generated.
Task Description
Specify Document Content Server lets you set preferred text editors for MIME types or for
Compose Settings enabling or disabling creation types for new documents.
Configure Search You can set multiple Search options for users, including Find Similar
Options command, Hit Highlight Summary, Block Size, Common Authors, and
others.
Configure Storage By adding Storage Providers to Content Server, you can let users decide
Provider Settings where they want to store documents, based on a location you set up along
with rules and associations.
The OpenText Archive and Storage Services can be used to connect to the
OpenText Archive Server. See the OpenText Content Server – Archive Storage
Provider Installation, Upgrade and Configuration Guide in the Knowledge
Center (https://knowledge.opentext.com).
Enable a DCS See “Enabling a Document Conversion Service (DCS)” on page 98.
Configure Workflow See “Administering the Workflow Module” on page 99.
Parameters
To change the password and set the profile for the Admin user:
2. On the My Profile page, on the General tab, select the Change Password check
box.
6. Click Update.
Tip: Record the new password on Section 3.1.3: “Content Server Installation
Worksheets” on page 29.
There is no link to the Content Server Administration page from the end-user
interface. Users who have system administration privileges need the URL for the
Content Server Administration page and the password to access the administration
pages.
Note that the password for the Admin user is different from the Administration
password. By default, the password for the Admin user is livelink, but you should
reset it immediately.
There are several ways to access the Content Server Administration page:
• At the bottom of most Administration pages is the Admin Home link, which
returns you to the main Content Server Administration page.
• On Windows, click Start, point to Programs, point to the program folder name
that was entered for Content Server (the default is OpenText Content Server),
and then click Content Server Administration.
• Open the following URL:
<protocol>://<server>:<port>/<URL_prefix>/contentserver.exe?func=admin.index
where:
• <protocol> is either HTTP or HTTPS.
• <server> is the name of the web host.
• <port> is the port on which your web server listens.
• <URL_prefix> is the URL prefix mapped to the <Content_Server_Home>/
cgi/ folder of the new version of Content Server.
• The .exe extension is not used for UNIX/Linux or when Content Server
works with an application server.
When you enable a DCS, Content Server configures most DCS settings for you. You
can change the settings at any time to customize how the DCS operates. An example
of settings that Content Server configures automatically are port numbers. Content
Server selects available ports for the DCS and configures the DCS port number and
the Admin port number. The Admin port number is the number of the port on
which the DCS listens for information from the Admin server; the DCS port number
is the number of the port that Content Server operations use to communicate with
the DCS. Other settings that Content Server may configure automatically include the
log file, which is the location of the file that records logging information for the DCS
you are configuring; the start folder and the filter path, which are the locations
where document-conversion filters are stored; and the rules file location, which is
where the document conversion rules file is stored. The document conversion rules
file is a file that DCS uses to determine which conversion filters to use.
Note: You must specify the temporary file folder. This is a temporary storage
location that is required by conversion filters.
Content Server appends the Admin port number to log file names when it creates
DCS log files. For example, the log file that corresponds to a DCS that listens on
Admin port number 5868 has the file name dcs_5868.log. The start folder location
and the filter path should match; on Windows operating systems, they must match.
To administer access to the Workflow Agent and Item Handler step, open the
Content Server Administration page, navigate to the System Administration
section, and then click Administer Object and Usage Privileges. See OpenText
Content Server Admin Online Help - Workflow Administration (LLESWFW-H-AGD).
Users must take great care when using the Item Handler step because they can
automatically create, modify, and remove multiple Content Server items. For
example, the Item Handler step's Move/Copy tab allows users to move and rename
Content Server items, and the Versioning tab can be configured to create Versions,
Releases, and Generations of Content Server documents or compound documents. If
users are not familiar with the Item Handler step capabilities or do not take care in
configuring the step, Content Server items may be permanently deleted or altered.
The Content Server Administrator must grant permission to users who want to use
the Item Handler step before they can add an Item Handler step to a workflow. Also,
the Content Server Administrator has the ability to control which Item Handler step
features are available to users.
If you encounter an error or another problem using the Item Handler step and
would like more information about step processing, you can enable Content Server
Workflow to write Item Handler information to the Content Server thread log file,
<Content_Server_Home>/logs/thread<x>.out.
When the Workflow Agent processes an Item Handler step, it impersonates the user
assigned to the step. The audit trail for all items affected by the step will show the
user\qs name even though the user does not initiate the Content Server operations.
Also, you must be sure that the step assignee has the required privileges to complete
all requests defined in the step, or else errors will occur. For example, if you create
an Item Handler step that moves a document from one folder to another folder that
the user does not have privileges to update, the move document request fails.
If the Workflow Agent encounters an error during processing, it sends the step to
the Assignments page of the user assigned to the step. Also, it makes an attempt to
send an email message that alerts Workflow managers and the step performer to the
error, and requests action to correct the problem. In order to send error messages,
the Workflow Agent requires the following:
• The Content Server Administrator must specify the email server SMTP settings
and the sender email address.
• Workflow managers and step assignees must specify their email address in their
Content Server profiles.
An attribute can contain one of the following types of information: text, dates,
integers, real numbers, Boolean values (represented by a check box), and Content
Server item references. The item reference attribute is a special attribute that allows
workflow participants to browse Content Server and select an item. When an item is
selected, the attribute stores the item's unique Content Server object ID. For example,
you can create an item reference named “Item to Review” and specify that
documents and compound documents are the only valid types users can specify.
When a workflow is initiated, a workflow participant can identify information they
want another participant to review by selecting a document or compound
document.
The Content Server Administrator can limit the type of Content Server items users
can select in an item reference by excluding Content Server items by node type ID
from the item reference attribute. “Common Node Type IDs” on page 102 displays a
list of common Content Server node type IDs.
Note: By default, the Content Server Workflow module always excludes all
system volumes and non-displayable containers.
Instructions for installing optional modules during the installation of Content Server
are provided in “Configuring Content Server“ on page 47. This chapter tailors that
information for situations where you want to install and uninstall modules after the
initial installation of Content Server.
Content Server’s functionality is organized into software modules. There are two
types of modules: core modules and optional modules.
• Core modules, such as Channels, Discussions, Tasks, and Projects, are
automatically installed when Content Server is installed.
• Optional modules, such as Content Server Directory Services, and Content Server
EPS Integration, must be installed by the Content Server administrator. Optional
modules allow you to extend the functionality of Content Server to meet your
organization's specific needs.
Most Content Server modules include help files. Therefore, after you install or
uninstall a module, you should update the Help index so that it includes the
information in the new module's help files.
When you purchase an optional Content Server module, you may receive it on a CD-
ROM or you may download it from an OpenText website. In either case, specific
instructions for installing the module accompany it.
Note: If there is more than one Content Server installation present on the
host computer, the Select Content Server Service window lists the
Windows service names of all primary and secondary Content Server
installations currently installed on this host. In this case, select the check
box of the primary Content Server installation to which you want to add
the module (you can select only one), and then click Next.
4. Click OK, and repeat the previous steps for each module that you want to
install.
2. At the operating system prompt, type the following command, substituting the
correct file name for <module_name>, and then press ENTER:
tar -xvf <module_name>.tar
All necessary files are extracted from the <module_name>.tar file into the
<Content_Server_Home>/staging/ directory.
3. Repeat the previous steps for each module that you want to install. for each
module that you want to install.
3. Select the check box of each module that you want to install, and then click
Install.
Note: For most optional module installations, the Restart Content Server
page is the first page that appears after you click Install. However, some
modules may have different configuration parameters that need to be
configured separately after the installation. Also, some module
installations display a configuration page before the Restart Content
Server page. Consult the documentation that accompanies such modules
for instructions on how to complete the configuration page.
5. Restart the Content Server, and then click Continue on the Restart Content
Server page.
Note: After you install a module that has help files associated with it, update
the Help index so that it includes the module's help files. See “Updating the
Help Index to Reflect Changes in Installed Modules” on page 111.
See the section called “Document Conversion Service (DCS)” on page 16.
Information about installing and configuring a filter pack in Content Server is also
available in the Knowledge Center (https://knowledge.opentext.com).
Note: Even though Content Server allows you to uninstall some core modules,
OpenText strongly recommends that you do not uninstall them unless
instructed to do so by OpenText Customer Support.
To uninstall a module:
2. If prompted, type the Content Server Administrator password, and then click
Log-in.
4. On the Uninstall Modules page, click the Uninstall button of the module that
you want to remove.
5. If prompted, type the password for the Admin user, and then click Log-in.
Content Server uninstalls the selected module, and then displays the Restart
Content Server page when the module removal is complete.
When you uninstall a module, Content Server moves the module's files back
into the <Content_Server_Home>/staging/ directory, so that it is available to
be reinstalled on the Install Modules page.
6. Restart the Content Server, and then click Continue on the Restart Content
Server page.
7. Repeat this procedure for each module that you want to uninstall.
Note: After you uninstall a module that has help files associated with it,
update the Help index so that the module's help files are removed from the
index. See “Updating the Help Index to Reflect Changes in Installed Modules”
on page 111.
Most Content Server modules have their own help files. When you add, remove, or
upgrade a module, you also add, remove, or change the corresponding help files.
Therefore, you must update the Help index to reflect these changes, otherwise,
inaccurate search results may be displayed. For example, if you uninstall a module
without updating the Help index, a search for terms that occur in the removed
module's help files results in those files being listed on the Search Result page, even
though they can no longer be viewed.
2. On the Content Server System page, click Help Data Source Folder.
4. On the Help Data Flow page, click the Functions icon of the Help Data Flow
object, and then click Start.
5. To update the index of help topics for Content Server Administrators, repeat
steps Step 2 to Step 4 for the Admin Help Data Source Folder.
This chapter describes how to remove Content Server from a host computer. If you
are upgrading to a newer version of Content Server, it may not be necessary to
uninstall the older version. For more information, see OpenText Content Server -
Upgrade Guide (LLESCOR-IUP).
After the uninstallation process completes, the InstallShield program advises you of
files or folders that it could not remove.
4. Use the utility's Automatic method to remove the Content Server program.
After the uninstallation process completes, the InstallShield program advises
you of files or folders that it could not remove.
1. Log in to the UNIX/Linux host as the user that the Content Server or servers run
as.
3. If the directory tree of the Content Server installation that you are removing
does not contain vital data, you can delete it.
Content Server allows you to alter the look and feel of certain user interface elements
by modifying system cascading style sheets. For example, you can customize fonts,
point sizes, colors and spacing by modifying style sheets based on the type of
browser your organization uses.
Note: This guide assumes you have knowledge of cascading style sheets.
In the screen.css file, define the style and values for font face and size:
/*
The style to use for the label part of the label/value pair.
Use with:
<td>
*/
.label {
width: 1%;
background-color: #e2e2e2;
font-family: Tahoma, Verdana, Geneva, Arial,
Helvetica, sans-serif;
text-align: left;
font-weight: normal;
font-size: 11px;
}/*
/*
Defines the style of static text next to the label. The second
part of the label/value pair.
Use with:
All input types other than "TEXT"
In some cases it may be used as the class for the enclosing
table division (<TD>), this is
useful when you have multiple elements with static text and
a single label, e.g. several radio
buttons.
*/
.valueStatic {
font-family: Tahoma, Verdana, Geneva, Arial,
Helvetica, sans-serif;
font-size: 11px;
font-weight: normal;
}
The label text color is magenta, which is the result of the cascade styles set on the
<BODY> tag. If you set a color on the label class, it would override the style from the
<BODY> tag.
.label {
width: 15%;
white-space: nowrap;
color: #CD00CD;
background-color: #e2e2e2;
border-left: 1px solid #ffffff;
border-top: 1px solid #ffffff;
border-right: 1px solid #999999;
font-family: Tahoma, Verdana, Geneva, Arial,
Helvetica, sans-serif;
text-align: left;
font-weight: bold;
font-size: 11px;
}
E logging 100
enterprise index 19 item reference attribute
creating 89 administering 101
external document storage
backup and recovery 22 J
setting up 22 Java framework
extranet architecture about 15
about 21
L
F Livelink Secure Extranet Architecture (SEA)
file streaming about 21
security option 55 LLServlet
filter packs deploying and configuring 47
document conversion 16 deployment options 47
installing 108 extranet architecture 21
file streaming 55
G
GlassFish Enterprise Server M
worksheet 28 Microsoft SQL Server
creating the database 81
H MIME types
help about 36
indexing 92 modules
help index about installing 105
creating for Admin Help 93 installing after Content Server setup 105
creating for user Help 92 installing during Content Server setup (stage
updating for new modules 111 1) 66
HTTPS installing on UNIX/Linux 106
recommended 25 installing on Windows 106
uninstalling 109
I monitoring
IBM WebSphere recommendations 23
configuration 56
IIS N
worksheet 28 nodes
indexing common node type IDs 101
enterprise index 89
help for new modules 111 O
online help 92 online help
installing indexing 92
additional tasks to perform before users operating system user
connect 94 about 34
creating a UNIX/Linux user 35 creating for UNIX/Linux 35
creating a Windows user 34 creating for Windows 34
database servers 31 operating systems
first-time installation flow chart 27 supported 12
prerequisites 27 Oracle
worksheets 29 creating the database 77
item handler step UNIX/Linux installation guidelines 32
about 100 Windows installation guidelines 31
X
XML
support in Content Server 14