Netra j 2.0 Administrator's Guide

Enabling Error Message Logging

This release of HotJava Views has an error message logging capability that is used most extensively by NameView. If you want to enable this capability, use the following procedure on the system running your web server.

Assuming you have installed HotJava Views in /opt/SUNWjdt, make a symbolic link called jdt from within your httpd server's cgi-bin directory (this location will vary among servers) to /opt/SUNWjdt/cgi-bin.

For example, if you are running the Apache server, you can use the following commands:
```
# pwd
# /opt/WWW/Apache/httpd/cgi-bin Your
httpd server's cgi-bin dir
# ln -s /opt/SUNWjdt/cgi-bin ./jdt
# ls jdt
# getidsvc.2.0   jdtlogsvc  namesvc.2.0
```

Some web servers require that you explicitly turn on cgi-bin support before cgi-bin scripts can be executed. Refer to your httpd server's documentation to determine your server's requirements.

Edit the /etc/syslog.conf file and add the following line:
```
# local0.info		/var/opt/SUNWjdt/jdt.log
```
Make sure that you use tabs, not the spaces between the values.

Create /var/opt/SUNWjdt/jdt.log and modify its permissions:

# mkdir /var/opt/SUNWjdt
# touch /var/opt/SUNWjdt/jdt.log
# chmod 666 /var/opt/SUNWjdt/jdt.log

Restart the syslog daemon:
```
# kill -HUP `cat /etc/syslog.pid
```
HotJava Views uses CGI to send error messages to the jdtlogsvc script on your web server. The jdtlogsvc script uses syslog to log the errors.