Oracle® Collaboration Suite Installation Guide 10g Release 1 (10.1.2) for Linux Part Number B25465-12 |
|
|
View PDF |
This appendix describes common installation problems and solutions.
This appendix contains the following sections:
Section K.6, "Troubleshooting Administration Errors After Installation"
Section K.7, "Troubleshooting Oracle Collaboration Suite Web Client Configuration"
Section K.8, "Troubleshooting Oracle Real Application Clusters"
Review the following information before performing any of the troubleshooting steps in this appendix:
Ensure that the computer meets the requirements specified in Chapter 2.
Ensure that you have completed all of the preinstallation tasks specified in Chapter 3.
If you are installing Oracle Collaboration Suite Applications, check that the Infrastructure that you want to associate the Oracle Collaboration Suite Applications with is running during installation.
Read the Oracle Collaboration Suite Release Notes for Linux prior to installing Oracle Collaboration Suite. The release notes are available with the platform-specific documentation. The most current version of the release notes is available on Oracle Technology Network at
If you are serving non-English content and forgot to install additional languages as explained in Section 1.9, the user interface might not be displayed properly because the required fonts were not installed. You can fix this by installing the fonts from the Oracle Metadata Repository Creation Assistant and Utilities CD-ROM. The steps to do so are as follows:
Insert and mount the Oracle Application Server Metadata Repository Creation Assistant 10g (10.1.2.0.2) CD-ROM.
Copy the contents of the utilities/fonts
directory on the CD-ROM to the ORACLE_HOME/jdk/jre/lib/fonts
directory.
This section describes the general tips for troubleshooting installation failures. See Section K.4 for specific failures and their solutions.
If you encounter an error during the installation of Oracle Collaboration Suite:
If you entered incorrect information about one of the installation screens, return to that screen by clicking Back until you see the screen.
Exit the installer only to access the component log files. The log files located in the ORACLE_HOME/cfgtoollogs
directory are inaccessible if the installer is still in use.
If you encounter an error while the installer is copying or linking files, perform the following tasks:
Note the error and review the installation logs for causes:
oraInventory_location
/logs/installActions
timestamp
.log
oraInventory_location
/logs/oraInstall
timestamp
.err
oraInventory_location
/logs/oraInstall
timestamp
.out
Remove the failed installation by following the steps in Appendix J.
Correct the issue that caused the error.
Restart the installation.
This section describes common installation problems and solutions:
Section K.4.3, "Prerequisite Checks Fail at the Start of Installation"
Section K.4.4, "Message About Installing in a Non-Empty Directory"
Section K.4.5, "Installer Disappears After Running the Preinstallation Checks"
Section K.4.7, "Forgot the Password for the cn=orcladmin Account"
Section K.4.9, "Installer Does Not Display Correct Database Name for OracleAS Metadata Repository"
Section K.4.10, "Configuration Assistant Failures - General"
Section K.4.11, "OracleAS Randomize Password Configuration Assistant Failures"
Section K.4.12, "Database Configuration Assistant (DBCA) Failures"
Section K.4.13, "Harmless Error Message from Database Configuration Assistant (DBCA)"
Section K.4.15, "OPMN Configuration Assistant - Start HTTP Server Failures"
Section K.4.16, "OPMN Configuration Assistant - Start DAS Instance Failures"
Section K.4.17, "OPMN Configuration Assistant - Start OracleAS Certificate Authority Failures"
Section K.4.18, "WARNING: DCM Service May Not be Available at This Time"
There are two sets of log files:
The installer writes the following log files:
oraInventory_location
/logs/installActions
timestamp
.log
oraInventory_location
/logs/oraInstall
timestamp
.err
oraInventory_location
/logs/oraInstall
timestamp
.out
$ORACLE_HOME
/install/make.log
The configuration assistants write log files in the $ORACLE_HOME
/cfgtoollogs
directory.
Note that if you want to access the log files created by the configuration assistants, you need to exit the installer first. The log files are inaccessible if the installer is still in use.
Problem
Linking failed, and ORA errors were displayed during installation
Solution
Exit the installer and check the log files for any error message. In particular, check the $ORACLE_HOME
/install/make.log
file.
Remove the failed installation. Before reinstalling Oracle Collaboration Suite, make sure that your computer meets all the requirements listed in Chapter 2.
Check especially the following requirements:
Check that the kernel parameters are set to the proper values. Note that if you change the value of a kernel parameter, you must exit the installer and restart your computer for the new value to take effect.
Check that you are installing Oracle Collaboration Suite in a valid directory. For example, you cannot install Oracle Collaboration Suite in a database Oracle home. See Section 2.10 for a complete list.
Problem
The prerequisite checks that are run at the start of installation failed
Solution
If the prerequisite checks display warnings about missing operating system patches or patch bundles, the patch may actually be missing, or it may have been superseded. If your computer contains the patch that supersedes it, you can ignore the warning.
Problem
The installer displays a message that you are installing into a non-empty directory.
Solution
If you started an installation and went beyond the Specify File Locations screen, but did not complete the installation, then the installer has already created the Oracle home directory that you specified. If you later try to install again in the same directory, which contains some files created by the installer, the installer gives a warning that the directory is not empty.
You must perform the following tasks:
In the warning dialog, click No to return to the Specify File Locations screen.
In the Specify File Locations screen, click Installed Products. This displays the Inventory screen.
If your Oracle home is listed in the Inventory screen, then you have to deinstall the Oracle home. See Appendix J for details.
If your Oracle home is not listed in the Inventory screen, then you can just delete the files from the Oracle home and continue with the installation.
Problem
The installer disappears after running preinstallation checks
Solution
The directory that is the mount point of the CD-ROM or DVD-ROM was mounted with incorrect permissions, and this caused the pwd
command to not work correctly. When you run pwd
, it returns "cannot determine current directory".
To fix this problem, forform the following steps:
Unmount the CD-ROM.
Change permissions of the mount directory to 755.
Remount the CD-ROM.
The installer should now run correctly.
If your installation was not successful, you have to deinstall it first before you can install Oracle Collaboration Suite again. Refer to Appendix J for instructions.
Problem
You forgot the password for the cn=orcladmin
account.
Solution
You can reset the password in the database. The DSE root attribute name is orclsupassword
.
Note: After a certain number of failed attempts to connect, the cn=orcladmin account becomes locked. In this case, you have to unlock the account. See the next section, Section K.4.8, for instructions on how to unlock the account. |
Problem
The cn=orcladmin
account becomes locked after 10 failed attempts to connect. This is controlled by the password policy. 10
failed attempts is the default value.
Solution
If you know the cn=orcladmin
password, then you can unlock the account by running the following command:
prompt> $ORACLE_HOME/bin/oidpasswd connect=dbsid unlock_su_acct=true
In the preceding comamnd, dbsid
is the SID for the database. For example:
prompt> $ORACLE_HOME/bin/oidpasswd connect=orcl unlock_su_acct=true OID DB user password: enter_ODS_password OID superuser account unlocked successfully.
The command prompts for the password of the ODS schema. By default, the ODS password is the same as for the cn=orcladmin
and ias_admin accounts, which you entered during installation.
To change the password policy, see the Oracle Internet Directory Administrator's Guide.
Problem
During the Applications tier installation, in the Select OracleAS Metadata Repository screen, which is the screen where you select the OracleAS Metadata Repository that you want to use for the Applications tier, the installer does not display correctly the names of the available OracleAS Metadata Repository databases.
Solution
Check the log file oraInventory
/logs/installActions
timestamp
.log
. Look for the following lines:
*** Select OracleAS Metadata Repository Page*** Error:*** Alert: Error validating repository on multiple hosts and ports. A database hostname or port is missing.
If you see these lines, it means that your OracleAS Metadata Repository database name contains PORT
or HOST
in uppercase characters. To fix the problem, change the name of the database so that it does not contain PORT
or HOST
in uppercase characters.
This section describes the general tips for troubleshooting configuration assistant failures. See Section K.5 for specific configuration assistant failures.
Problem
Configuration assistant failed
Solution
Configuration assistants fail for a variety of reasons. Some things you can check are:
Check that the listener, database, and Oracle Internet Directory associated with the Oracle Collaboration Suite Infrastructure are up and running. If not, start them up and click Retry to rerun the configuration assistant that failed.
Check the log files for the failed configuration assistant to determine the problem. The log files are located in the $ORACLE_HOME
/cfgtoollogs
directory.
Fix the problem indicated in the log file, and click Retry to rerun the failed configuration assistant.
Before rerunning OracleAS Randomize Password Configuration Assistant, you need to perform these steps:
Start Oracle Directory Manager.
Enter the Oracle Internet Directory host name, port, user name, and password.
Expand Entry Management, cn=OracleContext, cn=Products, cn=IAS, cn=IAS Infrastructure Databases.
Select orclreferencename=your_globaldb_name
.
For each schema under the your_globaldb_name
tree, there is an orclreferencename
entry. For the orclreferencename
entry:
Change the value of the orclpassword
attribute to the schema name. For example, if wireless
is the schema name, change the orclpassword
attribute value to wireless
.
Change orclflexattribute1
to false.
Click Apply.
Perform these steps for all the schemas except ODS
and OEM_REPOSITORY
.
Using SQL*Plus, log in to the database where the OracleAS Randomize Password Configuration Assistant failure is occurring, and run the following script.
prompt> sqlplus "sys/password as sysdba" SQL> @ORACLE_HOME/assistants/dbca/admin/unlock.sql
In the preceding command, password
specifies the password for the SYS user.
Rerun the OracleAS Randomize Password Configuration Assistant.
Problem
DBCA fails with the following error:
Open wallet failedoracle.net.config.ServiceAliasException at oracle.net.config.ServiceAlias.<init>(Compiled Code) at oracle.net.config.Service.<init>(Compiled Code) at oracle.net.config.DatabaseService.<init>(Compiled Code) at oracle.sysman.assistants.util.NetworkUtils.registerDBWithDirSrvc(NetworkUtils.j ava:1137) at oracle.sysman.assistants.dbca.backend.DirServiceStep.executePreReqImpl(Compiled Code) at oracle.sysman.assistants.dbca.backend.PrerequisiteStep.executeImpl(Prerequisite Step.java:149) at oracle.sysman.assistants.dbca.backend.Step.execute(Compiled Code) at oracle.sysman.assistants.dbca.backend.PostDBCreationStep.executeImpl(Compiled Code) at oracle.sysman.assistants.dbca.backend.Step.execute(Compiled Code) at oracle.sysman.assistants.dbca.backend.Host$ModeRunner.run(Compiled Code) at java.lang.Thread.run(Thread.java:466) ERROR :oracle.sysman.assistants.util.NetAPIException
Solution
This error occurs if the TNS_ADMIN environment variable is set. The TNS_ADMIN environment variable should not be set (see Section 2.7). If it is set, unset it and rerun DBCA by clicking Retry in the Configuration Assistants screen.
If you see the following "error copying OC4J config files" message in your log file, the message is harmless and can be ignored.
Nov 25, 2004 9:07:30 PM oracle.sysman.emcp.EMConfig updateReposVars INFO: Updating file /ASInstalls/ASInfra/sysman/emdrep/config/repository.variables ... Nov 25, 2004 9:07:35 PM oracle.sysman.emcp.EMConfig addPortEntries INFO: Updating file /ASInstalls/ASInfra/install/portlist.ini ... Nov 25, 2004 9:07:35 PM oracle.sysman.emcp.EMConfig updateEmdProps INFO: Updating file /ASInstalls/ASInfra/sysman/config/emd.properties ... Nov 25, 2004 9:07:35 PM oracle.sysman.emcp.EMConfig updateConfigFiles INFO: targets.xml file is updated successfully Nov 25, 2004 9:07:35 PM oracle.sysman.emcp.EMConfig updateEmomsProps INFO: Updating file /ASInstalls/ASInfra/sysman/config/emoms.properties ... Nov 25, 2004 9:07:35 PM oracle.sysman.emcp.EMConfig updateConfigFiles INFO: emoms.properties file is updated successfully Nov 25, 2004 9:07:40 PM oracle.sysman.emcp.EMConfig copyOC4JDir WARNING: Error copying OC4J config files from /ASInstalls/ASInfra/oc4j/j2ee/OC4J_DBConsole to /ASInstalls/ASInfra/oc4j/j2ee/OC4J_DBConsole_hostname.domain_portaldb Nov 25, 2004 9:07:40 PM oracle.sysman.emcp.EMConfig startOMS INFO: Starting the DBConsole ... Nov 25, 2004 9:08:26 PM oracle.sysman.emcp.EMConfig perform INFO: DBConsole is started successfully
Problem
The OracleAS Certificate Authority Configuration Assistant fails with following error (in the oca_install.log
file) for remote Metadata Repository:
checkAndClean : Error: Repository chosen for this oca installation is already used by other oca instance java.sql.SQLException: ORA-01017: invalid username/password; logon denied
Solution
Perform the following steps to resolve this error:
End the installer session.
Set the environment variables and run $ORACLE_HOME
/cfgtoollogs/configToolCommands
as follows:
prompt> ORACLE_HOME=IM_ORACLE_HOME prompt> PATH=$ORACLE_HOME/bin:$ORACLE_HOME/opmn/bin:$ORACLE_HOME/dcm/bin:$ORACLE_HOME/oca/bin:$PATH prompt> LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH prompt> export ORACLE_HOME PATH LD_LIBRARY_PATH prompt> $ORACLE_HOME/cfgtoollogs/configToolCommands
Problem
The OPMN Configuration Assistant - Start HTTP Server fails when you rerun it.
Solution
The problem is that Oracle HTTP Server is already running. Before rerunning the configuration assistant, stop Oracle HTTP Server with the following command:
prompt> $ORACLE_HOME/opmn/bin/opmnctl stopproc ias-component=HTTP_Server
Rerun the OPMN Configuration Assistant - Start HTTP Server.
Problem
The OPMN Configuration Assistant - Start DAS Instance fails when you rerun it.
Solution
The problem is that the Oracle Delegated Administration Services instance is already running. Before rerunning the configuration assistant, stop the Oracle Delegated Administration Services instance by using the following command:
prompt> $ORACLE_HOME/opmn/bin/opmnctl stopproc ias-component=OC4J_Security
Rerun the OPMN Configuration Assistant - Start DAS Instance.
Problem
The OPMN Configuration Assistant - Start OracleAS Certificate Authority fails when you rerun it.
Solution
The problem is that the OracleAS Certificate Authority instance is already running. Before rerunning the configuration assistant, stop the OracleAS Certificate Authority instance with the following command:
prompt> $ORACLE_HOME/opmn/bin/opmnctl stopproc ias-component=OC4J instancename=oca
Rerun the OPMN Configuration Assistant - Start OracleAS Certificate Authority.
Problem
When installing the first node of a cluster, the Java Security Configuration Assistant may return the following message:
WARNING: DCM service may not be available at this time to synchronize $ORACLE_HOME/j2ee/home/config/jazn-data.xml file.
This is due to a failure in updating the DCM repository and could happen if your load balancer virtual server is not configured to return immediately to the calling client when the backend services to which it forwards traffic are unavailable.
Solution
Perform the following steps to correct the problem:
Run the following command after installation completes:
prompt> $ORACLE_HOME/dcm/bin/dcmctl updateConfig -ct jazn
Verify that the dcmctl updateConfig
command did not return any errors.
This section contains the following topics:
To troubleshoot errors that occur when configuration assistants are running:
Review the installation log files listed in Section K.3.
Review the configuration assistant log files located in the ORACLE_HOME/cfgtoollogs
directory for a specific Oracle Collaboration Suite configuration assistant. Try to fix the issue that caused the error.
If you see a "Fatal Error. Reinstall" message, try to find the cause of the problem by analyzing the log files. Refer to Section K.5.4 for further instructions.
Configuration assistant failures are noted at the bottom of the installation screen. The configuration assistant interface displays additional information, if applicable. The execution status of the configuration assistant is identified by these result codes:
Status | Result Code |
---|---|
Configuration Assistant Succeeded | 0 |
Configuration Assistant Failed | 1 |
Configuration Assistant Cancelled | -1 |
Result codes are written to the following log file:
oraInventory_location
/logs/installActions
timestamp
.log
.log
During the installation, configuration assistants run when the Configuration Assistants screen appears. If a configuration assistant fails, try the following procedure to correct the problem:
Review the installation log files.
Review the log files for each configuration assistant located in the ORACLE_HOME/cfgtoollogs
directory (Example: /data/mtier/cfgtoollogs
or /data/infra/cfgtoollogs
).
Refer to the following:
If the failed configuration assistant has any dependencies, then run the dependencies again. You must do this even if the dependency completed successfully.
Run the failed configuration assistant again. If you are using the installer, select the configuration assistant and click Retry.
If the configuration assistant fails again after you click Retry, then remove the /temp/EM_CONFIG_INSTALL.lk
file and try rerunning the configuration assistant.
If the configuration assistant fails again after you click Retry, then remove the component entry from the ORACLE_HOME
/sysman/emd/targets.xml
file.
If an optional configuration assistant fails, and it does not have any dependencies, run the remaining configuration assistants. Uncheck the cancelled optional configuration assistant, highlight and check the next listed configuration assistant, and click Retry.
If configuration assistant failure occurs when you are running configuration assistant execution commands from Oracle Universal Installer or on the command line, then rerun the configuration assistant execution command again.
You can use the generated script file named configToolCommands
located in the ORACLE_HOME
/cfgtoollogs
directory to execute the failed configuration assistant again. The configToolCommands
script is generated after you exit the installer. During silent or noninteractive installation, the configToolCommands
script is generated immediately after configuration assistant failure.
You must perform the following tasks before using the generated script:
Open the autogenerated $ORACLE_HOME
/cfgtoollogs/configToolCommands
script in an editor. Search and replace all occurrences of *Protected value, not to be logged*
with the passwords you specified during the installation. If it is a common password, then it becomes simpler and you just have to replace all occurrences of the preceding string with that common password.
Set the ORACLE_HOME environment variable to the ORACLE_HOME
path.
Append the LD_LIBRARY_PATH environment variable with $ORACLE_HOME/lib32:$ORACLE_HOME/lib:$ORACLE_HOME/network/lib32:$ORACLE_HOME/network/lib
.
Run the $ORACLE_HOME
/cfgtoollogs/configToolCommands
script to rerun all the failed and skipped configuration assistants.
Set the ORACLE_HOME environment variable to the ORACLE_HOME
path.
Append the LD_LIBRARY_PATH
environment variable with $ORACLE_HOME/lib32:$ORACLE_HOME/lib:$ORACLE_HOME/network/lib32:$ORACLE_HOME/network/lib
.
Note: If the description of a configuration assistant includes an "Initial Tasks" section, you must perform these tasks before running the configuration assistant. |
Some configuration assistant failures are Irrecoverable (fatal). You cannot recover from an Irrecoverable error by correcting the problem and continuing. You must remove the current installation and reinstall Oracle Collaboration Suite. The following tasks describe the recovery procedure:
Deinstall the failed installation using the procedure described in Appendix J.
Correct the cause of the Irrecoverable error.
Reinstall Oracle Collaboration Suite.
If the error reoccurs, then you must remove all Oracle installations from your computer.
This section explains some errors that you may encounter after installation.
If a user logs in to Oracle Collaboration Suite and sees a generic OracleAS Portal page instead of the Oracle Collaboration Suite Home page, do the following:
Ensure that the user is a member of the Oracle Collaboration Suite Users group, as follows:
Log in to Oracle Delegated Administration Services as orcladmin
at the following URL:
http://host_name:port_number/oiddas/
Note: In a typical installation, Oracle Delegated Administration Services is located where the Infrastructure is installed. |
Click the Directory tab.
Search for the user by user ID (orclguest
, for example).
Select the user from the search results, and click Edit.
Scroll down to the Public Groups Assignment section, and ensure that the user is a member of the Oracle Collaboration Suite Users group.
If the user is not a member, select the Oracle Collaboration Suite Users box, and click Apply.
Log out of Oracle Delegated Administration Services.
Ensure that the Oracle Collaboration Suite Users group is the user's default group, as follows:
Log in to OracleAS Portal as the user in question. For example, go to http://
host_name
:
port_number
/
, click End User Login, and log in as orclguest
.
If the Oracle Collaboration Suite Home page appears, the user is now correctly provisioned and the rest of this procedure is unnecessary.
If the OracleAS Portal Welcome page appears, click Account Info.
On the Account Info page, ensure that the user's default group is set to OCS_PORTAL_USERS
.
If it is not, manually enter OCS_PORTAL_USERS
for the user's default group, and click Apply.
Ensure that the user's Default Home Page is blank.
Click the Home global button. You should see the Oracle Collaboration Suite Home page. If not, proceed to Step 3.
If the Oracle Collaboration Suite Home page still does not appear, do the following:
Log in to OracleAS Portal as the user in question. For example, go to http://
host_name
:
port_number
/
, click End User Login, and log in as orclguest
.
When the OracleAS Portal Welcome page appears, click Account Info.
On the Account Info page, ensure that the user's default group is set to OCS_PORTAL_USERS
.
If it is not, manually enter OCS_PORTAL_USERS
for the user's default group, and click Apply.
Click the Browse Pages icon next to the Default Home Page field.
Locate the OCS_V2_PAGE_GROUP
page group, and click to expand it.
Locate the Oracle Collaboration Suite Home page, and click Return Object.
Click Apply.
Click the Home global button and the correct home page should appear.
To ensure that the installation succeeds on the remote nodes you choose, select a path for Oracle home that is the same on all chosen nodes and is writable. Otherwise, installation on the remote nodes fails. No error message indicates this failure.
If this appendix does not solve the problem you encountered, try these other sources:
Oracle Collaboration Suite Release Notes, available on the Oracle Technology Network at
OracleMetaLink at
If you have a support contract with Oracle, then the steps to download a patch from the OracleMetaLink site are:
login to OracleMetaLink at
Click Patches & Updates on the left side of the page.
Ensure that Patch Number is selected in the Simple Search list.
Enter the required patch number in the adjacent box.
If you do not know the patch number that you need to download, then select Product or Family in the Simple Search list.
Select the appropriate operating system from the Platform or Language list.
Click Go.
Under Results, click Download to download the patch or click View Readme to go through the information in the readme before downloading the patch.
If you do not find a solution for your problem, open a service request.