Appendix C: Troubleshooting

Linux Windows

Unable to locate ACDB on data server machine.

If you rebuild the master database for Adaptive Server, you must reconfigure the Security Services.

Linux Windows

Enterprise Portal security session expires

In a distributed environment with more than one machine running EAServer, make sure that each machine’s date, time, and time zone are in sync.

Linux Windows

Portal Interface catalog does not display correctly

When performing a manual uninstallation, you must:

• Remove the vpd.properties file from the home directory of the user who performed the installation.

• Clean out the WORKROOT directory (/tmp/logs).

• If you performed a custom installation into an existing Adaptive Server Enterprise, drop the databases in your Adaptive Server Enterprise.

• If you performed a custom installation into an existing EAServer, drop the Onepage Web application, all Security components, epSearchCache, and secDboCache from your EAServer.

Linux

Cannot eject the CD from the drive.

If you cannot eject the CD from the drive:

• Check to see whether the CD drive path is the current directory (pwd) in a Linux terminal window. If it is, change (cd) to another directory.

• Check for sybhelp processes. If these processes exist, kill them using the Linux kill command.

Linux

DISPLAY environment variable not set correctly.

If you run the Installer and you get this error message:

The DISPLAY environment variable is not set correctly. 

it means that the DISPLAY environment variable on the remote machine is not set correctly to display the Installer interface to your local machine.

To correct the problem, enter this command at the Linux prompt on the remote machine: For C shell:

setenv DISPLAY host_name:0.0 

For Bourne shell:

DISPLAY=host_name:0.0; export DISPLAY

where host_name is the name of the machine where you want the Installer interface to appear (that is, on your local machine).

Linux

isql environment not working

If the isql environment is not working when Adaptive Server Enterprise is the target database, at a command line, enter:

source $SYBASE/SYBASE.csh 
source $SYBASE/SYBASE.csh

Linux

Hyperlinks in installer are unclickable.

If clicking the hyperlink does not launch a browser, verify that one of the three supported browsers (Netscape, Mozilla, or Konquerer) is in your PATH. If your PATH contains a version of Netscape not supported by Enterprise Portal, the browser may not launch.

Linux

Installation fails with “Invalid directory” error.

Verify that the installation directory does not contain double-byte character sets. You also cannot use double-byte character sets when you set the “dbo” login.

Linux

Jaguar certificate does not get upgraded during installation.

1. At the command prompt, enter:

   setenv LD_LIBRARY_PATH
   

2. Then enter:

   unsetenv JAGUAR_CLIENT_ROOT
   

3. Change to $SYBASE/EAServer/lib, and enter:

   ./upgrade -pin <pin> -server $SYBASE/EAServer
   

   where <pin> is the EAServer PKCS #11 token PIN. If the PIN has never been changed, use the default of “sybase”.

Linux

Multiple permissions errors on files such as /tmp/logs and audit.log.

If a new account is used to start the EAServer hosting Enterprise Portal, change all the files in the WorkRoot directory to have global RWX permissions.

The WorkRoot property is specified in global.properties.xml. All log files and work files are written to this directory. It is created on start-up if it does not already exist.