Skip Headers

Oracle Internet File System Installation Guide
Release 9.0.1.1.0 for Microsoft Windows NT/2000
Part Number A85272-03
Go To Table Of Contents
Contents		 Go To Index
Index

Go to previous page Go to next page

8
Troubleshooting

This chapter describes common installation problems and solutions.

Troubleshooting Installation Problems

This section contains information to assist with installation errors and problem diagnosis. The <drive>:\Program Files\Oracle\Inventory\logs\ installActions.log file records any errors encountered during installation. The %ORACLE_HOME%\9ifs\log\IfsConfigOut.log file records errors encountered during Oracle 9iFS configuration.

Classpath Failures

If you receive the "classpath verification fails" message when you run the Configuration Assistant, the Configuration Assistant has looked through the installed ORACLE_HOME and tried to locate the required libraries. If they are missing, the Configuration Assistant will not allow the Oracle 9iFS configuration to proceed.

If the ojsp.jar and servlet.jar files are missing, the Oracle HTTP Server (powered by Apache) was not installed correctly in the ORACLE_HOME where Oracle 9iFS was installed. The HTTP Server is a required component of Oracle 9iFS.

If the translator.zip file is missing, Oracle JServer was not installed correctly in the ORACLE_HOME where Oracle 9iFS was installed. translator.zip contains the Oracle SQLJ library. The Oracle loadjava utility requires it, and Oracle 9iFS requires the loadjava utility.

To fix this problem, reinstall the Oracle database. Make sure to use Oracle 8.1.7.2 or Oracle9i, and select a "typical" installation. This should install all required components.

Common Installation Errors

Most installation errors usually involve failure to carefully follow pre-installation instructions. The following table describes some common installation problems, what may have caused them, and what you should do to correct the problem.

Problem  Probable Cause  Corrective Action 

Error messages regarding DBMS_JAVA package during Oracle configuration test process (Oracle 9iFS Configuration Assistant). 

Oracle JServer package not correctly installed or running. 

Query the Oracle database for the package name as described on "Task 6: Ensure that JServer is Installed in the Database" and install it if necessary. See the Oracle9i Installation and Administration documentation for complete details. 

Error in creating or upgrading database objects 

Database not running or available, or the Listener not running. 

Start the database or listener prior to database actions.  

Database-related Installer error messages 

Starting installation without the database running.

Attempting to configure Oracle 9iFS without correctly configuring Oracle Text. 

Start database prior to installation and check the tnsnames.ora and listener.ora files.  

Permission problems during installation 

Attempting to install as the wrong user. 

Check permissions on the file system the installation is attempting to write to.

Install Oracle 9iFS as the same user who installed Oracle9i on the machine. 

Oracle 9iFS servers fail due to insufficient database resources 

Values in init<sid>.ora are too low. 

Check the %ORACLE_HOME%\9ifs\log directory for the log file of the failed server. Edit the init<sid>.ora file, but provide larger values. 

Out of database cursors written to the log file: %ORACLE_HOME%\9ifs\ log\Node.log 

Values of the open_cursors in the init<sid>.ora are too low. 

Edit the init<sid>.ora file, but provide a larger value for open_cursors. 

Server is slow  

Tuning needs to be done. 

See the "Chapter 9: Oracle 9iFS Troubleshooting and Performance Information" in the Oracle Internet File System Setup and Administration Guide. 

Cannot search on document contents after upgrading the Oracle Internet File System schema from version 1.0 or version 1.1. 

Oracle9i Text index was not re-populated. 

See Chapter 6, "Upgrading from a Previous Version of Oracle 9iFS" for more information. 

iFSConfig hangs during "Verifying Oracle9i Text" phase. 

ctxhx is misconfigured and is spinning. 
  1. Using Windows Task Manager, check your operating system processes to verify that ctxhx is using more than 80% of a CPU and does not complete within a minute.

  2. Kill the ctxhx process.

  3. Rerun iFSConfig.

  4. If that does not solve the problem, then test ctxhx independently of iFSConfig by issuing these two single lines: 

    cd %ORACLE_HOME%\ctx\bin
ctxhx %ORACLE_
HOME%\adm\sql\ifsctxtest.doc test.html
  5. If this fails, contact Oracle Support.

  6. If this succeeds, then test VerifyContext independently of iFSConfig.

  • Create a temporary table with a BLOB column.

  • Create an Oracle9i Text index on that BLOB column.

  • Put a simple Microsoft Word document into the BLOB column.

  • Synchronize the Oracle9i Text index.

  • Query for the document content.

    Test VerifyContext by issuing these two single lines: 

    cd %ORACLE_HOME%\9ifs\bin
