SunScreen 3.1 Administration Guide

Troubleshooting

You can use the ssadm debug_level command to control the printing of debugging information from the SunScreen kernel.

To Use the ssadm debug_level Command

If you type it with no arguments, ssadm debug_level displays the current debug-level mask. By default, this mask is "1," which means it only reports significant errors.

If you specify a hexadecimal number as an argument for ssadm debug_level, it sets the kernel debugging mask to that level.

  1. Type the following to list the debugging bit choices:


    # ssadm debug_level ?
    
  2. Select a ssadm debug_level mask by setting all of the debugging bits in which you are interested.

Probably the most useful example of the ssadm debug_level debugging bit is DEFAULT_DROP.

To Install and Configure the Netscape Browser

Note -

When using the Java Plug-in for Netscape Navigator, follow the instructions in the Netscape release notes. In particular, you should define the MOZILLA_HOME environment variable and include the Netscape installation directory in your PATH, so you do not have to type the full path name every time you run Netscape.


Perform the following steps to install and configure the Netscape browser for SunScreen administration.

  1. Set up environment for installing and running the Java Plug-in.

    1. For sh or ksh users, type:


      # unset CLASSPATH
      # MOZILLA_HOME=/opt/netscape
      # PATH=$MOZILLA_HOME:$PATH
      # export PATH MOZILLA_HOME
      

    2. For csh users, type:


      % unsetenv CLASSPATH
      % setenv MOZILLA_HOME /opt/netscape
      % set path = ( $MOZILLA_HOME $path )
      

  2. Install the Java Plug-in by typing:


    # sh Java_Plugin_File_Name.sh
    
  3. Save the identitydb.obj file. See "Saving the identitydb.obj File".

  4. Access the SunScreen administration GUI in one of two ways:

    1. Access the SunScreen administration GUI with no access to local files by typing:


      # netscape http://screenhost:3852/
      

    2. Access the SunScreen administration GUI using the Java Plug-in with access to local files for backup and restore by typing:


      # netscape http://screenhost:3852/plugin/
      

Setting the CLASSPATH

    Set the CLASSPATH environment variable only if you need to install special Java files in Netscape Communicator.

Communicator uses CLASSPATH to find local .class files. If CLASSPATH is set in your environment, only the .jar files and directories specified in the CLASSPATH are searched. If you set your CLASSPATH, you must make sure that each .jar file in $MOZILLA_HOME/java/classes is listed individually in your CLASSPATH.

Saving the identitydb.obj File

After installing the Java Plug-in, save the identitydb.obj file to distribute to the Administration Stations.

  1. Save the file identitydb.obj by going to:


    http://localhost:3852/plugin/plugins/
  2. Press your MENU mouse button and save the link as a file.

    If your browser does not support this save, access identitydb.obj in the directory: /opt/SUNWicg/SunScreen/admin/htdocs/plugin/plugins/.

  3. Copy the identitydb.obj file onto a diskette to distribute to all Administration Stations.

    If the identitydb.obj file already exists in its proper location, per the following:


    UNIX: $HOME 
    single-user Win95: C:\WINDOWS 
    multi-user Win95/98: C:\WINDOWS\PROFILES\username 
    WinNT: C:\WINNT\PROFILES\username 

  4. Add SunScreen as an accepted signer.

    1. If the identitydb.obj file does not exist, copy the file from the diskette to one of the above locations.

    2. You can also copy identitydb.obj from the diskette to its proper location.