Content Management for WebCenter Installation Guide

Posted by Gary Niu on Oracle Blogs See other posts from Oracle Blogs or by Gary Niu
Published on Fri, 02 Apr 2010 16:56:33 +0800 Indexed on 2010/04/02 9:13 UTC
Read the original article Hit count: 1688

Overvew

As we known, there are two way to install Content Management for WebCenter. One way is install it by WebCenter installer wizard, another way is to install it use their own installer. This guide is for the later one. For SSO purpose, I also mentioned how to config OID identity store for Content Management for WebCenter.

  • Content Management for WebCenter( 10.1.3.5.1)
  • Oracle Enterprise Linux R5U4

Basic Installation

-bash-3.2$ ./setup.sh

Please select your locale from the list.
          1. Chinese-Simplified
          2. Chinese-Traditional
          3. Deutsch
         *4. English-US
          5. English-UK
          6. Español
          7. Français
          8. Italiano
          9. Japanese
         10. Korean
         11. Nederlands
         12. Português-Brazil
Choice?

Throughout the install, when entering a text value, you can press Enter to
accept the default that appears between square brackets ([]). When
selecting from a list, you can select the choice followed by an asterisk by
pressing Enter.

Select installation type from the list.
        *1. Install new server
         2. Update a server
Choice?

Content Server Installation Directory

Please enter the full pathname to the installation directory.
Content Server Core Folder [/oracle/ucm/server]:/opt/oracle/ucm/server

Create Directory
        *1. yes
         2. no
Choice?

Java virtual machine
        *1. Sun Java 1.5.0_11 JDK
         2. Specify a custom Java virtual machine
Choice?
Installing with Java version 1.5.0_11.

Enter the location of the native file repository. This directory contains
the native files checked in by contributors.
Content Server Native Vault Folder [/opt/oracle/ucm/server/vault/]:

Create Directory
        *1. yes
         2. no
Choice?

Enter the location of the web-viewable file repository. This directory
contains files that can be accessed through the web server.
Content Server Weblayout Folder [/opt/oracle/ucm/server/weblayout/]:

Create Directory
        *1. yes
         2. no
Choice?

This server can be configured to manage its own authentication or to allow
another master to act as an authentication proxy.
Configure this server as a master or proxied server.
        *1. Configure as a master server.
         2. Configure as server proxied by a local master server.
Choice?

During installation, an admin server can be installed and configured to
manage this server. If there is already an admin server on this system, you
can have the installer configure it to administrate this server instead.
Select admin server configuration.
        *1. Install an admin server to manage this server.
         2. Configure an existing admin server to manage this server.
         3. Don't configure an admin server.
Choice?

Enter the location of an executable to start your web browser. This browser
will be used to display the online help.
Web Browser Path [/usr/bin/firefox]:

Content Server System locale
          1. Chinese-Simplified
          2. Chinese-Traditional
          3. Deutsch
         *4. English-US
          5. English-UK
          6. Español
          7. Français
          8. Italiano
          9. Japanese
         10. Korean
         11. Nederlands
         12. Português-Brazil
Choice?

Please select the region for your timezone from the list.
        *1. Use the timezone setting for your operating system
         2. Pacific
         3. America
         4. Atlantic
         5. Europe
         6. Africa
         7. Asia
         8. Indian
         9. Australia
Choice?

Please enter the port number that will be used to connect to the Content
Server. This port must be otherwise unused.
Content Server Port [4444]:

Please enter the port number that will be used to connect to the Admin
Server. This port must be otherwise unused.
Admin Server Port [4440]:

Enter a security filter for the server port. Hosts which are allowed to
communicate directly with the server port may access any resources managed
by the server. Insure that hosts which need access are included in the
filter. See the installation guide for more details.
Incoming connection address filter [127.0.0.1]:*.*.*.*

*** Content Server URL Prefix

The URL prefix specified here is used when generating HTML pages that refer
to the contents of the weblayout directory within the installation. This
prefix must be mapped in the web server Additional Document Directories
section of the Content Management administration menu to the physical
location of the weblayout directory.

For example, "/idc/" would be used in your installation to refer to the URL
http://ucm.company.com/idc which would be mapped in the web server to the
physical location /oracle/ucm/server/weblayout.
Web Server Relative Root [/idc/]:

Enter the name of the local mail server. The server will contact this
system to deliver email.
Company Mail Server [mail]:

Enter the e-mail address for the system administrator.
Administrator E-Mail Address [sysadmin@mail]:

*** Web Server Address

Many generated HTML pages refer to the web server you are using. The
address specified here will be used when generating those pages. The
address should include the host and domain name in most cases. If your
webserver is running on a port other than 80, append a colon and the port
number.

Examples: www.company.com, ucm.company.com:90
Web Server HTTP Address [yekki]:yekki.cn.oracle.com:7777