ifsenv $IFS_JRE -classpath $IFS_BASE_
CLASSPATH 
oracle.ifs.tools.VerifyContext sys 
change_on_install %ORACLE_
HOME%\9ifs\admin\sql\ifsctxtest.doc

    [and if the database is on a separate machine, supply the optional JDBC connect string, such as: 

     jdbc:oracle:oci8:@myTNSalias]
  • Examine the output of VerifyContext to determine the source of the error.

 

Troubleshooting Oracle Enterprise Manager Problems

Problem  Probable Cause  Corrective Action 

Cannot start the Oracle 9iFS domain using Oracle Enterprise Manager Console. 

Appropriate Windows NT/2000 access privileges for Oracle 9iFS not set. 

Give IFS the "Logon as batch job" privilege. See "Setting Up Oracle Enterprise Manager" for more information. 

Cannot discover Oracle 9iFS targets (Oracle 9iFS Domain Controllers and Oracle 9iFS Nodes) in Oracle Enterprise Manager Console 

Oracle Intelligent Agents on the hosts of those Oracle 9iFS targets are not running or didn't discover the targets. Oracle Enterprise Manager hasn't refreshed for those hosts 

Before running the Oracle 9iFS Configuration Assistant, as one of the pre-installation tasks, configure an Oracle Enterprise Manager repository via %ORACLE_HOME%\bin\emca. Refer to "Task 8: Prepare Middle-tier Machine or Oracle9i Home" in Chapter 2, "Pre-installation".

After you run the Oracle 9iFS Configuration Assistant, as a post-installation task:

  1. Start/Restart the Oracle9i Intelligent Agents on all the hosts of the Oracle 9iFS domain by using the Windows NT/2000 Services control panel.

  2. Check whether the IAs have discovered the Oracle 9iFS targets. Check %ORACLE_HOME%\network\agent\services.ora. You should find the entry for the Oracle 9iFS Domain Controller if you configured an Oracle 9iFS Domain Controller on that host and the entries for all the Oracle 9iFS nodes (except HttpNode) that you configured on that host. You should see entries for oracle_sysman_ifs and oracle_sysman_ifs_node in the services.ora file.

  3. Check to see that these files exist: 

    %ORACLE_HOME%\network\agent\config\ifs.ora
%ORACLE_HOME%\network\agent\config\ifs.tcl

    Check to see if %ORACLE_HOME%\sysman\config\OEMClient.properties contains entries for ifs. If there are no entries for ifs, run the ifsoemsetup batch file.

    You can also try running %ORACLE_HOME%\9ifs\bin\ifsoemappsetup.

  4. Open the Oracle9i Enterprise Manager Console. 

    oemapp console

    Use the Discovery Wizard to discover or refresh all the hosts of the Oracle 9iFS domain.

 

A job or event on the Oracle 9iFS Domain Controller on the Oracle 9iFS Node does not work. 

ifsomssetup was not run on the machine where OMS is running, or OMS was stopped and restarted after the batch file was run. 

On the machine where OMS is (or will be) running:

  1. Stop OMS if it is running.

  2. Run the ifsomssetup batch file.

  3. Restart OMS.

 

A second middle-tier Oracle 9iFS service does not start. No services display after starting the domain. 

The TNS local service name is not the same as the TNS local service name used when Oracle 9iFS was configured. 

Re-configure the TNS local service name on the middle-tier machines to match the TNS service name used when Oracle 9iFS was configured. The TNS service names is stored once in the Oracle 9iFS schema and is retrieved and used for all middle-tier machines, so if the names don't match, the Oracle 9iFS service will not start. 

When to Contact Oracle Support Services

Before calling Oracle Support Services:

Verify your software, database, and environment configurations match those contained in Chapter 2, "Pre-installation".

Be prepared with your CSI number (if applicable) or full contact details, including any special project information, complete release numbers of Oracle 9iFS and associated products, operating system name and version number.

Make note of error code numbers and a full description of the issue, including:

  • What did or did not happen?

    For example, the command used and result obtained.

  • When did it happen?

    For example, during peak system load, or after a certain command, or after an Operating System upgrade.

  • Where did it happen?

    For example, on the database machine or on the Oracle 9iFS machine.

  • What is the extent of the problem?

    For example, production system unavailable, or moderate impact but increasing with time, or minimal impact and stable.

Keep copies of installation logs, Oracle 9iFS logs, Oracle Text logs, trace files, core dumps, and redo log files recorded at or near the time of the incident. Oracle Support Services may need these to further investigate your problem.

For installation-related problems, please have the following additional information available:

Oracle Support Services can be reached at the following numbers. The hours are detailed in your support contract.

For a complete list of Support Numbers, see: http://www.oracle.com/support/contact_us/sup_hot_phone.html

Go to previous page Go to next page
Oracle
Copyright © 2001 Oracle Corporation.
All Rights Reserved.
Go To Table Of Contents
Contents		 Go To Index
Index