3
Installation and Configuration
This chapter guides you through the process of installing and configuring Oracle Content Management SDK (Oracle CM SDK). Topics include:
Overview
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 computer.
The Oracle CM SDK Configuration Assistant launches automatically at the end of the Oracle Universal Installer process. The Oracle CM SDK Configuration Assistant 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 for credential management), and various other configuration tasks.
For information about post-configuration tasks, see Chapter 4, "Post-Configuration".
Pre-Installation Tasks
Before installing and configuring Oracle CM SDK, you must perform required pre-installation tasks, and can perform optional pre-installation tasks, depending on your deployment.
Required Pre-Installation Tasks
Before installing and configuring Oracle CM SDK:
Recommended and Optional Preconfiguration Tasks for Oracle CM SDK
The Oracle CM SDK Configuration Assistant starts automatically at the end of the Oracle Universal Installer process and guides you through the process of identifying the Oracle database to use for the Oracle CM SDK schema and other configuration tasks.
Before you configure Oracle CM SDK, there are a number of preconfiguration tasks you might want to complete, depending on your planned deployment. To perform any of these tasks, cancel the Oracle CM SDK Configuration Assistant when it starts.
After performing the desired preconfiguration task(s), you can then run the Oracle CM SDK Configuration Assistant again and configure Oracle CM SDK.
This section contains the following topics:
Table 3-2 lists recommended and optional preconfiguration tasks and provides information to help you determine whether or not a task is necessary to your deployment of Oracle CM SDK.
Table 3-2 Optional Preconfiguration Tasks for Oracle CM SDK
Create Custom Tablespaces (Recommended)
During Oracle CM SDK configuration, you must select whether to store all schema objects in the USERS tablespace, or in custom tablespaces. For a production environment, the USERS tablespace is not optimal. Oracle recommends creating custom tablespaces for the various tables and indexes that comprise the system before attempting to configure Oracle CM SDK. See "Creating Custom Tablespaces" for details.
Set Up Oracle CM SDK to Use Real Applications Clusters Database (Optional)
You can choose to run Oracle CM SDK against a Real Applications Clusters (RAC) database at any time, either preconfiguration or post-configuration.
However, if you know that you want to point to a RAC database for your initial Oracle CM SDK deployment, performing the following preconfiguration steps allows you to specify a RAC database during the Oracle CM SDK configuration process. Note that there are additional post-configuration tasks that must also be completed.
Note:
In order to use RAC, you must configure Oracle CM SDK against a specific node in the target RAC configuration, and this node must have load balancing disabled during the Oracle CM SDK configuration process.
|
- Set the following system parameter in the RAC database:
MAX_COMMIT_PROPAGATION_DELAY=1
- Ensure that the
JOB_QUEUE_PROCESSES parameter is set to a value of 10 or higher.
- Make a TNS entry in the
tnsnames.ora file for load balancing and connection failover options in each Oracle Home used by Oracle CM SDK. Please see the RAC Administrator's Guide for more information on making a TNS entry for these options.
- Configure Oracle CM SDK, specifying the name of the RAC database on the Database Selection screen of the Oracle CM SDK Configuration Assistant.
- Perform required post-configuration tasks.
See "Using Oracle CM SDK with a RAC Database" for details.
Installing Software Components
These instructions presume that you have completed all necessary pre-installation tasks appropriate for the deployment. See Chapter 2, "Requirements" for details.
You can also use the Oracle Universal Installer to install Oracle Workflow with Oracle CM SDK. See the Oracle Workflow User's Guide for information about using Oracle Workflow.
- Log on to the computer using the account name that owns the Oracle software (typically, the user account is
oracle) and mount the Oracle CD or CD image containing the Oracle CM SDK software.
- Launch the Oracle Universal Installer from the CD or CD image, located in:
<CD-ROM>/install/<OS>/runInstaller
where <OS> is one of the following:
Table 3-3 Oracle Universal Installer: Operating System Directories
1
The K desktop environment (KDE) does not support Oracle CM SDK installation on SuSE Linux 7.x (KDE2). Use fvwm or wmaker as the X Window manager when installing and configuring on Linux.
|
The Welcome screen appears.
Figure 3-1 Oracle Universal Installer: Welcome Screen
Text description of the illustration instwel.gif
Read the Welcome screen, then click Next. The File Locations screen appears.
Figure 3-2 Oracle Universal Installer: File Locations Screen
Text description of the illustration instfile.gif
On the File Locations screen, specify the following information:
- Path: Accept or select the location of the
products.jar file from the product CD or CD image in the Path field of the Source section.
- Name: Accept the default or enter a new name for the Oracle Home in the Name field of the Destination section.
- Path: Enter the full path of the directory in which to install the Oracle CM SDK software in the Path field of the Destination section.
You must install Oracle CM SDK in the Oracle Application Server, 10g (9.0.4) middle-tier home. Select the file location carefully. After installation, you cannot move the Oracle CM SDK software without deinstalling and reinstalling.
Click Next to continue. The Select a Product to Install screen appears.
Figure 3-3 Oracle Universal Installer: Select a Product to Install Screen
Text description of the illustration instprod.gif
Select Oracle Content Management SDK to install Oracle CM SDK. For information about installing Oracle Workflow, see the Oracle Workflow Installation Notes for Oracle Content Management SDK.
Click Next to continue. The Summary screen displays a list of the selected components and other installation details, such as space requirements. Oracle CM SDK should appear among the listed items.
Figure 3-4 Oracle Universal Installer: Summary Screen
Text description of the illustration instsum.gif
On the Summary screen, click Install to begin installation. 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.
Oracle CM SDK Server Configuration Types
The Oracle CM SDK Configuration Assistant is launched automatically by the Oracle Universal Installer, and guides you through the range of possible deployment scenarios listed in Table 3-4. The Oracle CM SDK Configuration Assistant always begins with the Welcome screen shown in Figure 3-5.
Figure 3-5 Oracle CM SDK Configuration Assistant: Welcome Screen
Text description of the illustration ifsca_01.gif
Make your choices on each screen and click Next to continue. You can click Cancel to stop the Oracle CM SDK Configuration Assistant and configure at a later time by executing ifsca from the command line, located in the following directory:
$ORACLE_HOME/ifs/cmsdk/bin
The Oracle CM SDK Configuration Assistant provides two main configuration options: Simple and Advanced.
- Simple Configuration asks a minimum of required questions and uses the defaults for most values. Simple configuration is recommended for users configuring Oracle CM SDK for testing or evaluation purposes.
- Advanced Configuration asks all advanced-level configuration questions, and enables you to create a new domain, upgrade a domain, or use an existing domain. Advanced configuration is recommended for a production environment.
Table 3-4 summarizes the types configurations you can perform:
Table 3-4 Oracle CM SDK Configuration Assistant Options
To monitor the Oracle CM SDK Configuration Assistant as it progresses, you can view the log as it is being written to the following file:
$ORACLE_HOME/ifs/cmsdk/log/CmsdkConfig.log
Simple Configuration
These instructions guide you through the process of configuring the Oracle CM SDK domain using the simple configuration option. You must install and configure Oracle CM SDK into an Oracle home based on Oracle Application Server, 10g (9.0.4).
The simple configuration process creates a new Oracle CM SDK schema. If you want to upgrade an existing schema, you must use one of the advanced configuration options.
Simple Configuration Default Values
Table 3-5 summarizes the default values used in the simple configuration option.
Table 3-5 Simple Configuration Default Values
Simple Configuration Installation
The instructions begin from the Oracle CM SDK Configuration Assistant Welcome screen.
- Click Next on the Welcome to Oracle CM SDK Configuration Assistant screen to begin the configuration process. The Configuration Type screen appears.
Figure 3-6 Configuration Type Screen
Text description of the illustration simple01.gif
Select Simple Configuration and click Next.
The Database Selection screen appears.
Figure 3-7 Database Selection Screen
Text description of the illustration simple02.gif
Specify the following information:
- Database Host Name: Enter the fully-qualfied name of the host on which the database is running.
- Listener Port Number: Enter the listener port number. The default value is
1521.
- Database Service Name: Enter the name of the database service.
- Password of Database User SYS: Enter the password for the Oracle database SYS user account.
Click Next to continue.
The Database Login Verifications message box appears while the Oracle CM SDK Configuration Assistant verifies the CLASSPATH, database connection to the Oracle9i Database Server, initialization parameters, Oracle JServer installation and other requirements.
If an error occurs, you must correct the problem before configuration can continue. See Chapter 6, "Troubleshooting" and view the CmsdkConfig.log file for more information.
When the verification process completes, the Schema Name screen appears.
Figure 3-8 Schema Name Screen
Text description of the illustration simple03.gif
Enter a name to use for the new Oracle CM SDK schema. The schema name should not already exist in the database. You must also provide a password for the schema. Enter the password in both fields to confirm.
Click Next to continue. The Oracle CM SDK Configuration Assistant checks to see if the schema name exists in the database.
If the name exists, or if related schema names based on the schema name exist, a message box appears notifying you of this conflict.
The URL Information screen appears.
Figure 3-9 URL Information Screen
Text description of the illustration simple04.gif
In the URL Information screen, enter the following information:
- HTTP Host Name: Enter the hostname of the computer through which you want the domain to provide HTTP listener services. Typically, this is the Oracle Application Server, Infrastructure middle-tier Web server computer. Enter the fully-qualified hostname in the following format:
<computer_name>.<domain>
- HTTP Port: Enter the port number of the computer through which you want the domain to provide HTTP listener services. This port number was specified during the installation of Oracle Application Server, Infrastructure.
- Uses SSL: Click the Uses SSL box to select SSL only if you have configured SSL on the HTTP host computer. By default, the Web server computer listens at port 7777.
The Summary screen appears.
Figure 3-10 Summary Screen
Text description of the illustration ifscasum.gif
Note the name and location of the log file.
Click Configure to execute the configuration process. Once you have started the configuration process, 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 completes, a message appears notifying you that the configuration was successful.
Click OK to close the message. If the Oracle Universal Installer launched the Oracle CM SDK Configuration Assistant, the Oracle Universal Installer End Installation screen appears.
On the Oracle Universal Installer End Installation screen, click Exit to exit from the Oracle Universal Installer. Click Yes to confirm that you want to exit the Oracle Universal Installer.
At the end of the configuration process, several scripts execute automatically in order to integrate Oracle CM SDK and the Oracle Enterprise Manager Application Server Control. See Chapter 4, "Post-Configuration" for instructions about how to make Oracle CM SDK operational.
Advanced Configuration: Creating a New Oracle CM SDK Domain
These instructions guide you through the process of configuring the Oracle CM SDK domain controller computer, which is typically the first computer in the domain that you are configuring. This option creates a new Oracle CM SDK schema. To upgrade an existing schema, see "Advanced Configuration: Upgrading an Existing Domain".
You must install and configure Oracle CM SDK into an Oracle home based on Oracle Application Server 10g (9.0.4).
The instructions begin from the Oracle CM SDK Configuration Assistant Welcome screen.
- Click Next on the Welcome to Oracle CM SDK Configuration Assistant screen to begin the configuration process. The Configuration Type screen appears.
Figure 3-11 Configuration Type Screen
Text description of the illustration ifsca_02.gif
Select Advanced Configuration and click Next.
The Domain Operation screen appears.
Figure 3-12 Domain Operation Screen
Text description of the illustration ifsca_03.gif
On the Domain Operation screen, select Create a new Oracle CMSDK domain and click Next to continue.
The Database Selection screen appears.
Figure 3-13 Database Selection Screen
Text description of the illustration ifsca_04.gif
Specify the following information:
- Database Host Name: Enter the name of the host on which the database is running. Oracle Corporation recommends that you use a fully-qualified host name, but this is not required.
- Listener Port Number: Enter the listener port number. The default value is
1521.
- Database Service Name: Enter the name of the database service.
- Password of Database User SYS: Enter the password for the Oracle database SYS user account.
Click Next to continue. The Database Login Verifications message box appears while the Oracle CM SDK Configuration Assistant verifies the CLASSPATH, database connection to the Oracle9i Database Server, initialization parameters, Oracle JServer installation and other requirements.
If an error occurs, you must correct the problem before configuration can continue. See Chapter 6, "Troubleshooting" and view the CmsdkConfig.log file for more information.
When the verification process completes, the Schema Name screen appears.
Figure 3-14 Schema Name Screen
Text description of the illustration ifsca_05.gif
Enter a name to use for the Oracle CM SDK schema. The schema name should not already exist in the database. You must also provide a password for the schema. Enter the password in both fields to confirm.
Click Next to continue. The Oracle CM SDK Configuration Assistant checks to see if the schema name exists in the database. If the name exists, or if related schema names based on the schema name exist, a message box appears notifying you of this conflict.
The Tablespaces screen appears.
In the Tablespaces screen, either select the USERS tablespace or specify individual tablespaces for each data type. The tablespaces must exist in order to select them for each data type. The Oracle CM SDK Configuration Assistant does not create tablespaces. To improve performance, Oracle recommends that you use custom tablespaces when configuring production environments. See Appendix B, "Creating an Oracle Database" in this guide for additional information on custom tablespaces.
Figure 3-15 Tablespaces Screen
Text description of the illustration ifsca_06.gif
- If you have not created custom tablespaces for Oracle CM SDK content, select Use the USERS tablespace for all Oracle Content Management SDK data.
- If you have created tablespaces specifically for Oracle CM SDK content, select Specify a tablespace for each data type and choose the tablespaces that you want to use for each type of content from the drop-down lists.
Click Next to continue. The Character Set and Language screen appears.
Figure 3-16 Character Set and Language Screen
Text description of the illustration ifsca_07.gif
Select the default character set and indexing language to use when storing documents in Oracle CM SDK. 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 the character set used by the majority of users in your Oracle Files domain.
Table 3-7 lists some of the multibyte character sets available for use if you only need to support a single language:
Table 3-6 Multibyte Language Character Sets
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.
Click Next to continue. The Default Port Numbers screen appears.
Figure 3-17 Default Port Numbers Screen
Text description of the illustration ifsca_08.gif
Change the port numbers as needed.
Click Next to continue. The URL Information screen appears.
Figure 3-18 URL Information Screen
Text description of the illustration ifsca_09.gif
In the URL Information screen, enter the following information:
- HTTP Host Name: Enter the hostname of the computer through which you want the domain to provide HTTP listener services. Typically, this is the Oracle Application Server, Infrastructure middle-tier Web server computer. Enter the fully-qualified hostname in the following format:
<computer_name>.<domain>
- HTTP Port: Enter the port number of the computer through which you want the domain to provide HTTP listener services. This port number was specified during the installation of Oracle Application Server, Infrastructure.
- Uses SSL: Click the Uses SSL box to select SSL only if you have configured SSL on the HTTP host computer. By default, the Web server computer listens at port 7777.
Click Next to continue. The Admin Information screen appears.
Figure 3-19 Admin Information Screen
Text description of the illustration ifsca_10.gif
Enter the fully-qualified e-mail address to use to send notifications and other messages to the Oracle CM SDK administrator. For example, username@yourcompany.com.
Note:
You must enter a valid e-mail address.
|
Click Next to continue. The Directory Service screen appears.
Figure 3-20 Directory Service Screen
Text description of the illustration ifsca_11.gif
Select the directory service to use for user authentication, either Oracle CM SDK Directory Service or Oracle Internet Directory Service.
- If you select Oracle CM SDK Directory Service, the Users screen appears.
Figure 3-21 Users Screen
Text description of the illustration ifsca_12.gif
Enter passwords for the system, guest, and scott user accounts. The password for the system account must be at least five characters long, must include at least one numeric character, and must use ASCII characters only. Click Next to continue. The Set up Local Computer screen appears. Continue the instructions at step 25.
- If you select Oracle Internet Directory Service in the Directory Service screen, you must already have an Oracle Internet Directory instance configured and running. Click Next to continue. The OiD Login screen appears.
Figure 3-22 OiD Login Screen
Text description of the illustration ifscaoid.gif
Enter the login information for the Oracle Internet Directory instance that you want to use for credential management.
- In the Server field, enter the fully-qualified hostname of the computer running Oracle Internet Directory.
- In the Port field, enter the port number at which Oracle Internet Directory server listens.
- The default port number is
3060.
- If you have SSL-enabled Oracle Internet Directory, select Uses SSL and change the port number. Typically, the default port number for SSL-enabled Oracle Internet Directory is
3130.
- The default port number for LDAP is
389. The default port number for LDAP with SSL-enabled Oracle Internet Directory is 636.
- The default Oracle Internet Directory super user name is
cn=orcladmin. The password is the password supplied for the ias_admin Infrastructure user.
- The default OID root Oracle context is
cn=OracleContext. Typically, you can leave this unchanged. If the Oracle Internet Directory administrator has changed the root context, enter the correct value. (The concept of a "root context" is specific to LDAP directory services.)
Click Next to continue. The OID Users screen appears.
Figure 3-23 OiD Users Screen
Text description of the illustration oiduser.gif
Use existing user accounts or create new user accounts.
Click Next to continue. The OidCredentialManager is configured using the settings selected in steps 21 and 23. The Set up Local Computer screen appears.
Figure 3-24 Set up Local Computer Screen
Text description of the illustration ifsca_13.gif
On the Set up Local Computer screen:
- Select Yes to configure this domain as a target that can be managed using the Application Server Control. Select this if you want to configure the local computer to run the Domain, Node, or HTTP Node. This creates the Oracle CM SDK schema and configures the computer as an Oracle CM SDK middle-tier.
- Select No to create the new domain without the software necessary to manage it as a target from the Application Server Control. This creates the Oracle CM SDK schema, but does not configure the computer as an Oracle CM SDK middle-tier. Continue the instructions at step 34.
Click Next to continue. The Domain Components screen appears.
Figure 3-25 Domain Components Screen
Text description of the illustration ifsca_14.gif
Select the processes that you want to configure for the domain. By default, all processes are selected on this screen.
- If the computer contains multiple network interface cards (NICs), enter the hostname that you want to use for Oracle CM SDK in the Local Host Name field. You can specify a hostname or an IP address.
See the Oracle Content Management SDK Administrator's Guide for information about changing a hostname after configuration.
- Select Run Domain Controller on this computer to configure the Oracle CM SDK Domain Controller process. Only one computer in the Oracle CM SDK domain should run this process.
- Select Run a Node on this computer to configure a regular node to run on this computer.
- Select Run an HTTP Node on this computer to configure an HTTP node to run the Oracle CM SDK DAV server for HTTP and WebDAV access on this computer. The HTTP node is also required to run the Oracle CM SDK Enterprise Manager.
See the Oracle Content Management SDK Administrator's Guide for more information about domain controllers and nodes.
Click Next to continue. The OC4J Verification message box appears while the Oracle CM SDK Configuration Assistant searches for an existing OC4J instance on the computer. If an OC4J instance exists, a message box appears. Select one of the following:
- Click Yes to replace the existing instance with a new OC4J instance.
- Click No to leave the existing OC4J instance. The Oracle CM SDK Configuration Assistant does not create an OC4J instance for the new HTTP node.
Click Next to continue. The Domain Component Verifications message box appears while the Oracle CM SDK Configuration Assistant verifies the local host name. If the local host name is not valid, you must retype the name in the Domain Components screen.
If you selected Run a Node on this computer in the Domain Components screen in step 26, the Node Configuration screen appears when the verification process completes successfully.
Otherwise, the Summary screen appears.
Figure 3-26 Node Configuration Screen
Text description of the illustration ifsca_15.gif
The Node Configuration screen lists all the protocol servers and agents (discussed in Chapter 1, Concepts, in the Oracle Content Management SDK Administrator's Guide) that you can choose to run in the domain:
- Enter the name by which you want the node to be known in the Node Name field. It can include the name of the computer (hostname). The name must be unique across all of the nodes on this domain.
- Select Run Oracle CM SDK Agents to configure all of the Oracle CM SDK system agents to run on this computer. Only one computer in the Oracle CM SDK domain should run the system agents.
- Select Run Protocol Servers to configure protocol servers to run on this computer. Supported protocol servers include FTP, AFP, CUP, SMTP, NFS, SMB, and IMAP.
Click Next to continue. If you selected Run an HTTP Node on this computer on the Domain Components screen in step 26, the HTTP Node Configuration screen appears.
Otherwise, the Summary screen appears.
Figure 3-27 HTTP Node Configuration Screen
Text description of the illustration ifsca_16.gif
Enter a name for the HTTP Node and click Next to continue.
The Oracle CM SDK Configuration Assistant now has all the information it needs to create a new Oracle CM SDK schema and to configure the node and other processes.
Click Next to continue. The Summary screen appears.
Figure 3-28 Summary Screen
Text description of the illustration ifscasum.gif
Note the name and location of the log file.
Click Configure to execute the configuration process. Once you have started the configuration process, 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 completes, a message appears notifying you that the configuration was successful.
Click OK to close the message. If the Oracle Universal Installer launched the Oracle CM SDK Configuration Assistant, the Oracle Universal Installer End Installation screen appears.
On the Oracle Universal Installer End Installation screen, click Exit to exit from the Oracle Universal Installer. Click Yes to confirm that you want to exit the Oracle Universal Installer.
At the end of the configuration process, several scripts execute automatically in order to integrate Oracle CM SDK and the Application Server Control. See Chapter 4, "Post-Configuration" for instructions about how to make Oracle CM SDK operational.
Advanced Configuration: Upgrading an Existing Domain
These instructions guide you through the process of upgrading an existing Oracle Internet File System or Oracle CM SDK domain. These instructions assume that you have completed all of the required tasks described in Chapter 2, and that you have stopped the existing Oracle Internet File System or Oracle CM SDK domain, as described in "Required Pre-Installation Tasks". In order to install Oracle CM SDK 10g (9.0.4), you must first upgrade to Oracle Internet File System release 9.0.2 or Oracle CM SDK release 9.0.3.
Before running the Oracle CM SDK Configuration Assistant, copy all custom classes from your old Oracle Internet File System or Oracle CM SDK installation to the 10g (9.0.4) installation. The custom classes are located in $ORACLE_HOME/ifs/cmsdk/custom_classes. If the Oracle CM SDK Configuration Assistant cannot find the custom classes, it might not be able to upgrade the schema.
Note:
If you have a custom class named LINK, you must rename the class before upgrading to Oracle CM SDK 10g (9.0.4).
|
The instructions begin from the Oracle CM SDK Configuration Assistant Welcome screen.
Note:
The upgrade process requires a default LOB chunk size of 32K for all database content. If you changed the default chunk size when you initially installed and configured Oracle Internet File System or Oracle CM SDK, you must change the chunk size in the upgrade actions file before upgrading. Contact your Oracle Support representative for details.
|
- Read the Welcome screen, then click Next to begin the configuration process. The Configuration Type screen appears.
- Select Advanced Configuration and click Next. The Domain Operation screen appears.
- On the Domain Operation screen, select Upgrade an existing Oracle Internet File System domain and click Next to continue.
- A message appears warning you to copy your custom classes before upgrading. Click OK to continue.
- The Database Selection screen appears.
- On the Database Selection screen, specify the following information:
- Database Host Name: Enter the name of the host on which the database containing the existing Oracle Internet File System or Oracle CM SDK domain is running.
- Listener Port Number: Enter the listener port number. The default value is
1521.
- Database Service Name: Enter the name of the database service.
- Password of Database User SYS: Enter the password for the Oracle database SYS user account.
- Click Next to continue. The Database Login Verifications message box appears while the Oracle CM SDK Configuration Assistant verifies the CLASSPATH, database connection to the Oracle9i Database Server, and other requirements. If an error occurs, you must correct the problem before configuration can continue.
If an error occurs, you must correct the problem before configuration can continue. See Chapter 6, "Troubleshooting" and view the CmsdkConfig.log file for more information.
When the verification process completes, the Schema Name screen appears.
- Select the Oracle Internet File System or Oracle CM SDK schema that you want to upgrade and enter the password for the schema.
- Click Next to continue. The URL Information screen appears.
- Enter the fully-qualified hostname and port number of the computer through which you want the domain to provide HTTP (Web) services.
- Select Uses SSL only if you have configured SSL on that computer.
- Click Next to continue. The Admin Information screen appears. Enter the fully-qualified e-mail address to use to send notifications and other messages to the Oracle CM SDK administrator. For example,
username@yourcompany.com.
- Click Next to continue. The Set up Local Computer screen appears.
- On the Set up Local Computer screen:
- Select Yes to configure this computer as a target that can be managed using the Application Server Control.
- Select No to upgrade the domain to Oracle CM SDK 10g (9.0.4) without the software necessary to manage it as a target from the Application Server Control. Continue the instructions with step 18.
- Click Next to continue. The Domain Components screen appears. Select the processes that you want to configure for the domain. By default, all processes are selected on this screen.
- If the computer contains multiple network interface cards (NICs), enter the hostname that you want to use for Oracle CM SDK in the Local Host Name field.
- Select Run Domain Controller on this computer to configure the Oracle CM SDK Domain Controller process. Only one computer should run this process.
- Select Run a Node on this computer to configure a regular node to run on this computer.
- Select Run an HTTP Node on this computer to configure an HTTP node to run the Oracle CM SDK DAV server for HTTP and WebDAV access on this computer.
- Click Next to continue. The Domain Component Verifications message box appears while the Oracle CM SDK Configuration Assistant verifies the local host name. If the local host name is not valid, you must retype the name in the Domain Components screen.
- If you selected Run a Node on this computer in the Domain Components screen in step 13, the Node Configuration screen appears when the verification process completes successfully.
Otherwise, the Summary screen appears. Continue the instructions with step 18.
- The Node Configuration screen lists all Oracle CM SDK processes (protocol servers and agents discussed in Chapter 1, Concepts, in the Oracle Content Management SDK Administrator's Guide) that you can choose to run in the domain:
- Enter the name by which you want the node to be known in the Node Name field. This can optionally include the name of the computer (hostname).
- Select Run Oracle CM SDK Agents to configure all of the Oracle CM SDK system agents to run on this computer. Agents can run on only one node in the domain. If agents are configured to run on another node, you must deselect this option.
- Select Run Protocol Servers to configure protocol servers to run on this computer. Supported protocol servers include FTP, AFP, CUP, SMTP, NFS, SMB, and IMAP.
- Click Next to continue. If you selected Run an HTTP Node on this computer on the Domain Components screen in step 13, the HTTP Node Configuration screen appears. Enter the name for the HTTP Node and click Next to continue.
The Oracle CM SDK Configuration Assistant now has all the information it needs to create a new Oracle CM SDK schema and to configure the node and other processes.
- Click Next to continue. The Summary screen appears. Note the name and location of the log file.
- Click Configure to execute the configuration process using all the information entered via the Oracle CM SDK Configuration Assistant. Once you have started the configuration process, 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 completes, a message appears notifying you that the configuration was successful.
- Click OK to close the message. If the Oracle Universal Installer launched the Oracle CM SDK Configuration Assistant, the Oracle Universal Installer End Installation screen appears.
- On the Oracle Universal Installer End Installation screen, click Exit to exit from the Oracle Universal Installer. Click Yes to confirm that you want to exit the Oracle Universal Installer.
At the end of the configuration process, several scripts execute automatically in order to integrate Oracle CM SDK and the Application Server Control. See Chapter 4, "Post-Configuration" for instructions about how to make Oracle CM SDK operational.
Note:
After upgrading, you must manually sync the existing IFS_TEXT index. See Appendix A, Oracle Text Reference, in the Oracle Content Management SDK Administrator's Guide for more information.
|
Advanced Configuration: Use an Existing Oracle CM SDK Domain
These instructions guide you through the process of setting up a computer to use an existing domain. Use this configuration type to add more middle-tier computers to the Oracle CM SDK domain.
You must install and configure Oracle CM SDK software into an Oracle home based on Oracle Application Server 10g (9.0.4).
The instructions begin from the Oracle CM SDK Configuration Assistant Welcome screen.
- Click Next on the Welcome to Oracle CM SDK Configuration Assistant screen to begin the configuration process. The Configuration Type screen appears.
- Select Advanced Configuration and click Next. The Domain Operation screen appears.
- On the Domain Operation screen, select Set up this computer to use an existing Oracle CM SDK domain and click Next to continue. The Database Selection screen appears.
- On the Database Selection screen, specify the following information:
- Database Host Name: Enter the name of the host on which the database is running.
- Listener Port Number: Enter the listener port number. The default value is
1521.
- Database Service Name: Enter the name of the database service.
- Password of Database User SYS: Enter the password for the Oracle database SYS user account.
- Click Next to continue. The Database Login Verifications message box appears as the Oracle CM SDK Configuration Assistant verifies the CLASSPATH, database connection to the Oracle9i Database Server, initialization parameters, Oracle JServer installation and other requirements.
If an error occurs, you must correct the problem before configuration can continue. See Chapter 6, "Troubleshooting" and view the CmsdkConfig.log file for more information.
When the verification process completes, the Schema Name screen appears.
- Select the Oracle CM SDK schema that you want to reuse and enter the password for the schema.
- Click Next to continue. The Domain Components screen appears.
- On the Domain Components screen, select the processes that you want to configure to run on this computer. By default, all processes are selected.
- If the computer contains multiple network interface cards (NICs), enter the hostname that you want to use for Oracle CM SDK in the Local Host Name field.
- Select Run Domain Controller on this computer to configure the Oracle CM SDK Domain Controller process. Only one computer should run this process.
- Select Run a Node on this computer to configure a regular node to run on this computer.
- Select Run an HTTP Node on this computer to configure an HTTP node to run the Oracle CM SDK DAV server for HTTP and WebDAV access on this computer.
- Click Next to continue. The Domain Component Verifications message box appears while the Oracle CM SDK Configuration Assistant verifies the local host name. If the local host name is not valid, you must retype the name in the Domain Components screen.
- If you selected Run a Node on this computer in the Domain Components screen in step 13, the Node Configuration screen appears when the verification process completes successfully.
Otherwise, the Summary screen appears. Continue the instructions with step 13.
- The Node Configuration screen lists all Oracle CM SDK processes (protocol servers and agents discussed in Chapter 1, Concepts, in the Oracle Content Management SDK Administrator's Guide) that you can choose to run in the domain:
- Enter the name by which you want the node to be known in the Node Name field. It can include the name of the computer (hostname), but it need not: the value is any string that makes sense to you.
- Select Run Oracle CM SDK System Agents to configure all of the Oracle CM SDK system agents to run on this computer. Agents can run on only one node in the domain. If agents are configured to run on another node, you must deselect this option.
- Select Run Protocol Servers to configure protocol servers to run on this computer. Supported protocol servers include FTP, AFP, CUP, SMTP, NFS, SMB, and IMAP.
- Click Next to continue. If you selected the Run an HTTP Node on this computer on the Domain Components screen in step 8, the HTTP Node Configuration screen appears. Enter the name for the HTTP Node and click Next to continue.
The Oracle CM SDK Configuration Assistant now has all the information it needs to configure the computer.
- The Summary screen appears. Note the name and location of the log file.
- Click Configure to execute the configuration process using all the information entered via the Oracle CM SDK Configuration Assistant. Once you have started the configuration process, 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 completes, a message appears, telling you that the configuration was successful.
- Click OK to close the message. If the Oracle Universal Installer launched the Oracle CM SDK Configuration Assistant, the Oracle Universal Installer End Installation screen appears.
- On the Oracle Universal Installer End Installation screen, click Exit to exit from the Oracle Universal Installer. Click Yes to confirm that you want to exit the Oracle Universal Installer.
See Chapter 4, "Post-Configuration" for instructions about how to make Oracle CM SDK operational.
Non-Interactive Installation and Configuration
As an alternative to using the graphical tools described in Oracle CM SDK Server Configuration Types, you can use text files to pass values to the installation and configuration scripts. This section contains the following topics:
Non-Interactive Installation
To perform a non-interactive installation, pass the name of a response file (.rsp) to the runInstaller script 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.
Table 3-7 Response File Parameters
The Oracle Universal Installer response file, which copies the base software, libraries, and various scripts to the computer for further configuration, is located on the CD in the stage/Response/ directory.
After making any necessary changes to the response file, use the following two commands to install the software:
cd $<STAGE_LOCATION>/install/<OS>
./runInstaller -responseFile $<STAGE_LOCATION>/stage/Response/oracle.ifs.Complete.rsp
-silent
where <OS> is one of the following:
Table 3-8 Oracle Universal Installer: Operating System Directories
Non-Interactive Configuration
You can configure the Oracle CM SDK domain using this same approach, by passing a text file (containing all the configuration settings) to the Oracle CM SDK Configuration Assistant as a parameter at the command line. The text file (silentconfig.properties) is located in the
$ORACLE_HOME/ifs/cmsdk/settings directory after installing using the Oracle Universal Installer or the installation script.
The file itself contains instructions about how to modify and use it. Modify the response file to meet your specific needs.
To edit the response file and run the Oracle CM SDK Configuration Assistant:
- Open the response file
silentconfig.properties in a text editor.
- Edit the settings in the file. When you are finished modifying the parameters, save and close the file.
- Use the following two commands to run the Oracle CM SDK Configuration Assistant using the modified response file:
cd $ORACLE_HOME/cmsdk/bin
./ifsca -file $ORACLE_HOME/ifs/cmsdk/settings/silentconfig.properties
-silent
The Oracle CM SDK Configuration Assistant script configures Oracle CM SDK on the computer according to the parameters defined in the file. If errors occur during the silent install, check the CmsdkConfig.log file, located in $ORACLE_HOME/ifs/cmsdk/log/, for more information.
Continue with the required post-installation tasks as described in Chapter 4, "Post-Configuration".
Caution:
The silentconfig.properties file contains password information. Delete the file or store it in a safe location after performing a non-interactive configuration.
|