The "oc4j log file" in SES

A common message in Secure Enterprise Search (SES) is something like "xxx operation has failed. See the oc4j log file for more details".

So what is the oc4j log file, and how do we read it?

"oc4j" is Oracle Containers for Java - which is the light-weight web server used by SES. The oc4j log file contains all the logging (and sometimes trace/debug) messages written by oc4j.

Accessing the oc4j log file is easy if you have login access to the server on which SES is running.  If we assume that $SES_HOME represents the installation directory for SES, you will find the oc4j log file in $SES_HOME/oc4j/j2ee/OC4J_SEARCH/log. In 10.1.8.3 or earlier, there would only be a single file "oc4j.log". In 10.1.8.4 there may be multiple files which include the date they were created.

If you don't login access to the server, things are rather more difficult.  However, we can solve it with a one-off installation of a special jsp file. I found an excellent general purpose jsp based file browser, but this is rather too powerful for our needs. Even configured for read-only access to the specific oc4j log directory, it gives a lot of information about other drives and directories. Also, the oc4j log file can sometimes contain information you wouldn't want just anyone to see - like the titles of documents indexed and the names of users - so we really want to restrict access to people who are already logged in to the SES admin system.

So I wrote a new jsp file which can be downloaded from here

You will need access to the server once to install this file, or you can ask a system administrator to install it on your behalf.

Save the downloaded oc4jlogs.jsp file to the directory
$SES_HOME/oc4j/j2ee/OC4J_SEARCH/applications/search_admin/admin/control

It can then be accessed with the URL http://server:port/search/admin/control/oc4jlogs.jsp (replacing "server" and "port" with the values usually used by SES).

That will give you a list of all the files in the oc4j log directory, and you can click on any file to view the contents (it will not allow access to any files outside of the oc4j logs directory).

You must be logged in to the admin system to use this jsp.  If you are not logged in, it will redirect to the login page. Entering the password will drop you in the "main" admin page rather than returning you to the oc4j logs page and you will need to manually re-enter the URL for the oc4j logs.





Comments:

Post a Comment:
  • HTML Syntax: NOT allowed
About

bocadmin_ww

Search

Categories
Archives
« July 2014
MonTueWedThuFriSatSun
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
   
       
Today