3 General Management and Security Issues

3.1.1 Backup and Restore Does Not Function with Multiple Java Virtual Machines

Backup and restore operations do not function correctly when OC4J is configured to have multiple Java Virtual Machines (JVMs).

The loss of functionality occurs due to multiple JVMs accessing the same set of configuration files.

To avoid this issue during backup and restore operations, use only one JVM per OC4J instance.

3.1.2 Error Message When Executing opmnctl Commands

When you execute either an opmnctl stopall or opmnctl startall command, the oidctl log file contains the following error message:

*** Instance Number already in use. *** 
*** Please try a different Instance number. ***

This error message can be safely ignored.

This error message occurs in Oracle Application Server Infrastructure installations with Oracle Internet Directory.

3.2.1 Additional Step Needed After Changing Oracle HTTP Server Listen Port

After you change the Oracle HTTP Server Listen Port, you should update portlist.ini with the new port number. This will avoid potential problems if you later associate the middle tier with an OracleAS Infrastructure or change the OracleAS Infrastructure associated with the middle tier. The portlist.ini file is located in the following directory:

%ORACLE_HOME%\install

3.3.1 Considerations for Cloning Oracle Ultra Search

When you clone an OracleAS Portal instance that has SSL enabled, the Ultra Search Administration link on the Services portlet and Application Server Control Console page point to the URLs for the source instance, not the cloned instance.

To work around this problem, edit the following file and update the PortalListeningHostPort property with the correct port number:

%ORACLE_HOME%\sysman\emd\targets.xml

The port number can be found in the following file:

%ORACLE_HOME%\install\portlist.ini

3.3.2 Considerations for Cloning OracleBI Discoverer

The following describes important information about cloning OracleBI Discoverer:

• Values set by users after installation in configuration.xml are not preserved in the cloned Oracle home. The file is located at:

  %ORACLE_HOME%\discoverer\config\configuration.xml
  
  

  To work around this problem, reset the overwritten values by copying them from the configuration.xml file in the source Oracle home to the configuration.xml file in the cloned Oracle home.

• After you clone a OracleBI Discoverer instance, when you click the Exit link on the Discoverer Viewer page, it results in a corrupted page because the port number in the oc4j.properties file has not been properly updated. To work around this problem, edit the following file and update the oracle.discoverer.applications.port property with the correct port number:

  %ORACLE_HOME%\j2ee\OC4J_BI_Forms\config\oc4j.properties
  
  

  The port number can be found in the following file:

  %ORACLE_HOME%\install\portlist.ini
  
  

3.3.3 Considerations for Cloning OracleAS Forms and Reports Services

The following describes important information about cloning OracleAS Forms and Reports Services (installed from a separate CD):

• Before you run the prepare_clone.pl script, you must update the ias.properties file in the source Oracle home, changing the value of DatabaseManagedClusterSupport from false to true, as shown in the following example:

  DatabaseManagedClusterSupport=true
  
  

• On Windows, before you run the prepare_clone.pl script, you must update the ias.properties file in the source Oracle home, changing the value of installType from FRServices to Business, as shown in the following example:

  installType=Business
  
  

• If you clone OracleAS Forms and Reports Services and then associate it with an OracleAS Infrastructure, the cloned instance is not part of a farm. To make the instance part of a farm, use the following command in the cloned Oracle home:

  dcmctl joinfarm
  
  

• On Windows, if Grid Control Console is installed on the same machine as OracleAS Forms and Reports Services, the OracleAS Reports Services configuration tool fails. To work around this, delete the following file from the zip file before you extract the compressed Oracle home at the target.

3.4.1 Use Trusted Certificates When Enabling SSL Between mod_oc4j and OC4J

You must use trusted certificates on both ends when enabling SSL between mod_oc4j and OC4J.

Otherwise, you will get the following error when accessing the HTTPS port:

500 Internal Server Error 

3.4.2 Benign Decoding Errors When Running ldapaddmt

Chapter 11, "Changing from a Test to a Production Environment," in Oracle Application Server Administrator's Guide contains steps for migrating Oracle Internet Directory data to a production environment.These steps include running the ldapaddmt command, and examining the add.log file. The add.log file may contain a Decoding Error message. This is benign and can be ignored.

3.4.3 Missing Files During restore_config Operation

Running restore_config may result in missing files messages such as:

Could not copy file C:\Product\OracleAS\Devkit_1129/testdir/ to 
C:\Product\OracleAS\Devkit_1129\backup_restore\cfg_bkp/2004-12-01_03-26-22.

During a restore_config operation, a temporary configuration backup is taken so that, if the restore fails, the temporary backup can be restored returning the instance to the same state as before the restore.

If some files are deleted (including files or directories specified in config_misc_files.inp) before a restore operation, then, during the temporary backup, messages are displayed indicating that certain files are missing. These error or warning messages should be ignored since the missing files are restored as part of the restore_config operation.