Oracle® Collaboration Suite Installation Guide 10g Release 1 (10.1.1) for Linux Part Number B15793-02 |
|
|
View PDF |
This appendix describes common installation problems and solutions.
This appendix contains the following sections:
Section I.5, "Troubleshooting Administration Errors After Installation"
Section I.6, "Troubleshooting Oracle Collaboration Suite Web Client Configuration"
Section I.7, "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.8, 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.
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 H.
Correct the issue that caused the error.
Restart the installation.
This section contains the following topics:
To troubleshoot errors that occur when configuration assistants are running:
Review the installation log files listed in Section I.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 I.4.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
\cfgtoollogs
directory (Example: /data/mtier/cfgtoollogs
C:\oracle\data\mtier\cfgtoollogs
or /data/infra/cfgtoollogs
C:\oracle\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
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
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 H.
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.