Enter the name for this instance. This name should be unique across your
entire enterprise. It may not contain characters other than letters,
numbers, and underscores.
Server Instance Name [idc]:

Enter a short label for this instance. This label is used on web pages to
identify this instance. It should be less than 12 characters long.
Server Instance Label [idc]:

Enter a long description for this instance.
Server Description [Content Server idc]:

Web Server
        *1. Apache
         2. Sun ONE
         3. Configure manually
Choice?

Please select a database from the list below to use with the Content
Server.
Content Server Database
        *1. Oracle
         2. Microsoft SQL Server 2005
         3. Microsoft SQL Server 2000
         4. Sybase
         5. DB2
         6. Custom JDBC settings
         7. Skip database configuration
Choice?

Manually configure JDBC settings for this database
         1. yes
        *2. no
Choice?

Oracle Server Hostname [localhost]:

Oracle Listener Port Number [1521]:

*** Database User ID

The user name is used to log into the database used by the content server.
Oracle User [user]:YEKKI_OCSERVER

*** Database Password

The password is used to log into the database used by the content server.
Oracle Password []:oracle

Oracle Instance Name [ORACLE]:orcl

Configure the JVM to find the JDBC driver in a specific jar file
         1. yes
        *2. no
Choice?

The installer can attempt to create the database tables or you can manually
create them. If you choose to manually create the tables, you should create
them now.
Attempt to create database tables
         1. yes
        *2. no
Choice?

Select components to install.
         1. ContentFolios: Collect related items in folios
         2. Folders_g: Organize content into hierarchical folders
         3. LinkManager8: Hypertext link management support
         4. OracleTextSearch: External Oracle 11g database as search indexer support
         5. ThreadedDiscussions: Threaded discussion management
Enter numbers separated by commas to toggle, 0 to unselect all, F to finish: 1,2,3,4,5

        *1. ContentFolios: Collect related items in folios
        *2. Folders_g: Organize content into hierarchical folders
        *3. LinkManager8: Hypertext link management support
        *4. OracleTextSearch: External Oracle 11g database as search indexer support
        *5. ThreadedDiscussions: Threaded discussion management
Enter numbers separated by commas to toggle, 0 to unselect all, F to finish: F

Checking configuration. . .

Configuration OK.

Review install settings. . .
Content Server Core Folder: /opt/oracle/ucm/server
Java virtual machine: Sun Java 1.5.0_11 JDK
Content Server Native Vault Folder: /opt/oracle/ucm/server/vault/
Content Server Weblayout Folder: /opt/oracle/ucm/server/weblayout/
Proxy authentication through another server: no
Install admin server: yes
Web Browser Path: /usr/bin/firefox
Content Server System locale: English-US
Content Server Port: 4444
Admin Server Port: 4440
Incoming connection address filter: *.*.*.*
Web Server Relative Root: /idc/
Company Mail Server: mail
Administrator E-Mail Address: sysadmin@mail
Web Server HTTP Address: yekki.cn.oracle.com:7777
Server Instance Name: idc
Server Instance Label: idc
Server Description: Content Server idc
Web Server: Apache
Content Server Database: Oracle
Manually configure JDBC settings for this database: false
Oracle Server Hostname: localhost
Oracle Listener Port Number: 1521
Oracle User: YEKKI_OCSERVER
Oracle Password: 6GP1gBgzSyKa4JW10U8UqqPznr/lzkNn/Ojf6M8GJ8I=
Oracle Instance Name: orcl
Configure the JVM to find the JDBC driver in a specific jar file: false
Attempt to create database tables: no
Components:
ContentFolios,Folders_g,LinkManager8,OracleTextSearch,ThreadedDiscussions

Proceed with install
        *1. Proceed
         2. Change configuration
         3. Recheck the configuration
         4. Abort installation
Choice?
Finished install type Install with warnings at 4/2/10 12:32 AM.

Run Scripts

