Version PK-2.20
(Aug 08, 1999)
DISCLAIMER: THIS PRODUCT IS SUPPLIED "AS IS". DREAMLAN DISCLAIMS ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THE WARRANTIES OF MERCHANTABILITY AND OF FITNESS FOR ANY PURPOSE. DREAMLAN ASSUMES NO LIABILITY FOR DAMAGES, DIRECT OR CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE OF THIS PRODUCT. |
Login scripts in NetWare 4 and NetWare 5 are stored as separate files in the hidden SYS:_NETWARE directory, as part of the NDS database files. Using a NetWare 4 or NetWare 5-aware backup system you can easily backup and restore all NDS information. However, it is often not easy to restore just the login scripts or a particular login script. This is where SCRIPT comes in.
SCRIPT is a pair of DOS command-line utilities (xSCRIPT and iSCRIPT) that can help you to backup and restore NDS login scripts. xSCRIPT allows you to extract any NDS (such as container or a user) login script and writes it to a text file. Later on, you can use iSCRIPT to import the text file back into NDS.
No special installation steps or program need to be used. Simply copy the iSCRIPT and xSCRIPT files to SYS:PUBLIC of your servers. You must have the unicode files for the country code and code page that your workstation use available in the respective NLS directories, for example, SYS:PUBLIC\NLS.
Should you install the SCRIPT utilities into a different directory, you may need a search path to the directory where the unicode files are located.
xSCRIPT
You can run xSCRIPT with the following command-line parameters:
xSCRIPT [-o objectname] [-v] [-f filename] [-q] [-c]
where
- -o specifies the name of the NDS object from which to extract the login script information. This name is an absolute pathname (i.e. always relative to [Root]). You can use typeless names.
- -v will display the login script to the screen, rather than writing to a text file. However, if -f is also specified, the file will be created. -q overrides -v.
- -f filename specifies the name of the text file to which the login script will be written to. The file is not overwritten or appended to if it exists. A filename of "/" has the same effect as using the -v option. If you specified the -v option on the command line but not -f, you will not be prompted for the filename. You can specify both -v and -f at the same time. This will cause the login script to be displayed on the screen and be written to the file.
- -q will suppress many informational messages. Good for batch file operation. Overrides the -v option.
- -c specifies continuous scroll on display. Otherwise, pause at the end of each displayed screen.
None of the above parameters are case sensitive.
For example, to extract the login script from the .OU=Testing.O=Earth container and store the script in a file called LOGIN.SCR, any one of the following xSCRIPT command syntax works:
xSCRIPT -o .testing.earth -f login.scr -q
xSCRIPT -o .ou=testing.o=earth -f login.scr -q
xSCRIPT -o testing.earth -f login.scr -qwill work just as well.
Special Switch for xSCRIPT
When an User, Organization, or Organizational Unit object is created, no stream files are created for the login script. However, when a Profile object is created, an empty stream file consisting of five (5) NULLs is created. If you edit (say) the User object's login script using NETADMIN, even if you leave it empty, a stream file is created, containing one (1) byte -- a NULL character. However, this does not happen with NWAdmin (the Windows utility). xSCRIPT tries to determine these situations in order to give an accurate error message, if encountered. However, Novell may change the rules at any time. Therefore, there is a -BYPASS command-line switch that you can use (not case sensitive), if you know there is a login script for an object, but xSCRIPT tells you otherwise.
iSCRIPT
You can run iSCRIPT with the following command-line parameters:
iSCRIPT [-o objectname] [-f filename] [-q] [-c] [-h]
where
- -o specifies the name of the NDS object whose login script will be replaced. This name is an absolute pathname (i.e. always relative to [Root]). You can use typeless names.
- -f filename specifies the name of the text file from which the login script will be read.
- -q will suppress many informational messages. Good for batch file operation.
- -c specifies continuous scroll on display. Otherwise, pause at the end of each displayed screen.
- -h suppresses header information of imported login script.
None of the above parameters are case sensitive.
For example, to import the login script in a file called LOGIN.CR into the .OU=Testing.O=Earth container, anyone of the following iSCRIPT command can be used:
iSCRIPT -o .testing.earth -f login.scr -q
iSCRIPT -o .ou=testing.o=earth -f login.scr -q
iSCRIPT -o testing.earth -f login.scr -qwill work just as well.
n/a
Two variations of SCRIPT are available. The version included here is a Freeware version. In the Freeware version of iSCRIPT, the -c and -q switches are disabled; the Freeware verison of xSCRIPT has the -bypass, -c, -f, -q, and -v switches disabled (i.e. the Freeware version will only display the login script on the screen).
You are granted an unlimited usage for the Freeware version at no cost. However, you are not allowed to sell or package this utility as part of another software package or service contract. Bottom line: you can not make money using this Freeware version. All standard Freeware limitation applies.
The full version of SCRIPT is available by registering on-line through the following Web sites:
The NDS tree name is required as it is used to generate a key. The registration cost is $50 US. Canadian registration is $70 CDN plus GST. All other countries, please remit in US funds.
You can also FAX a company Purchase Order to +1 (905) 887-3836. Please make sure you either include your tree name information on the FAX or send a follow up email.
Special site agreements for multiple trees and service providers are available. Although the license does not grant you the right to resell the program (for a profit; but you can charge the customer a service charge for your time). If you are a service provider, you can register copies on behave of your customers (by providing your customer's mailing information -- this is used only for tracking purposes). At the same time, we ask you to send us a separate email indicating that you are registering on behave of your customer and inciate in this email if further software upgrade (free or for a charge) be send to you or the customer directly, and an email address for that purpose.
iSCRIPT and xSCRIPT are written in C using Microsoft C optimizing compiler and Novell Developer Kit. Some string manipulating routines are from the CXL library.
Inclusion of this utility on CD-ROMs (except for backup purposes) without permission from DreamLAN Network Consulting Ltd. is expressly prohibited.