| Oracle Content Management Software Development Kit (Oracle CM SDK) Installation Guide Release 9.0.3 for Windows NT/2000 Part Number B10053-01 |
|
This chapter guides you through the process of installing and configuring Oracle Content Management SDK (Oracle CM SDK). Topics include:
Installation and configuration of Oracle CM SDK starts from the Oracle Universal Installer -- the graphical user interface wizard that copies all necessary software to the target machine.
The Oracle CM SDK Configuration tool launches automatically at the end of the Oracle Universal Installer process and guides you through the process of identifying the Oracle database to be used for the Oracle CM SDK schema; selecting the type of authentication to use (native Oracle CM SDK credential manager, or Oracle Internet Directory-based credential manager); and various other configuration tasks.
Before installing and configuring Oracle CM SDK:
prompt> lsnrctl start prompt> sqlplus /nolog SQL>connect sys/password as sysdba Connected. SQL> startup ORACLE instance started. Total System Global Area 185369592 bytes Fixed Size 279544 bytes Variable Size 117440512 bytes Database Buffers 67108864 bytes Redo Buffers 540672 bytes Database mounted. Database opened. SQL> exit
ORACLE_HOME\bin\emctl stop
These instructions presume that you have completed all necessary pre-installation tasks appropriate for the deployment. See Chapter 2, "Requirements" for details.
oracle or Administrator, and is also a member of the dba group) and mount the Oracle CD or CD image containing the Oracle CM SDK software.
CD-ROM\install\win32\setup.exe
The File Locations screen appears.
products.jar file from the product CD or CD image in the Source field.
The Summary screen appears a list of the selected components. Oracle CM SDK should display among the listed items.
A progress indicator appears to monitor the installation as the files that comprise the software are copied to the appropriate directories on the server.
When the copying process completes, the Oracle Universal Installer launches the Oracle CM SDK Configuration Assistant automatically.
The Configuration Assistant is launched automatically by the Oracle Universal Installer, and guides you through the range of possible deployment scenarios listed in Table 3-1. The Configuration Assistant always begins with the Welcome screen shown in Figure 3-1.
Make your choices on each screen and click the Next button to continue. You can click the Cancel button to stop the wizard, then configure at a later time by executing ifsca.bat from the command line, located in the following directory:
ORACLE_HOME\ifs\cmsdk\bin
Table 3-1 summarizes the types of configurations you can perform:
To monitor the Oracle CM SDK Configuration Assistant as it progresses, you can view the log as it's being written to the following file:
ORACLE_HOME\ifs\cmsdk\log\CmsdkConfig.log
These instructions guide you through the process of configuring the Oracle CM SDK domain controller machine, which is typically the first machine in the domain that you're configuring. You must install and configure Oracle CM SDK into an Oracle home based on Oracle9i Application Server, release 9.0.2.
The instructions begin from the Oracle CM SDK Configuration Assistant Welcome screen.
This option will create a new schema and configure Oracle CM SDK on the machine.
The Database Selection screen appears.
The Database Login Verifications message box appears while the CLASSPATH, database connection to the Oracle9i database, initialization parameters, Oracle JServer installation, and other important requirements are verified.
If an error occurs, you must correct the problem before configuration can continue. For example, if JServer is not installed in the database, you see an error message related to the DBMS_JAVA package. (See Chapter 2, "Requirements" for information about preliminary setup requirements.)
The Oracle CM SDK Configuration Assistant attempts to make a connection as SYS AS SYSDBA using a database string, and therefore needs the database to be configured with a password file. If the following error message appears, it is likely due to a missing password file on the database server:
Invalid password for Oracle user SYS
Please refer to the Oracle 9i Database Administrator's Guide, Chapter 1, "Password File Administration", for more information.
If additional errors occur, more information on why verification failed can be found in the CmsdkConfig.log file.
When the verification process completes, the Schema Name screen appears (CMSDK CA-Step 3 of 14: Schema Name).
Oracle CM SDK Configuration Assistant checks to see if the schema name exists in the database. If it does exist, or if related schema names based on this schema name exist, a message box appears notifying you of this problem.
The Tablespaces screen appears (CMSDK CA - Step 4 of 14) after you close the message box.
The tablespaces must already exist in order to select them for each data type -- the Configuration Assistant does not create them.
See the Oracle Content Management SDK Administration Guide and Chapter 2, "Requirements" in this guide for additional information on custom tablespaces.
Important:
The Character Set and Language screen appears (CMSDK CA - Step 5 of 14: Character Set and Language).
The document character set defaults are used by client applications that do not specify a language or character set for documents being transferred to Oracle CM SDK. The default character set is also used by non-Unicode enabled protocols, such as FTP and WebDAV, to determine the character set that these protocol servers should use.
Oracle Corporation recommends setting the character set to Unicode (UTF8) to enable full multi-language functionality. Specifying non-UTF8 character sets may limit Oracle CM SDK functionality, with respect to accessing and displaying content in multiple languages.
Table 3-3 lists some multi-byte character sets if you only need to support a single-language:
Table 3-2 Multi-byte Language Character Sets
| Multi-byte Language | Character Set |
|---|---|
|
Chinese |
UTF8, ZHS16CGB231280, ZHS16GBK, ZHT32EUC, ZHT16BIG5, ZHT32TRIS, AL24UTFFSS |
|
Japanese |
UTF8, JA16SJIS, JA16EUC |
|
Korean |
UTF8, KO16KSC5601 |
If you need to support single-byte language functionality only, you can use UTF8 or any of the single-byte character sets supported by the database. For more information, see the section on "Multi_Lexer" in the Oracle Text Reference Guide.
The Default Port Numbers screen appears (CMSDK CA-Step 6 of 14: Default Port Numbers).
The default port number settings are stored as an object for use by all middle-tier machines that use the Oracle CM SDK schema. To change the configuration on any single middle-tier computer, you must use the Enterprise Manager Web Site.
The Website Information screen appears.
The hostname and port number can be obtained by accessing the following URL:
http://hostname:portID/portlist
where hostname is the hostname of the middle-tier on which Oracle CM SDK is installed, and port number corresponds to the Oracle HTTP Server Port (typically 7777).
The Admin Information screen appears (CMSDK CA- Step 8 of 14: Admin Information).
username@yourcompany.com.
The Directory Service screen appears (CMSDK CA-Step 9 of 14: Directory Service).
system, guest, and scott user accounts. Enter the passwords twice, in the fields on the screen, and click Next to continue. The Set up Local Machine screen appears -- skip to Step 24.
If you have SSL-enabled Oracle Internet Directory, select Uses SSL and change the port number. The default port number for SSL-enabled mode is 636.
The default Oracle Internet Directory super user name/password is cn=orcladmin/welcome1.
The default Oracle Internet Directory root Oracle context is set to cn=OracleContext. Typically, you can leave this unchanged. If the Oracle Internet Directory administrator has changed the root context, you must enter the correct value. The concept of a "root context" is specific to LDAP directory services.
The Users screen appears (CMSDK CA - Step 11 of 15: Users).
system and guest. Optionally, you can also create an Oracle Content Management SDK user account, scott, for demo purposes.
system user, select Map to user from the drop-down list and enter the account name and password.
If you attempt to create a new account but one already exists in Oracle Internet Directory, an error message displays.
The OidCredentialManager is now configured. The Set up Local Machine screen appears.
The Domain Components screen appears (CMSDK CA - Step 13 of 15: Domain Components).
The Node Configuration screen appears (CMSDK CA -Step 14 of 15: Node Configuration).
This screen lists all the protocol servers and agents that you can choose to run in the domain:
See Chapter 1, Concepts, in the Oracle Content Management SDK Administration Guide for more information about protocol servers and agents.
If you selected the Run an HTTP Node on this computer on the Domain Components screen, the HTTP Node Configuration screen appears. (Otherwise, the Summary screen appears.)
The Summary screen appears (CMSDK CA - Summary). The Oracle CMSDK Configuration Assistant now has all the information it needs to create a new Oracle CM SDK schema and configure the node and other processes. Note the name and location of the log file and any other important information on this screen.
A progress window appears. If an error occurs, check the following log file for more information:
ORACLE_HOME\ifs\cmsdk\log\CmsdkConfig.log
When the process is complete, a message appears notifying you that the configuration was successful. Click OK to close the message. Oracle CM SDK and the Oracle Enterprise Manager Web site are integrated automatically.
If the Oracle CMSDK Configuration Assistant was launched by the Oracle Universal Installer, the OUI End Installation screen appears.
See Chapter 4, "Post-configuration" for instructions about how to make Oracle Content Management SDK operational.
These instructions presume you have completed all necessary tasks detailed in Chapter 2. Before running the Oracle CM SDK Configuration Assistant, be sure to copy over any custom classes from your old Oracle Internet File System installation to the 9.0.3 installation (directory is ORACLE_HOME\ifs\cmsdk\custom_classes). If the Configuration Assistant cannot find the custom classes, upgrading the schema may fail.
The instructions begin from the Oracle CMSDK Configuration Assistant Welcome screen. Screens for the Oracle CM SDK Configuration Assistant are pictured in the previous section, Creating a New Oracle Content Management SDK Domain.
The Domain Operation screen appears.
This option will upgrade an existing Oracle Internet File System instance to the Oracle CM SDK release.
The Database Selection screen appears.
SYS user account.
The Database Login Verifications message box appears while the CLASSPATH, database connection to the Oracle9i database, and other important requirements are verified.
If an error occurs, you must correct the problem before configuration can continue. For example, if JServer is not installed in the database, you see an error message related to the DBMS_JAVA package. (See Chapter 2, "Requirements" for information about preliminary setup requirements.)
The Oracle CM SDK Configuration Assistant attempts to make a connection as SYS AS SYSDBA using a database string, and therefore needs the database to be configured with a password file. If the following error message appears, it is likely due to a missing password file on the database server:
Invalid password for Oracle user SYS
Please refer to the Oracle 9i Database Administrator's Guide, Chapter 1, "Password File Administration", for more information.
When the verification process completes, the Schema Name screen appears (CMSDK CA-Step 3 of 14: Schema Name).
If you are upgrading from Oracle Internet File System release 9.0.1 or higher, the Website Information screen appears. Proceed to step 12.
If you are upgrading from an Oracle Internet File System release prior to 9.0.1, the Tablespaces screen appears.
The tablespaces must already exist in order to select them for each data type -- the Configuration Assistant does not create them.
See the Oracle Content Management SDK Administration Guide and Chapter 2, "Requirements" in this guide for additional information on custom tablespaces.
Important:
The Default Port Numbers screen appears (CMSDK CA-Step 6 of 14: Default Port Numbers).
The default port number settings are stored as an object for use by all middle-tier machines that use the Oracle CM SDK schema. To change the configuration on any single middle-tier computer, you must use the Enterprise Manager Web Site.
The Website Information screen appears.
The Admin Information screen appears (CMSDK CA- Step 8 of 14: Admin Information).
username@yourcompany.com.
The Set up Local Machine screen appears.
The Domain Components screen appears (CMSDK CA - Step 13 of 15: Domain Components).
The Node Configuration screen appears (CMSDK CA -Step 14 of 15: Node Configuration).
This screen lists all the protocol servers and agents that you can choose to run in the domain:
See Chapter 1, Concepts, in the Oracle Content Management SDK Administration Guide for more information about protocol servers and agents.
If you selected the Run an HTTP Node on this computer on the Domain Components screen, the HTTP Node Configuration screen appears. Otherwise, the Summary screen appears.
The Summary screen appears (CMSDK CA - Summary). The Oracle CMSDK Configuration Assistant now has all the information it needs to create a new Oracle CM SDK schema and configure the node and other processes. Note the name and location of the log file and any other important information on this screen.
A progress window appears. If an error occurs, check the following log file for more information:
ORACLE_HOME\ifs\cmsdk\log\CmsdkConfig.log
When the process is complete, a message appears notifying you that the configuration was successful. Click OK to close the message. Oracle CM SDK and the Oracle Enterprise Manager Web site are integrated automatically.
If the Oracle CMSDK Configuration Assistant was launched by the Oracle Universal Installer, the OUI End Installation screen appears.
See Chapter 4, "Post-configuration" for instructions about how to make Oracle Content Management SDK operational. Be sure to also perform the "Additional Post-configuration Tasks for Upgrades from 1.1.x Only".
These instructions guide you through the process of setting up a computer to use an existing domain. You must install and configure Oracle CM SDK software into an Oracle home based on Oracle9i Application Server, release 9.0.2.
The instructions begin from the Oracle CM SDK Configuration Assistant Welcome screen.
The Database Selection screen appears.
SYS user account.
The Database Login Verifications message box appears as the CLASSPATH, database connection to the Oracle9i database, initialization parameters, Oracle JServer installation and other important requirements are verified.
If an error occurs, you must correct the problem before configuration can continue. For example, if JServer is not installed in the database, you will see an error message related to the DBMS_JAVA package. (See Chapter 2, "Requirements" for information about preliminary setup requirements.)
The Configuration Assistant attempts to make a connection as SYS AS SYSDBA using a database string, and therefore needs the database to be configured with a password file. The following error message is likely due to a missing password file on the database server.
Invalid password for Oracle user SYS
Please refer to the Oracle 9i Database Administrator's Guide, Chapter 1, Password File Administration, for more information.
If additional errors occur, more information on why verification failed can be found in the CmsdkConfig.log file.
When the verification process completes, the Domain Components screen appears.
The Node Configuration screen appears.
This screen lists all the protocol servers and agents that you can choose to run in the domain:
See Chapter 1, Concepts, in the Oracle Content Management SDK Administration Guide for more information about protocol servers and agents.
If you selected the Run an HTTP Node on this computer option on the Domain Components screen, the HTTP Node Configuration screen appears. Otherwise, the Summary screen appears.
The Summary screen appears (CMSDK CA - Summary). The Oracle CMSDK Configuration Assistant now has all the information it needs to create a new Oracle CM SDK schema and configure the node and other processes. Note the name and location of the log file and any other important information on this screen.
A progress window appears. If an error occurs, check the following log file for more information:
ORACLE_HOME\ifs\cmsdk\log\CmsdkConfig.log
When the process is complete, a message appears notifying you that the configuration was successful. Click OK to close the message. Oracle CM SDK and the Oracle Enterprise Manager Web site are integrated automatically.
If the Oracle CMSDK Configuration Assistant was launched by the Oracle Universal Installer, the OUI End Installation screen appears.
See Chapter 4, "Post-configuration" for instructions about how to make Oracle Content Management SDK operational.
As an alternative to using the graphical tools described in Oracle Content Management SDK Server Configurations, you can pass the name of a response file (.rsp) to the setup.exe executable as a parameter. If your response file contains responses for all of the installer prompts, you can use the -silent parameter to avoid seeing any dialogs or windows at all. Do this only if you have verified that the response file meets your specific deployment needs or if you have modified it to do so.
The Oracle Universal Installer response file, which copies the base software, libraries, and various scripts to the machine for further configuration, is located on the CD in the stage\Response\ directory.
After making any necessary changes to the file, you can install the software by using these two commands:
cd %STAGE_LOCATION%\install\win32
setup.exe -responseFile %STAGE_
LOCATION%\stage\Response\oracle.ifs.Complete.rsp -silent
You can configure the Oracle CM SDK domain using this same approach, by passing a response file (containing all the configuration settings) to the Configuration Assistant as a parameter at the command line. The response file is located in the ORACLE_HOME\ifs\cmsdk\settings directory after installing using the OUI, or the script:
ORACLE_HOME\ifs\cmsdk\settings\silentconfig.properties
The file itself contains instruction about how to modify and use it. Modify the response file to meet your specific needs.
cdORACLE_HOME\cmsdk\bin ifsca.bat -fileORACLE_HOME\ifs\cmsdk\settings\silentconfig.properties -silent
Oracle CM SDK will be configured on the machine according to the specifications defined in the response file. If errors occur during the silent install, check the CmsdkConfig.log file for more information.
Continue with the required post-installation tasks for your configuration as detailed in Chapter 4, "Post-configuration".
For detailed information on Oracle Internet Directory and Credential Management (including Credential Manager Configuration and Oracle Internet Directory User Migration), see Oracle Content Management SDK Administration Guide, Chapter 6, "Oracle Internet Directory and Credential Management."
|
|
![]() Copyright © 1999, 2002 Oracle Corporation. All Rights Reserved. |
|