-bash-3.2$ ./wc_contentserverconfig.sh /opt/oracle/ucm/server /mnt/hgfs/SOFTWARE/ofm_ucm_generic_10.1.3.5.1_disk1_1of1/ContentServer/webcenter-conf
Installing '/mnt/hgfs/SOFTWARE/ofm_ucm_generic_10.1.3.5.1_disk1_1of1/ContentServer/webcenter-conf/CS10gR35UpdateBundle.zip'
Service 'DELETE_DOC' Extended
Service 'DELETE_BYREV_REVISION' Extended
Installing '/mnt/hgfs/SOFTWARE/ofm_ucm_generic_10.1.3.5.1_disk1_1of1/ContentServer/webcenter-conf/ContentAccess/ContentAccess-linux.zip'
(internal)      04.02 00:40:38.019      main    updateDocMetaDefinitionV11: adding decimal column
Installing '/opt/oracle/ucm/server/custom/CS10gR35UpdateBundle/extras/Folders_g.zip'
Installing '/opt/oracle/ucm/server/custom/CS10gR35UpdateBundle/extras/FusionLibraries.zip'
Installing '/opt/oracle/ucm/server/custom/CS10gR35UpdateBundle/extras/JpsUserProvider.zip'
Installing '/mnt/hgfs/SOFTWARE/ofm_ucm_generic_10.1.3.5.1_disk1_1of1/ContentServer/webcenter-conf/WcConfigure.zip'
Apr 2, 2010 12:41:24 AM oracle.security.jps.internal.core.util.JpsConfigUtil getPasswordCredential
WARNING: A password credential is expected; instead found .
Apr 2, 2010 12:41:24 AM oracle.security.jps.internal.idstore.util.IdentityStoreUtil getUnamePwdFromCredStore
WARNING: The credential with map JPS and key ldap.credential does not exist.
Apr 2, 2010 12:41:27 AM oracle.security.jps.internal.core.util.JpsConfigUtil getPasswordCredential
WARNING: A password credential is expected; instead found .
Apr 2, 2010 12:41:27 AM oracle.security.jps.internal.idstore.util.IdentityStoreUtil getUnamePwdFromCredStore
WARNING: The credential with map JPS and key ldap.credential does not exist.
Apr 2, 2010 12:41:28 AM oracle.security.jps.internal.core.util.JpsConfigUtil getPasswordCredential
WARNING: A password credential is expected; instead found .
Apr 2, 2010 12:41:28 AM oracle.security.jps.internal.idstore.util.IdentityStoreUtil getUnamePwdFromCredStore
WARNING: The credential with map JPS and key ldap.credential does not exist.
Restart Content Server to apply updates.

Configuring Apache Web Server

append the following lines at httpd.conf:

include "/opt/oracle/ucm/server/data/users/apache22/apache.conf"

Configuring the Identity Store( Optional )

1.  Stop Oracle Content Server and the Admin Server

2.  Update the Oracle Content Server's JPS configuration file, jps-config.xml:

a. add a service instance

<serviceInstance provider="idstore.ldap.provider" name="idstore.oid">
    <property name="subscriber.name" value="dc=cn,dc=oracle,dc=com"></property>
    <property name="idstore.type" value="OID"></property>
    <property name="security.principal.key" value="ldap.credential"></property>
    <property name="security.principal.alias" value="JPS"></property>
    <property name="ldap.url" value="ldap://yekki.cn.oracle.com:3060"></property>
    <extendedProperty>
         <name>user.search.bases</name>
         <values>
            <value>cn=users,dc=cn,dc=oracle,dc=com</value>
         </values>
        </extendedProperty>
        <extendedProperty>
         <name>group.search.bases</name>
         <values>
           <value>cn=groups,dc=cn,dc=oracle,dc=com</value>
         </values>
    </extendedProperty>
        <property name="username.attr" value="uid"></property>
        <property name="user.login.attr" value="uid"></property>
        <property name="groupname.attr" value="cn"></property>
</serviceInstance>

b. Ensure that the <jpsContext> entry in the jps-config.xml file refers to the new serviceInstance, that is, idstore.oid and not idstore.ldap:

<jpsContext name="default">
  <serviceInstanceRef ref="idstore.oid"/> 
3. Run the new script to setup the credentials for idstore.oid in the credential store:
cd CONTENT_SERVER_HOME/custom/FusionLibraries/tools

-bash-3.2$ ./run_credtool.sh
Buildfile: ./../tools/credtool.xml
    [input] skipping input as property action has already been set.
    [input] Alias: [JPS]

    [input] Key: [ldap.credential]

    [input] User Name:
cn=orcladmin
    [input] Password:
welcome1
    [input] JPS Config: [/opt/oracle/ucm/server/custom/FusionLibraries/tools/../../../config/jps-config.xml]

manage-creds:
     [echo] @@@ Help: run 'ant manage-creds' command to see the detailed usage

     [java] Using default context in /opt/oracle/ucm/server/custom/FusionLibraries/tools/../../../config/jps-config.xml file for credential store.
     [java] Credential store location : /opt/oracle/ucm/server/config
     [java] Credential with map JPS key ldap.credential stored successfully!
     [java]
     [java]
     [java]     Credential for map JPS and key ldap.credential is:
     [java]             PasswordCredential name : cn=orcladmin
     [java]             PasswordCredential password : welcome1

BUILD SUCCESSFUL
Total time: 1 minute 27 seconds

Testing

1. acces http://yekki.cn.oracle.com:7777/idc

2. login in with OID user, for example: orcladmin/welcome1

3. make sure your JpsUserProvider status is "good"

ucm_ok

© Oracle Blogs or respective owner

Related posts about Internet Directory

Related posts about Universal Content Server