NJCLApplet Setup Information
-----------------------------------------------------------------------------

This information documents the process required to setup the NJCLApplet on
a webserver. This information can also be used to help ease the process of
setting up other applets as well.

The following sections are provided:
1. TO DO - On The Server (for the Web administrator)
2. TO DO - The Applet HTML File (for the Web administrator)
3. TO DO - On The Client (for the application user)
4. Trouble Shooting



1. TO DO - On The Server (for the Web administrator)
-----------------------------------------------------------------------------
Install NetWare 5.

Install LDAP server (for the LDAP provider).

Use NWAdmin to change LDAP Group setting to 'allow clear text passwords'
	(for the LDAP provider).

Install NetWare 5 Support Pak 1.

Install Novonyx Fasttrack Server for NetWare.

Create directory under SYS:Novonyx\suitespot\docs for your applet.
	map i:=\\myserver\sys\novonyx\suitespot\docs
	i:
	md njcl

Copy jars, class files, and html to the applet directory you created.
	map i:=\\myserver\sys\novonyx\suitespot\docs\njcl
	copy c:\novell\java\lib i:           (the standards JARs)
	copy demo.jar i:                     (the 1st applet JAR)
	copy plugins.jar i:                  (the 2nd applet JAR)



2. TO DO - The Applet HTML File (for the Web administrator)
-----------------------------------------------------------------------------
Create the applet's HTML file (possibly with a text editor).
	Specify the applet and archives.
	Specify the parameters (no file I/O and no System property access is
		allowed).
	- Initial context factory
	- Provider URL
	- Security information
	- Other parameters as needed

	For example:
		<HTML>
		<HEAD>
		<TITLE>NJCL Applet - (C) Copyright Novell, Inc.</TITLE>
		</HEAD>
		<BODY>
		<APPLET CODE="NJCLApplet.class" ARCHIVE="demo.jar,plugins.jar,njcl.jar,jndi.jar,swing.jar,jgl3.1.0.jar" WIDTH=600 HEIGHT=500>
		<PARAM name="java.naming.factory.initial" value="com.novell.service.ldap.LdapCtxFactory">
		<PARAM name="java.naming.provider.url" value="ldap://123.123.123.256/">
		<PARAM name="java.naming.security.authentication" value="simple">
		<PARAM name="plugins" value="AuthPopupHandler;DataPopupHandler;ServerPopupHandler;">
		</APPLET>
		</BODY>
		</HTML>

Install Java Plug-in HTML converter.

Run the java plugin HTML converter. This is installed somewhere in your
	Start menu. Note: do NOT change the generated HTML. Change the source
	HTML and run the converter again. There are too many oddities in the
	generated HTML.

Copy the converted HTML file to the webserver
	map i:=\\myserver\sys\novonyx\suitespot\docs\njcl
	copy ldap.html i:



3. TO DO - On The Client (for the application user)
-----------------------------------------------------------------------------
Install Netscape Communicator (Tested with version 4.5)

Load Netscape Communicator

Load the html file you created for the applet
	http://123.123.123.256/njcl/ldap.html

If the Java plugin is not available, the page will take the user to the
	proper page where the plugin can be downloaded. After installing the
	plugin, reload the webpage. Note: The NJCLApplet has been tested with
	JRE 1.1.7b, and JRE 1.2 plugins (it works better right now with 1.1.7b).

Have fun with the applet



4. Trouble Shooting
-----------------------------------------------------------------------------
Problem : I'm not seeing the applet. All I get is a message Applet not
	inited.

Solution: The Java plug-in has a console window that can show more details
	on why the applet may be failing to load. Somewhere in the start menu
	is the Java plugin control panel. Load it and set Show Java Console to
	on (in the Basic panel). If you need to debug or report an error, turn
	off the JIT (in the Advanced panel) so you can see/report the code line
	numbers. Note: the JRE 1.2 does a better job of reporting errors. You
	can force the applet to load with the JRE 1.2 by selecting it in the
	Advanced panel. When you run an applet, the Java console shows which
	JRE version is being used.


Problem : I'm not seeing new applet features, or a bug that has been fixed
	still fails on my machine.

Solution: The Browser (and Java plugin) use the classpath set in the client.
	If NJCL has been installed, the classpath usually points to some local
	copy of the JARs. These will be used before the network is used, thus
	changes made to the website will be unavailable until the local JARs are
	updated or removed. Note: the local JARs cannot be updated while they are
	open (i.e. the Applet is running).


Problem : I've updated the HTML file, but my changes don't seem to take
	affect.

Solution: As mentioned in the Applet HTML File section, changes to the
	converted file are not recommended. It is difficult to make the changes
	correctly. Instead, change the original file and run the HTML converter
	again. Also, if the backup file exists, the HTML converter will not
	convert the file and does not report an error. Be sure to delete the
	backup before running the HTML converter or specify another backup path.
