Novell Documentation: Novell Clients - Setting Up DOS-based ACU for DOS Login

Setting Up DOS-based ACU for DOS Login

If your users login to the network in DOS, and you want to use the DOS-based install utility (install.exe), complete the following steps.

In the sys:public directory, create a Client directory.

In the Client directory, create a Doswin32 directory, a Dos_acu directory, and a Log directory.

Copy the contents of the Products/Doswin32 directory from the Z.E.N.works^TM CD-ROM to the Sys:Public\Client\Doswin32 directory.

The Doswin32 directory is located in the Products directory.

Copy the contents of the Dos_acu directory from the Z.E.N.works CD-ROM to the Sys:Public\Client\Dos_acu directory.

The Dos_acu directory is located in the \Products\Adm32\Ibm_language subdirectory.

Review the DOS install.cfg file to make sure the parameters are correct for your network.

For information on setting parameters in install.cfg, see Modifying the Install.cfg File

Using a NetWare administration utility (such as NetWare Administrator), create a user group for the users you want to upgrade to the Novell Client.

Grant Create, Write, and Modify rights for the log directory to all users installing the new client software.

Open the system, container, or profile login script in the administration utility.

Insert commands to run nwdetect.exe, install.exe, nwstamp.exe, and nwlog.exe using IF...THEN...ELSE statements to handle exit codes.

Make sure to include a pound sign (#) before each command line in the login script.

For more information about setting up the login script, see Example DOS Login Script For DOS ACU

(Optional) Insert a command into the login script to run reboot.com to reboot the workstation.

Save the login script and exit the administration utility.

Nwdetect.exe Program

This program compares the version stamp and the client type on the client workstation with the version information listed on the nwdetect.exe command line.

Code	Description
0	The client software does not need to be updated.
1	The client software needs to be updated. Nwdetect.exe returns a 1 in any of the following circumstances: The Name= line in the Install Stamp section of the client's net.cfg does not match the [name] option on the command line. The major, minor, and revision versions in the Install Stamp section do not match the [version] option on the command line. The client type (VLM^TM, NETX, NIOS) does not match the [/T (client type)] option on the command line. An Install Stamp does not exist on the client workstation.

Code

Description

The client software does not need to be updated.

The client software needs to be updated.

Nwdetect.exe returns a 1 in any of the following circumstances:

The Name= line in the Install Stamp section of the client's net.cfg does not match the [name] option on the command line.

The major, minor, and revision versions in the Install Stamp section do not match the [version] option on the command line.

The client type (VLM^TM, NETX, NIOS) does not match the [/T (client type)] option on the command line.

An Install Stamp does not exist on the client workstation.

Nwdetect.exe uses the following syntax:

NWDETECT [options]

Option	Description
name	A string nwdetect.exe compares with the string listed on the Name = line.
version1	Specifies the major, minor, and revision version, in #.#.# format. Used with the version2 option, this number represents the starting version.
version2	Specifies the ending version in #.#.# format. You can use this parameter to test for a version range.
/T (client_type)	Detects the type of client loaded. Valid client types are NETX, VLM, and NIOS (Novell).
/P (prompt text)	Prompts the user if other options return as True. The user must answer the prompt with a Y or N. A Y returns an exit code of 0. An N returns an exit code of 1.
/C (path\filename)	Specifies the path and filename where nwdetect.exe reads the Install Stamp. Net.cfg is the default file if no file is specified.

For example,

nwdetect client_32 2.5.0 /c c:\novell\client32\net.cfg

detects if the workstation is running the current software and has an Install Stamp section in net.cfg that contains the following lines:

Name = Client_32

Major Version = 2

Minor Version = 5

Revision Version = 0

Nwstamp.exe Program

This program writes version information to the client workstation's net.cfg file (or the file you specify) in the Install Stamp section. This section contains four lines:

Name = name

Major Version = #

Minor Version = #

Revision Version = #

Nwdetect.exe, compares the four values listed in the Install Stamp section with those listed in the nwdetect.exe command line in the login script.

Nwstamp.exe uses the following syntax:

NWSTAMP name version [/B path\filename [/C path\filename]]

Parameter	Description
name	Specifies the word nwstamp.exe places on the Name= line. The name cannot contain spaces.
version	Specifies the major, minor, and revision versions nwstamp.exe uses to write version information. Specifies three values for the version, in #.#.# format. For example, nwstamp.exe writes 2.5.0 to the net.cfg as follows: Major Version = 2 Minor Version = 5 Revision Version = 0
[/B path\filename]	Backs up net.cfg using the path and filename specified.
[/C path\filename]	Specifies the path and name of the file you want to stamp.

For example,

nwstamp client_32 2.5.0 /c c:\novell\client32\net.cfg

puts an Install Stamp section in the net.cfg with the following lines:

Name = Client_32

Major Version = 2

Minor Version = 5

Revision Version = 0

Nwlog.exe Program

You can use nwlog.exe to record the results of the client upgrade. The program writes the following information to the file specified on the command line:

Date and time nwlog.exe ran on the workstation

Username of the user logged in to the network from the workstation

Network address of the workstation

Nwlog.exe uses the following syntax:

NWLOG [/F path\filename] [/M message] [/R]

Option	Description
[/F path\filename]	Path and filename to the log file where nwlog.exe writes the log entry.
[/M message]	Additional message to include in the log entry. The message must be in quotes. The total amount of alphanumeric characters allowed for the message and NWLOG command line syntax is 125.
[/R number_retries]	The number of times nwlog.exe tries to open the log file. The default number is 5.

For example,

nwlog /f \\server_1\sys\public\client\log\update.log

writes information to the update.log file on server_1:sys: public\client\log similar to the information on following line:

7-08-98 8:10:24 am USER_1 00000001:00000000001B

Reboot.com Program

This program reboots a client workstation.

Example DOS Login Script For DOS ACU

IF member of Accounting THEN
	MAP ROOT T:=SERVER1\SYS:PUBLIC\CLIENT
	WRITE Searching for client version information.
	#T:DOS_ACU\NWDETECT N_Client_32 2.5.0
	WRITE Detection completed.
	REM Run INSTALL if N_Client_32 version 2.5.0 is not on the computer
	IF ERROR_LEVEL = 1 THEN
		WRITE Updating Novell Client.
		#T:DOSWIN32\INSTALL
		IF ERROR_LEVEL = 0 THEN
			#T:DOS_ACU\NWSTAMP N_Client_32 2.5.0
			#T:DOS_ACU\NWLOG /f T:\LOG\UPDATE.LOG
			WRITE Update Completed - Press any key to reboot.
			PAUSE
			#T:DOS_ACU\REBOOT
		ELSE
			#T:NWLOG /F I:\LOG\FAILED.LOG
			WRITE Client upgrade failed. Contact the network administrator.
		END
	END
	MAP DEL T:
END