1.1 Installation Notes

This release of Novell^® Script for NetWare^® (NSN) may not work with the earlier versions of Universal Component System (UCS^TM). To resolve this, install the UCS binaries available with the February 2002 NDK release or later.

1.2 Testing Your Setup

To start the interactive shell for script execution, enter the following commands at the server console:

nsninit

nsnshell

Enter the following command in the NSN shell:

dir

The directory listing of the sys volume is displayed.

To terminate the interactive shell, enter exit in the shell.

1.3 Sample Web Scripts

Sample Web scripts are located under the directory, sys:\nsn\webdemo. To test these samples, copy them to sys:/nsn/web directory.

We suggest to remove these sample scripts from a production server.

1.4 Configuring the Enterprise Web Server

To enable NSN support for the NetWare Enterprise Web Server, connect to the administration server using your browser. The URL should be given in the following format:

http://server:adminport

Click the server you want to administer, then click Programs. If the CGI directory is not highlighted complete the following procedure:

1. Select the CGI directory, enter the following information and click OK.

   For NSN:

   URL Prefix: nsn

   CGI Directory: /nsn/lcgi/cgi2ucs.nlm

   For Novell Script Pages:

   URL Prefix: sp

   CGI Directory: /nsn/lcgi/scrptpgs.nlm

2. Click Save and Apply.

3. To test the Web server configuration, enter the URL in the following format:

   http://server_name/nsn/env.bas

   This will execute the script env.bas and display the Web server environment variables.

   By default, the following URL prefixes are available:

   • Novell Script for NetWare - nsn
   • Novell Script Pages - nsp or sp

1.5 Configuring the Apache Web Server

LoadModule lcgi_module modules/mod_lcgi.nlm 
 
<IfModule mod_lcgi.c> 
  AddHandler lcgi-script nlm .pl .asp .nsp .bas 
  LCGIModuleMap sys:\nsn\lcgi\scrptpgs.nlm .asp .nsp /sp 
  LCGIModuleMap sys:\nsn\lcgi\cgi2ucs.nlm .bas /nsn 
 
  ScriptAlias /nsn sys:/nsn/web 
</IfModule>

2.1 Viewable and Downloadable Documentation

The documentation for NSN can be downloaded or viewed at the NDK documentation site.

We've enabled Start menu documentation entries. After installing the documentation, use the NDK Documents entry on your Start menu to quickly locate and access NDK documentation.

To read or print the documentation, you need Adobe Acrobat Reader 4.0 or later. For a free download, see the Adobe site.

When you download the documentation, the following four books are downloaded to the install_location\doc\nscript directory:

• Introduction to Novell Script for NetWare (nsc1_enu.pdf) provides overview about NSN and references to all supported UCX components
• NSN Components - Part One (A-L) (nsc2_enu.pdf) provides details of components (A-L)
• NSN Components - Part Two (M-Z) (nsc3_enu.pdf) provides details of components (M-Z)
• UCX SDK Components (nsc4_enu) provides details about UCX APIs

The documentation for Universal Component System can be downloaded or viewed at NDK documentation site.

2.2 News Groups

The following news groups are available for discussions in Novell Developer Forums

• NSN Group: novell.devsup.nscript

• UCS Group: novell.devsup.ucs

3.1 Enhancement to the Server UCX component

This enhancement will help users to retrieve IPAddresses of the NetWare server.

Server.IPAddresses returns collection of IPAddress objects.

Address property of IPAddress object will return IP Address of the server.

3.2 Archive

To see changes in the software, sample code, and documentation for previous releases, see the What's New Archive.

4.1 FTP Functionality Issue

Scripts using FTP functionality will not get executed from NetWare 5.1 SP7 server.

4.2 Executing Sample Scripts with Colon(:) in the URL

The sample scripts (*.bas) containing colon (:) will not be executed properly in Apache 1.3. To execute these scripts ":" should be removed.

4.3 MySQL Parameter Object

The date data type for the MySQL parameter object is not supported in this release.