This section contains detailed information about the specific procedures required to complete various types of network server and Web server installations of the Novell Client. Because each of these procedures might apply to several installation types, each process is described separately. For more information on how to combine these procedures into a complete installation solution, see Section 4.2, Understanding Which Installation Process to Use.
On a NetWare server, log in to a server as Admin or as a user with Admin equivalence.
Make sure that you have rights to copy files to a network folder that all users can access, as well as rights to modify login scripts.
Create a folder in sys:public.
For example:
sys:\public\client
Copy the contents of the directory where you unzipped the download file to the folder.
See Section 2.4, Locating the Latest Client Software.
If you are installing the client in only one language or if your network does not have enough space to accommodate multiple language directories, you can delete the language directories that you do not need from the nls directory under each client directory. To ensure that you have all necessary files, copy the entire client directory and then delete only the extra language directories.
Create a Group object in the eDirectory™ tree.
Place into that group users whose workstations need to be installed or upgraded.
Make sure that the group has the Read and File Scan rights to the folder that you created.
If you created a folder in sys:public, the new folder should have Read and File Scan rights already associated with it, but you should make sure that these rights have not been changed.
(Conditional) If you want the results of the installation to be added to a status log file, make sure that the group has the Write right to that file and enable status logging in the acu.ini or cuagent.ini file (see Modifying the ACU Configuration File or see Creating the Configuration File (Unattend File)). If you did not create the status log file prior to running the network installation, you must give users the Create and Write rights to the directory.
A status log file records the success or failure of the installation. when each workstation completes its installation, the status log file is appended to include information on that workstation.
Complete any additional procedures outlined in the installation type you selected.
For more information on selecting the type of installation needed, see Section 4.2, Understanding Which Installation Process to Use.
Before you can distribute the Novell Client from a Web Server, you must first set up the installation directory on the Web server.
Create an installation directory on the HTTP Web server where you want users to install from.
Do one of the following:
Full Novell Client Installs or Upgrades: Copy the context of the directory where you unzipped the download file to this directory. For more information on locating the latest Novell Client software, see Section 2.4, Locating the Latest Client Software.
For Support Pack Installs: Create the following directory structure:
\sp
and place the Support Pack files in that sp directory.
The IP address specified in the WriteIP utility must be a location on a Web server that contains the Support Pack files. If the IP address specified in the WriteIP utility is a location on a Web server that contains both the client and the Support Pack files (in an overlay), both the client and Support Pack files are downloaded; however, only the Support Pack install launches. Creating a directory called sp and placing the Support Pack files in that sp directory avoids unnecessary download of Client files. The Web download utility downloads only the files in the sp directory and launches the Support Pack install.
You can copy the files to up to five different Web servers in order to provide access during peak times.
IMPORTANT:Ensure that you preserve the case, date, and time of the directories and files that are copied to the Web server. This is especially important on Web servers that are case sensitive, such as Linux servers.
Complete any additional procedures outlined in the installation type you selected.
You can install the Novell Client software from a Web server. Using the WRITEIP utility, you can create a small executable called setupip.exe that downloads the Novell Client install files from a Web server and launches the Novell Client install.
Run the writeip.exe utility located in the admin directory in the directory where you unzipped the download file.
For more information on downloading Novell Client, see Section 2.4, Locating the Latest Client Software.
Specify the IP address or DNS name of the Web server and the path to the client files.
You can specify up to five locations. Each location is checked in the order in which they are listed until a connection is made. If you select
, the order in which the locations are checked is selected randomly. This balances the load across the Web servers.For example:
http://111.111.11.1/client
or
http://mycompany.com/client
Specify download options, such as the location for downloading the client installation files.
Files can be downloaded to a temporary or specific directory.
If you select
, the user is prompted for the location of the download directory and can change the default location.If you do not select
, the Novell Client installation files remain on the workstation in the specified path or temporary directory.Specify client install launch options.
Support Pack Install: Only the Support Pack software is downloaded and installed, if needed. For specific information on setting up the directories correctly on the Web server, see Section 4.3.2, Setting Up the Novell Client Install on a Web Server.
Automatic Client Upgrade: The client install runs only if the client software is a later version than the one currently installed on the workstation. For more information, see Modifying the ACU Configuration File.
Unattend File: The installation reads the configuration file in order to configure the client properties. This file should be placed in the same folder as the installation utility. For more information, see Creating the Configuration File (Unattend File).
Click
.Setupip.exe is created. Writeip.ini, which stores the options you selected in writeip.exe, is also created.
Complete any additional procedures outlined in the installation type you selected.
For more information on selecting the type of installation needed, see Section 4.2, Understanding Which Installation Process to Use.
Distribute setupip.exe by placing it on a Web site, sending it through e-mail, or distributing it on a diskette.
When users double-click setupip.exe, the executable downloads the client install files from the specified IP address and launches the Novell Client installation.
setupip.exe determines what language version of the client to install based on the settings in the Regional and Language Options (Windows XP) or the Regional Options (Windows 2000) dialog box in the Control Panel. If the Novell Client supports the language, setupip.exe downloads the /NLS language files for that language. If the Novell Client does not support the language (that is, the /NLS files are not available for download), the copy fails with a message to contact the system administrator. If the language is not supported by the Novell Client, the English /NLS files must be available. For example, this means that you cannot use setupip.exe to force an English language version of the Novell Client onto a workstation with German regional settings.
IMPORTANT:This procedure is just one of the tasks required to complete installation of the Novell Client on multiple workstations. For more information on how this procedure combines with other procedures to create an install method, see Section 4.2, Understanding Which Installation Process to Use.
You can simplify future client software upgrades by enabling the Novell Client Update Agent. The Update Agent can be run manually at any time from the Red N menu or can be run automatically when users log in to the network.
If it is run automatically, the Update Agent determines if the preconfigured number of days have elapsed since the last upgrade check and then checks the specified location for a newer version of the client. If a newer version is found, the new install is launched. You can preconfigure the interval of days as well as the location of the newer client version.
IMPORTANT:Before workstations can check to see if updates are available, the Update Agent must be configured during a software installation or by using Automatic Client Upgrade (ACU). Or, you can configure the Update Agent on each machine locally through the Novell Client property pages. For more information, see Section 4.3.7, Enabling the Novell Client Update Agent.
Create a configuration (unattend) file by running the Novell Client Install Manager utility (nciman.exe).
Click
, then click the tab.(Optional) Select the
option and set the launch interval.Select the
option and specify the Update Location path (mapped drive, UNC path or URL).(Optional) Select the
option.This causes the previous install location to be used if the update location cannot be found. If the Update Agent should use only the previous install location, deselect the
option.(Conditional) If the user does not have the Administrator right on the workstation, select the
option.Novell Client must be installed by a user that has administrative rights on the workstation. If this option is selected, the Update Agent runs as a user with administrative rights and the installation is completed. If this option is not selected and the user does not have administrative rights, the Update Agent does not run and the user is notified that he or she does not have the correct rights.
To save the file in the correct location, complete the steps in Creating the Configuration File (Unattend File).
Complete any additional procedures outlined in the installation type you selected.
For more information on selecting the type of installation needed, see Section 4.2, Understanding Which Installation Process to Use.
Locate the cuagent.ini file in the admin directory.
Modify the cuagent.ini file settings, then save the file.
The cuagent.ini file enables you to configure the following settings:
Copy this file to the directory where you unzipped the download file.
Complete any additional procedures outlined in the installation type you selected.
For more information on selecting the type of installation needed, see Section 4.2, Understanding Which Installation Process to Use.
Select your type of the Novell Client installation.
You must select an install process that allows you to modify the client properties (meaning it cannot be a default install type, because the default installs do not modify any configuration files or settings).
For more information on selecting an installation type, see Section 4.2, Understanding Which Installation Process to Use.
During the installation process, create a custom configuration (unattend) file to modify the properties.
For more information, see Creating the Configuration File (Unattend File).
In the Novell Client Install Manager (nciman.exe), double-click , click the tab, then make the following changes:
Select
.(Optional) To launch the Update Agent automatically at a set interval, select
and then set the launch interval (in days).If the Update Agent is not set to launch automatically, users can still launch it from the Red N menu whenever an update needs to be run.
Specify an update source location.
You can select either a specific location on the network or the previous install location (if you intend to place updates in the same location as the last install). The Update Agent always looks in the specified location for new files.
Continue changing additional configuration settings to create your custom configuration (unattend) file, then click
.Complete any additional procedures outlined in the installation type you selected.
For more information on selecting the type of installation needed, see Section 4.2, Understanding Which Installation Process to Use.
Modify the acu.ini file so that the [UpdateAgentSettings] section of the .ini file is set to UPDATE=YES.
See Modifying the ACU Configuration File for more information.
Change the desired Update Agent settings in the [UpdateAgentSettings] section of the acu.ini file.
Run ACU through the login scripts.
The next time users log in, ACU runs and changes to the Update Agent settings are made. The Update Agent is configured and checks for updates as specified in the settings.
At the user's workstation, right-click the Red N icon in the notification area.
Click
.Click the
tab.Set the properties that you want to change.
HINT:Help for all the Property pages is available directly on the property pages by clicking the Question Mark (?) or right-clicking and then selecting What's This? Also, this information and additional information on other settings is available in the August 2004 AppNotes® article Novell Client 4.9 SP2: initialization, Login and Settings
.
Click
to make the changes and close the property pages.The Support Pack installs only a subset of client files and does not require a version change for the Client. Support Packs can also be added to the Client (in an overlay manner) to allow the installation of both the Client and the Support Pack in one step. Depending on the installation option you use to deploy Support Packs, the process differs slightly.
For example, if you choose one of the Web Server installation options, the IP address specified in the WriteIP utility must be a location on a Web server that contains the Support Pack files. If the IP address specified in the WriteIP utility is a location on a Web server that contains both the Client and the Support Pack files (in an overlay), both the client and Support Pack files are downloaded; however, only the Support Pack install launches. Creating a directory called sp in the directory where you unzipped the download file and placing the Support Pack files in that sp directory avoids unnecessary download of client files. The Web download utility downloads only the files in the sp directory and launches the Support Pack install.
In addition, Novell Client property page settings cannot be changed through the default Support Pack installation because only a subset of the Novell Client files are changed. If you need to install a Support Pack and update properties, you must either complete a full client installation that has the Support Pack files in an overlay or use the Update Agent to run both the Support Pack installation and update the Novell Client properties.
For more information on selecting an installation option, see Section 4.2, Understanding Which Installation Process to Use.
IMPORTANT:This procedure is just one of the tasks required to complete installation of the Novell Client on multiple workstations. For more information on how this procedure combines with other procedures to create an install method, see Section 4.2, Understanding Which Installation Process to Use.
The Automatic Client Upgrade utility (acu.exe) determines whether the client needs to be updated and lets you specify several installation options.
Open the acu.ini file located in the folder that you created on the server.
Modify the configuration options.
IMPORTANT:If you use a configuration (unattend) file to configure the Novell Client and you are using acu.exe, you must change the [UNATTENDFILE] option to Yes in the acu.ini file.
Complete any additional procedures outlined in the installation type you selected.
For more information on selecting the type of installation needed, see Section 4.2, Understanding Which Installation Process to Use.
IMPORTANT:This procedure is just one of the tasks required to complete installation of the Novell Client on multiple workstations. For more information on how this procedure combines with other procedures to create an install method, see Section 4.2, Understanding Which Installation Process to Use.
The Novell Client installation reads a configuration (unattend) file generated by the Novell Client Install Manager in order to customize the installation process and to configure the Novell Client settings.
Figure 4-9 Novell Client Install Manager
HINT:You can import the settings from a workstation that has been previously configured and save them to the configuration file. After you set up the workstation, click
to import the settings.The configuration (unattend) file created by the Novell Client Install Manager provides information such as property page settings and installation settings. This file should be placed in the same folder as the installation utility.
If you are installing the client with the default settings, you do not need to create or modify the configuration files. Skip this process and proceed to Section 5.0, Setting Client Properties.
Start Novell Client Install Manager (nciman.exe).
Novell Client Install Manager is located in the \admin folder in the directory that you copied to the server.
Modify the installation options as needed:
In the Configuration Options list box, double-click the installation option that you want to modify.
On the selected property page, set the parameters and then click
.The values that you set appear in the Novell Client Install Manager's right list box after you close the property page so that you can see a list of all parameters that have been modified.
Modify the Client Properties as needed.
For example, if your network uses LDAP, you can enable contextless login. Or, you might want to change the welcome screen bitmap.
For more information on the Client Properties, see Section 5.0, Setting Client Properties and Section 7.0, Managing Login. Or, right-click any property to view its help information.
Click
.You can use any filename (for example, unatt_xp.txt).
Copy this file to the directory where you unzipped the download file.
IMPORTANT:The path to the text file cannot contain long filenames.
Complete any additional procedures outlined in the installation type you selected.
For more information on selecting the type of installation needed, see Section 4.2, Understanding Which Installation Process to Use.
IMPORTANT:This procedure is just one of the tasks required to complete installation of the Novell Client on multiple workstations. For more information on how this procedure combines with other procedures to create an install method, see Section 4.2, Understanding Which Installation Process to Use.
The Novell Client Support Pack utility lets you control how Support Packs are pushed out to workstations by modifying the setupsp.inf file to define install custom settings.
Open the setupsp.ini file located in the folder that you created on the server.
Modify the Support Pack options section only.
IMPORTANT:Do not change the Client Version and Support Pack Version settings.
Complete any additional procedures outlined in the installation type you selected.
For more information on selecting the type of installation needed, see Section 4.2, Understanding Which Installation Process to Use.
After you have set up your network installation of the Novell Client, you must decide how to distribute the install files. You can modify the login script to launch installation files, distribute the files through ZENworks, or use another method you have available on your network.
For more information on using login scripts, see Distributing the Novell Client by Using Login Scripts. For more information on using ZENworks, see the documentation associated with the installed version of ZENworks.
IMPORTANT:This procedure is just one of the tasks required to complete installation of the Novell Client on multiple workstations. For more information on how this procedure combines with other procedures to create an install method, see Section 4.2, Understanding Which Installation Process to Use.
Keep in mind the following considerations as you work with login scripts:
You need to modify login scripts for users whose workstations are upgraded.
To upgrade workstations for users in a container, modify that container's login script.
To upgrade workstations for users in a profile, modify that profile's login script.
To upgrade specific users' workstations, modify those users' login scripts.
To upgrade a workstation running bindery-based client software (such as Microsoft Client for NetWare Networks which ships with Windows 95 or Windows 98), edit the system login script (sys:public\net$log.dat).
You can create or modify a user login script using either ConsoleOne® or iManager.
Click
.Specify a username and context, then click
.Click
.Type the login script commands and information in the login script text box.
For a sample of the login script commands that you need to add to the scripts, see Sample Client Installation Login Script.
IMPORTANT:Make sure that you edit the sample login script to match the server names, directory paths, and specifications of your own network.
For additional information on all login script commands, see the Novell Login Scripts Guide.
To save the login script, click
.Double-click the object whose login script you want to create or modify.
Click
.Type the login script commands and information into the login script text box.
For a sample of the login script commands that you need to add to the scripts, see Sample Client Installation Login Script.
IMPORTANT:Make sure that you edit the sample login script to match the server names, directory paths, and specifications of your own network.
For additional information on all login script commands, see the Novell Login Scripts Guide.
To save the login script and close the Details dialog box, click
.If the login script that you just created was a container or user login script, you're finished and the client software installs or updates the next time users log in.
If the login script that you just created was for a Profile object, you must associate the User object with the Profile object and make the User object a trustee of the Profile object. See Getting Around the One User and One Profile Login Script Restriction
in the Novell Login Scripts Guide.
The following sample shows the commands that you add to the login script in order to install the client software from the network. The sample includes text for installing across an internal network.
NOTE:In this sample, the text that is necessary to the script is represented in uppercase letters. The information that you should customize for your network is in lowercase letters.
REM ***** Windows 2000/XP ***** IF OS = “winnt” WRITE “Updating Novell Client for Windows 2000/XP.” #\\server1\sys\public\client\acu.exe IF “%ERROR_LEVEL” = “1” THEN EXIT END END