iPlanet JSP Tag Extensions
iPlanet^TM Application Server Samples

The following samples provide an introduction to several ways in which the iPlanet Application Server JSP Tag Extensions can be used in JSP to enable quick access to information stored in database and LDAP-enable directory servers.

See the iPlanet Application Server Developer's Guide for more information on the iPlanet JSP Tag Extensions.

Before exercising these samples, read through the sample applications Getting Started document.

RDBMS Tag Extensions

1. Setup database table

First ensure that the database client libraries are registered with iPlanet.  See the iPlanet Administrator's Guide or the Bank and Pet Store samples for details.

Create a database user named "iastags" to own the RDBMS tables.

Go to the install_dir/ias/ias-samples/iastags/rdbms/src/schema/ directory.

Modify the setup_ora.sh or .bat file and set the iPlanet installation environment variable correctly.

Set ORACLE_HOME appropriately for your environment.

Execute the setup_ora.sh or .bat file to register the JDBC data source in the application server and to create and populate the database table.  For example:

./setup_ora.sh orcl iastags iastags

Execute iasdeploy to deploy the application:

iasdeploy deployapp iastags-rdbms.ear

a) Go to http://<hostname>/NASApp/iastags-rdbms/paramtag.jsp

b) Go to http://<hostname>/NASApp/iastags-rdbms/simple.jsp

If you encounter problems when running the application, review the General Troubleshooting section to learn how to view logs files.

LDAP JSP Tag Extensions

• Go to the install_dir/ias/ias-samples/iastags/ldap/src/schema/ directory.
• On UNIX, set LD_LIBRARY_PATH to include install_dir/ias/gxlib
• Edit the User.ldif file. Change all "iplanet.com" references to the domain name of your network as defined in the directory server.  For example, "yourcompany.com". If you encounter errors while adding the directory entries, you might have to specify three levels of the domain name depending on how your DNS domain name is configured.
• Run ldapmodify command against User.ldif file to add several users to the directory server:
 
install_dir/shared/bin/ldapmodify -D"cn=Directory Manager" -w <password> -a -f User.ldif

Where <password> is the 8 alphanumeric password specified during installation of iAS.

Use the -p option to specify a port other than the default port of 389.
 

• You should see several users added to the directory.  You can start the Netscape Console to verify that the users are actually in the directory server. For more details on importing information from LDIF files into the directory server, see the Java Pet Store application setup instructions.

Execute iasdeploy to deploy the application:

iasdeploy deployapp iastags-ldap.ear

• After registering the application, go to the install_dir/ias/APPS/iastags-ldap/iastags-ldap/ directory and edit the .jsp files. This is the location from which the application server runtime loads JSP files.
• Change the LDAP URLs in each of the JSP files to reflect the location and port number of your directory server.
• Alternatively, if you are familiar with the build scripts located under the ias-samples/iastags/ldap/src/ directory, you could modify the JSP files under the src/docroot/ directory, rebuild the EAR file and then redeploy the EAR file using the "build ear" and "build deploy" commands. When you reregister the updated EAR file, the JSP files are automatically extracted to the APPS/iastags-ldap/iastags-ldap/ directory).

a) Authentication Sample

• Go to http://<hostname>/NASApp/iastags-ldap/auth.jsp
• You will see the following message:



"For login, please specify 'Username'   and 'Password' parameters in the URL! "
 

• Now supply a user name and password from the User.ldif file in the URL string as follows:



http://<hostname>/NASApp/iastags-ldap/auth.jsp?Username=<username>&Password=<password>
 

• You will see either a login successful message or a login failed message.

•  Go to http://<hostname>/NASApp/iastags-ldap/showuser.jsp
• You will see the following message:



"For login, please specify 'Username'   and 'Password' parameters in the URL! "
 

• As in the previous example, supply a user name and password from the User.ldif file in the URL string as follows:

http://<hostname>/NASApp/iastags-ldap/showuser.jsp?Username=<username>&Password=<password>
 

• You will see either a login successful message and user information or a login failed message.

Copyright (c) 2001 Sun Microsystems, Inc. All rights reserved.