Copyright: Copyright ©


Accessing the SETUPDOC Manual on CD-ROM

1.	From SETUPDOC's main window, choose Create Icon.

2.	Select the directory on the CD-ROM that contains a viewer and choose OK.

3.	Choose OK to create a Program Manager icon to access the viewer from the CD-ROM.

4.	Choose Exit, then Yes.

5.	Launch the DynaText viewer by double-clicking the icon.

6.	Look through the displayed collections for Installing and Using Novell Online Documentation, or a similarly titled publication, and select it.


Advanced Viewer Configuration

Configuration File Concepts

Configuring Viewers

Restricting User Access to Collections


Basic Concepts

Online Documentation Overview

Private and Shared Document Collections

Language Access Options

Shared Collection Lists

If You Have Novell ElectroText Online Documentation

If You Already Have Novell DynaText Online Documentation

Novell's Online Documentation Setup and Configuration Program

Installation Location Options


Basic Maintenance Tasks

Installing Additional Viewers

Installing Additional Collections

Deleting a Viewer

Deleting a Collection


Changing Viewer Access to Document Collections

The Configure Viewer box contains two collection lists. The upper list displays collections the viewer can access. The lower list displays collections the viewer cannot access.

1.	To make a collection available (or unavailable) move it from the upper (or lower) list by double-clicking on the collection name.

2.	When you finish making changes, choose Save.

See

Configuring Viewers


Changing a Viewer's Shared Collection List

The Advanced button on the Configure Viewer box enables you to view and change shared collection list access.

When you save changes, SETUPDOC modifies the SYSCONFIG line in the DYNATEXT.INI file (see Configuration File Concepts).

To specify a new or different Shared Collection List (SYSDOCS.CFG) file

1.	In the Configure Viewer box, select Advanced.

2.	To preserve current settings, select Cancel.

3.	If you don't want the viewer to access a Shared Collection List file, choose <none>; then choose Select.

4.	To create a new Shared Collection List file, choose <create>; then choose Select.

A <create> appears if you have Create [C] rights in a SYS:PUBLIC location of a server that doesn't contain a SYSDOCS.CFG file.

Only one SYSDOCS.CFG file can exist on each server. If one already exists on a server, the server's directories are not displayed.

4a.	Select the directory for the new list file; then choose Create.

4b.	Select the Shared Collection List file you just created; then choose Select.

Configure the empty Shared Collection list using the procedure under Changing Viewer Access to Document Collections.

5.	To access a different Shared Collection List, select a file; then choose Select.

6.	Choose Save to save changes.

See

Shared Collection Lists

Configuring Viewers

Configuration File Concepts


Collection Installation Fails

Collection installation failure may be caused by insufficient disk space.

To resolve the problem

1.	Make sufficient space available for the document collection (as much as 60 MB) on the disk or volume where you tried to install the collection, or install the collection on another disk or volume with sufficient available space.

2.	Install the collection.

See

Installing a Document Collection


Collection Language Access

To access a collection in a given language, you must first install a collection for that language.

A collection is accessed by a viewer when the viewer's configuration files contain a directory path (collection access path) pointing to the collection.

Collection access paths include either the language directory name exactly as it exists in the directory structure, or the NWLANGUAGE variable.

If the NWLANGUAGE variable is used, the variable must be set in the workstation's environment (memory).

Using the NWLANGUAGE variable is complex, but it allows a single directory path to point to different language versions of a given collection.

See

Configuring a Collection for Specific or Variable Language Access


Collection Languages

Novell online documentation is available in a number of different languages, depending on the Novell product.

To make documentation available in multiple languages, you must install a separate document collection for each language.

For example, to make the NetWare 4.1 documentation available in both French and Italian, you must install both French and Italian language versions of the NetWare 4.1 document collection.


Collection Should Be Shared

For a document collection to be shared, it must be referenced in a shared collection list file (SYSDOCS.CFG).

The viewer being configured does not currently reference a shared collection list file (SYSDOCS.CFG). To configure the collection as a shared collection, select a shared collection list file (SYSDOCS.CFG) for the viewer.

To select a shared collection list file (SYSDOCS.CFG), choose Shared.

To add the selected document collection as a private collection, choose Private.

To return to the Configure Viewer dialog box, choose Cancel.

See

Private and Shared Document Collections

Shared Collection Lists

Changing a Viewer's Shared Collection List


Configuration File Concepts

There are two types of DynaText configuration files: the viewer configuration file (DYNATEXT.INI for Windows 3.1x, Windows NT, and OS/2) and the shared collection list file (SYSDOCS.CFG). Information in these files determines which collections a DynaText viewer accesses.

The viewer determines which collections to access in the following manner.

1.	It accesses the viewer configuration file.

Two lines of text specify collection location: the Collection line and the SYSCONFIG line.

2.	Next it reads the Collection line, which specifies collection access paths to private collections.

A private collection can reside on a workstation or a server.

The collection access path of a collection on a workstation might be as follows: C:\DOC\ENGLISH\NW41;

The collection access path for a collection installed on a server might be as follows: \\SERVER1\VOL1\DOC\FRANCAIS\NW41.

3.	Next the viewer reads the SYSCONFIG line.

The SYSCONFIG line specifies the location of the SYSDOCS.CFG file, which contains lists of shared collections. Shared collections listed in SYSDOCS.CFG can be located on different servers. Each platform has a separate section.

A viewer can access only one SYSDOCS.CFG file at a time.

Below is an example SYSCONFIG line. The line reads:

SYSCONFIG=\\SERVER 1\SYS\PUBLIC\SYSDOCS.CFG

This line specifies the location of the SYSDOCS.CFG file as \\SERVER1\SYS\PUBLIC.

See

Configuring Viewers


Configure Viewer

You can configure a viewer in the following ways:

Changing Viewer Access to Document Collections

Configuring a Document Collection as Shared or Private

Configuring a Collection for Specific or Variable Language Access

Changing a Viewer's Shared Collection List


Configuring Viewers

A viewer's configuration determines the collections it accesses, the languages it accesses collections in, and whether it accesses a collection as a shared or a private collection.

To configure a viewer you must have the rights required in Rights Required.

To configure a viewer

1.	From SETUPDOC's main window, choose Configure Viewer in the Maintenance box.

2.	Select the directory containing the DynaText viewer, and choose Configure.

If you select a DynaText viewer that you can see but not configure, the Configure button changes to Information.

3.	Change viewer configuration by completing any of these tasks:

Changing Viewer Access to Document Collections

Configuring a Document Collection as Shared or Private

Configuring a Collection for Specific or Variable Language Access

Changing a Viewer's Shared Collection List

Choose Cancel at any time prior to saving to ignore changes and retain the viewer's original configuration.

4.	Choose Save to save changes.

See

Configuration File Concepts


Configuring a Collection for Specific or Variable Language Access

The Configure Viewer box contains two buttons in the Language box, Specific and Variable.

These buttons indicate whether the collection path in the configuration file (DYNATEXT.INI or SYSDOCS.CFG) contains a language name (ENGLISH, DEUTSCH, etc.) or the NWLANGUAGE variable. For more on configuration files, see Configuration File Concepts.

For more about specific and variable language access, see the topics below:

Specific Language Access

Variable Language Access

When to Use Variable Language Access

If You Change Language Access from Variable to Specific

If You Change Language Access from Specific to Variable

Variable Language Access Checklist

Setting Variable or Specific Language Access for a Document Collection

Setting a Workstation's NWLANGUAGE Variable


Configuring a Document Collection as Shared or Private

The Configure Viewer box contains two buttons, Shared and Private, located in the User Access box at the right of the upper list of collections.

These buttons indicate which configuration file (DYNATEXT.INI or SYSDOCS.CFG) contains the access path pointing to the collection. They have no impact on user access rights.

To make a document collection shared or private

1.	From the Configure Viewer box's upper list, select a collection to make shared or private.

2.	Select either Private or Shared.

If you can't select the Shared button, you don't have rights to modify the viewer's SYSDOCS.CFG file, or the viewer does not currently reference a SYSDOCS.CFG file. If you can't select the Private button, you don't have rights to modify the viewer's DYNATEXT.INI file.

3.	When you finish, choose Save to save your changes.

Viewers accessing the modified Shared Collection List file are affected by changes you make, so be sure all intended users have access rights to collections referenced in the Shared Collection List file.

See

Configuring Viewers

Private Collections

Shared Collections


Confirm Configuration Program Installation

Check whether the directory listed is where you want SETUPDOC installed.

If the destination directory is correct, choose OK to install SETUPDOC.

If the destination directory is incorrect, choose Cancel.


Confirm Document Collection Deletions

SETUPDOC displays the document collection deletion options you selected, including the source directory and document collections.

If the deletion information is correct, choose OK to delete the collections.

If the deletion information is incorrect, choose Cancel as many times as needed, and correct the information; then, proceed with the deletion.

See

Deleting a Collection


Confirm Document Collection Installation

SETUPDOC displays the document collection installation options you selected, including the source directory, destination directory, and document collections.

If the installation options are correct, choose OK to install the collection.

If the installation options are incorrect, choose Cancel as many times as needed, and correct the information; then, proceed with installation.

See

Installing a First Viewer and Collection

Installing Additional Collections


Confirm Icon Creation

SETUPDOC displays the viewer you have selected.

To create a Program Manager icon for this viewer, choose OK.

Otherwise, choose Cancel.


Confirm Viewer Deletions
Confirm Viewer Deletion

SETUPDOC displays the deletion options you selected.

If the deletion options are correct, choose OK to delete the viewer.

If the deletion options are incorrect, choose Cancel as many times as needed, and correct the information; then, proceed with deletion.

See

Deleting a Viewer


Confirm Viewer Installation

SETUPDOC displays the installation options you selected, including the source directory, destination directory, and viewer languages.

If the installation options are correct, choose OK to install the viewer.

If the installation options are incorrect, choose Cancel as many times as needed, and correct the information; then, proceed with installation.

See

Installing a First Viewer and Collection

Installing Additional Viewers


Confirm Viewer Language Deletions

SETUPDOC displays the deletion options you selected, including the viewer directory, viewer, and viewer languages.

If the displayed list is correct, choose OK to delete the viewer.

If the displayed list is incorrect, choose Cancel as many times as needed, and correct the information; then, proceed with the deletion again.


Contents

Installing a First Viewer and Collection

Copying SETUPDOC

Creating a Windows Icon for an Existing Viewer

Hardware and Software Requirements

Rights Required

Basic Concepts

Basic Maintenance Tasks

Advanced Viewer Configuration


Copying SETUPDOC

To copy SETUPDOC from the original installation medium to another directory

1.	Launch SETUPDOC from the original installation medium (CD-ROM or diskette).

2.	Choose Copy SETUPDOC in the Maintenance box.

3.	Select a destination directory for SETUPDOC.

If you are copying to the network, select SYS:PUBLIC (recommended) or another listed directory, or do the following:

3a.	Select <Select Different Location>.

3b.	Select a directory or type the destination path.

3c.	Choose OK to confirm.

4.	Choose OK to copy SETUPDOC.

5.	Choose OK.

SETUPDOC creates an icon and a program group named Novell Online Documentation (unless the program group already exists) in the Program Manager window. When copying is complete, SETUPDOC's main window reappears.


Create Shared Collection List

With SETUPDOC, you can create a shared collection list file (SYSDOCS.CFG) for your viewer to access.

Each shared collection list file (SYSDOCS.CFG) must reside on the SYS:PUBLIC directory of its own NetWare server.

To create a shared collection list

1.	Select the directory you in which want the new list.

2.	Choose Create.

See

Shared Collection Lists

Changing a Viewer's Shared Collection List


Creating a Windows Icon for an Existing Viewer

To create a Windows 3.1x icon on a workstation, move to that workstation and launch SETUPDOC. A Windows icon gives users of that workstation access to the document collections the particular viewer is configured to access.

Always use SETUPDOC to create viewer icons. Do not manually create an icon. See Viewer Displays Incorrect Collection Titles.

To create an icon for an installed viewer

 1.	From the SETUPDOC main window, choose the Create Icon button in the Maintenance box.

2.	Select the directory containing the viewer for which you want to create a Windows icon and choose OK.

3.	Choose OK twice: to confirm your selection, and to acknowledge icon creation.


DYNATEXT.INI

DYNATEXT.INI is the DynaText viewer configuration file.

It lists the private collections a viewer can access and which shared collection list file (SYSDOCS.CFG) it should reference to view shared collections.

See

Configuration File Concepts


DYNATEXT.INI WARNING!

SETUPDOC has detected an existing DynaText configuration file (DYNATEXT.INI) in your current Windows 3.1x directory.

The DynaText viewer may use the file in your current Windows 3.1x directory rather than the file you are modifying.

If the viewer doesn't display the document collections as you configure it, use SETUPDOC to create a Program Manager icon for the viewer you are currently modifying.

To continue modifying the DYNATEXT.INI file, choose Continue.

To cancel modifications, choose Cancel.

See

Configuration File Concepts

Configuring Viewers

Creating a Windows Icon for an Existing Viewer


Deleting a Collection

Before you delete a collection, be sure no one is using it and that you have rights to delete it. (See Rights Required.)

To delete a collection

1.	From SETUPDOC's main window, choose Delete in the Document Collections area.

2.	Select the directory containing the collections to delete, and choose OK.

3.	Select the collections to delete, and choose OK.

4.	If the correct collections are selected for deletion, choose OK. If incorrect collections are selected for deletion, backtrack by choosing Cancel as many times as needed, and correct the information; repeat the necessary steps.

A Notify message appears when the collections are deleted.

5.	Choose OK.


Deleting a Viewer

Before you attempt to delete a viewer, be sure no one is using it and that you have rights to delete it. (See Rights Required.)

To delete a viewer

1.	From SETUPDOC's main window, choose Delete in the DynaText Viewer area.

2.	Select the directory containing the viewer to delete, and choose OK.

3.	Select the viewer languages to delete, and choose OK.

4.	If the correct viewer is selected, choose OK. If an incorrect viewer is selected, backtrack by choosing Cancel as many times as needed, and correct the information; repeat the necessary steps.

A Notify message will confirm that deletion was successful.

5.	Choose OK.


Displaying Additional Information About a Document Collection

1.	Select the directory containing the collection, and choose the information button (the lower case "i").

2.	Select the document collection you want additional information about.

If a collection you don't want information about is selected, deselect it.

3.	Choose OK.

SETUPDOC displays information about the selected collection, including the manufacturer, product name, version, serial number, installation date, and platform.


Displaying Additional Information About a Viewer

1.	Select the directory that contains the viewer.

2.	Choose the information button (the lower case "i").

The information button is inactive if the directory you selected does not contain a viewer.

Viewer information includes the viewer's location, manufacturer, version number, platform, and other information.


Document Collection Information

The Document Collection Information message box displays the manufacturer, product name, version, serial number, installation date, and platform for the selected collection.

To return to the SETUPDOC main window, choose Close.


Document Collections

Document collections contain electronic versions of Novell product manuals.

See

Novell Online Documentation Components


Document Collections Options

Choose Install to install a document collection.

Choose Delete to delete an existing document collection.

Choose the information button (the lower case "i") to see a selected collection's manufacturer, product name, version number, installation date, and other information.

See

Novell Online Documentation Setup


DynaText Viewer

DynaText viewers allow you to look at the books in document collections. Viewers are available in various languages.


DynaText Viewer Options

Choose Install to install a viewer.

Choose Delete to delete an existing viewer.

Choose the information button (the lower case "i") to see the location, version number, platform, and other product information of a viewer you select.

See

Novell Online Documentation Setup


Example: If You Change Language Access from Specific to Variable

You installed English and German versions of the NetWare 4.1 collection, but have been accessing only the English collection using specific language access.

You decide you want some users to see only the English collection and other users to see only the German collection, so you choose the English collection and select the Variable button.

SETUPDOC moves the German collection to the upper collection list, indicating it is now available when the NWLANGUAGE variable is set to DEUTSCH.

When you choose Save, SETUPDOC will change the collection access path from

Collection=S1\VOL1:DOC\ENGLISH\NW41=NetWare 4.1;

to

Collection=S1\VOL1:DOC\$NWLANGUAGE\NW41=NetWare 4.1;

The viewer can now access either the English or German version of the NetWare 4.1 collection, depending on the NWLANGUAGE setting in the workstation's environment.

See

If You Change Language Access from Specific to Variable


Example: If You Change Language Access from Variable to Specific

You installed English and German versions of the NetWare 4.1 collection and have been using variable language access.

You decide to use specific language access for the English collection, so you select the English collection and choose the Specific button.

SETUPDOC moves the German collection to the Available Collection (lower) list. When you choose Save, SETUPDOC changes the collection access path in the affected configuration file from

Collection=S1\VOL1:DOC\$NWLANGUAGE\NW41=NetWare 4.1;

to

Collection=S1\VOL1:DOC\ENGLISH\NW41=NetWare 4.1;

The viewer no longer accesses the German NetWare 4.1 collection even though the collection is still installed. To have access to the German collection, you must move it back into the upper list and select Specific Language Access for it also.

The collection access path becomes

Collection=S1\VOL1:DOC\ENGLISH\NW41=NetWare 4.1;Collection=S1\VOL1:DOC\DEUTSCH\NW41=NetWare 4.1;

and the viewer can access both English and German versions of the NetWare 4.1 collection.

See

If You Change Language Access from Variable to Specific


Example: Specific Language Access

You install English and German versions of the NetWare 4.1 collection.

If you configure a viewer to access both collections with specific language access, the following collection access paths are written to one of the viewer's configuration files:

Collection=S1\VOL1:DOC\ENGLISH\NW41=NetWare 4.1;Collection=S1\VOL1:DOC\DEUTSCH\NW41=NetWare 4.1;

Viewer users can now access both English and German versions of the NetWare 4.1 documentation.

See

Specific Language Access


Example: Variable Language Access

You install English and German versions of the NetWare 4.1 collection.

If you configure the viewer to access the collections with variable language access, the following collection access path is written to one of the viewer's configuration files:

Collection=S1\VOL1:DOC\$NWLANGUAGE\NW41=NetWare 4.1;

For the viewer to access one of the collections, the NWLANGUAGE variable must be set in the workstation environment:

If NWLANGUAGE = ENGLISH, the user sees only the English NetWare 4.1 collection.

If NWLANGUAGE = DEUTSCH, the user sees only the German NetWare 4.1 collection.

If NWLANGUAGE is not set, the collection appears to be empty.

If NWLANGUAGE = FRANCAIS, the collection also appears to be empty because the French NetWare 4.1 documentation hasn't been installed.

You can configure a viewer to use specific language access for some collections and variable language access for other collections.

See

Variable Language Access


Example: Variable Language Access Checklist

You install English, German, and French language versions of the NetWare 4.1 collection, but only English and French versions of the NetWare 3.12 collection.

Users who have NWLANGUAGE set to DEUTSCH see an empty NetWare 3.12 collection.

See

Variable Language Access Checklist


Examples: Viewer and Collection on CD-ROM

This option may be appropriate for system administrators who access Novell online documentation only occasionally.


Examples: Viewer and Collection on a Server

Installing the viewer and document collection on a NetWare server will prove useful on a large network where several users have network management responsibilities that require access to the online documentation.


Examples: Viewer and Collection on a Workstation

Installing both the viewer and collection on a workstation may be useful in the following situations:

Only the system administrator needs access to the documentation.

In a small office, although multiple users need access to the online documentation, they will be able to share the single workstation on which it is installed.

The system administrator uses a portable computer for network maintenance (the online documentation is installed on the portable computer).


Examples: Viewer on a Workstation; Collection on CD-ROM

This option may be appropriate for system administrators who access Novell online documentation only occasionally.


Examples: Viewer on a Workstation; Collection on a Server

Installing the viewer on a workstation and the document collection on a NetWare server is helpful if you have multiple collections stored in multiple locations. You can configure the viewer on each workstation to access only the collections the user needs.


Hardware and Software Requirements

To install online documentation from a Windows 3.1x, Windows NT, or OS/2 workstation using SETUPDOC, you need:

A CD-ROM or diskettes containing Novell online documentation. (Use only diskettes that include SETUPDOC.)

A workstation running Windows 3.1x with a CD-ROM drive or a 3.5-inch diskette drive.

6 MB of free space on the hard disk or network volume where you install the viewer.

60 MB of free space on the hard disk or network volume where you install each collection.

See also

Rights Required


If You Already Have Novell DynaText Online Documentation

If you have a DynaText viewer version 2.2 or later, you do not have to reinstall the viewer; however, later versions usually provide enhanced features and performance.

If you install a new viewer, use SETUPDOC to install it and any additional collections.

See

Installing Additional Collections


If You Change Language Access from Specific to Variable

If you change the language access status of any collection from specific to variable, SETUPDOC moves all other language versions of the collection to the upper collection list.

All collections are now theoretically available, depending on the NWLANGUAGE variable setting in a given workstation's environment.

When you save your changes, SETUPDOC ensures that there is only one collection access path in the viewer's configuration files for that collection, and that $NWLANGUAGE appears in place of the language name within the path.

For an example, see Example: If You Change Language Access from Specific to Variable.

See also

Specific Language Access

Variable Language Access

When to Use Variable Language Access

If You Change Language Access from Variable to Specific

Variable Language Access Checklist

Setting Variable or Specific Language Access for a Document Collection

Setting a Workstation's NWLANGUAGE Variable


If You Change Language Access from Variable to Specific

If you change language access for a collection from variable to specific, SETUPDOC moves all other language versions of the given collection out of the list the viewer accesses.

The viewer will not access the collections unless they are put back into the upper list of the Configure Viewer box.

When you save your changes, SETUPDOC changes the appropriate collection access path, replacing the NWLANGUAGE variable with the language directory name.

For an example, see Example: If You Change Language Access from Variable to Specific.

See also

Specific Language Access

Variable Language Access

When to Use Variable Language Access

If You Change Language Access from Specific to Variable

Variable Language Access Checklist

Setting Variable or Specific Language Access for a Document Collection

Setting a Workstation's NWLANGUAGE Variable


If You Have Novell ElectroText Online Documentation

The ElectroText version of Novell online documentation is incompatible with DynaText 2.2 and later.

Although incompatible, DynaText and ElectroText can coexist; but if the ElectroText version is not used, remove the ElectroText directories and files.

Keep ElectroText documentation if it is your only source of information on products you are still using.

To determine if you have ElectroText or to remove ElectroText, see "ElectroText and Its Relationship to DynaText," Appendix C of the SETUPDOC manual (hard copy or on CD-ROM).

See

Accessing the SETUPDOC Manual on CD-ROM


Install Configuration Program Destination

SETUPDOC the SYS:PUBLIC directories in which you right to install. If you do not wish to install in one of these directories, an option to install in another location is provided.

To select the destination for SETUPDOC

1.	Select the directory in which you want to install SETUPDOC.

2.	If the directory is not listed, choose <Select Different Location>.

3.	Choose OK.

See

Copying SETUPDOC


Installation Location Options

There are two general considerations for deciding where to install online documentation components:

Available disk space

Collections require as much as 60 MB; viewers require as much as 6 MB.

Administrative burden

Maintenance is easier for one server installation than for multiple workstation installations.

Installation location options

Viewer and Collection on a Server

Viewer and Collection on a Workstation

Viewer on a Workstation; Collection on a Server

Viewer on a Workstation; Collection on a CD-ROM (Workstation or Server)

Viewer and Collection on CD-ROM (Workstation or Server)


Installing Additional Collections

You can install any number of collections and configure different viewers to access them.

Make sure you have the necessary rights (see Rights Required) and 60 MB of available space on the destination hard disk or volume.

To install each additional document collection

1.	From SETUPDOC's main window, in the Document Collections area, choose Install.

2.	Select a directory that contains the document collections to install, and choose OK.

If a collection is selected that you do not want to install, deselect it.

3.	Select a destination directory for the collections, and choose OK.

4.	Select the languages to install, and choose OK.

The Confirm Document Collection Installation box displays your selections.

5.	If the displayed list is correct, choose OK. If the displayed list is incorrect, backtrack by choosing Cancel as many times as needed, and correct the information; repeat the necessary steps.

6.	Choose OK.

If collection installation fails, see Collection Installation Fails.

See

Configuring Viewers


Installing Additional Viewers

You can install as many viewers on the network as needed.

Make sure you have the necessary rights (see Rights Required) and 6 MB of available space on the destination hard disk or volume.

To install each additional viewer

1.	From SETUPDOC's main window, in the DynaText Viewer area, choose Install.

2.	Select a viewer from the Select Viewer Source Directory box, and choose OK.

3.	Select a directory to install the viewer in, and choose OK.

4.	Select the languages to install, and choose OK.

The Confirm Viewer Installation box appears, showing the chosen installation source and destination directories, and the viewer languages.

5.	If the displayed list is correct, choose OK. If the displayed list is incorrect, backtrack by choosing Cancel as many times as needed, and correct the information; repeat the necessary steps.

6.	To create a viewer icon on this workstation, choose Yes. Otherwise, choose No.

7.	Choose OK.

If viewer installation fails, see Viewer Installation Fails.

You might install viewers on SERVER1 and SERVER2, configuring each viewer to access a different set of collections. Access to either one of the viewers, or to both, could be given.

(If you have multiple viewer icons installed on a workstation, consider renaming each icon after it is installed. For example, rename the viewer that accesses collections on drive C: to "DynaText Local C".)


Installing a Document Collection
Installing a First Document Collection

1.	From SETUPDOC's main window, choose Install in the Document Collections area.

2.	Select the directory that contains the document collections to install, and choose OK.

If a collection is selected that you do not want to install, deselect it.

3.	Select the destination directory for the collections, and choose OK.

4.	Select the languages to install, and choose OK.

The Confirm Document Collection Installation box appears, showing the chosen installation source directory, destination directory, and document languages.

5.	If the list is correct, choose OK to install the collection and continue with Step 7. If the list is not correct, continue with Step 6.

6.	If the list is not correct, choose Cancel as many times as necessary to return to the box that lets you change the incorrect selection; then repeat the necessary steps.

 If installation is not successful, see Collection Installation Fails.

7.	In the Notify box, choose OK.

The Success box appears, noting that you have just installed at least one viewer and one document collection.

8.	In the Success box, choose Exit.

9.	Choose Yes.

Upon exiting SETUPDOC, a new Windows 3.1x program group, titled Novell Online Documentation, appears. The new program group contains the DynaText for Windows icon.


Installing a First Viewer and Collection

Follow the steps below to install a viewer and collection.

To install a viewer for the first time

1.	From SETUPDOC's main window, choose Install in the DynaText Viewer area.

2.	Select the viewer shown in the Select Viewer Source Directory box, and choose OK.

3.	Select the directory to install the viewer in, and choose OK.

4.	Select the languages to install, and choose OK.

The Confirm Viewer Installation box appears, showing the chosen installation source directory, destination directory, and viewer languages.

5.	If the list is correct, choose OK to begin viewer installation; then continue with Step 7. If the list is not correct, continue with Step 6.

6.	If the list is not correct, choose Cancel as many times as necessary to return to the box that lets you change the incorrect selection; then repeat the necessary steps.

7.	Choose Yes to create a viewer icon on the workstation.

A Notify message informs you that viewer installation is successful. (If viewer installation fails, see Viewer Installation Fails.)

8.	Choose OK.

After SETUPDOC rescans and updates setup information, its main window reappears.

9.	Now install a collection according to Installing a Document Collection.


Language Access Options

Novell online documentation is available in various languages, depending on the Novell product.

See

Viewer Languages

Collection Language Access

Configuring a Collection for Specific or Variable Language Access


Loading CD-ROM Discs That Contain Document Collections

1.	Exit SETUPDOC by choosing Exit, then Yes.

2.	Insert the online documentation CD-ROM or diskette into your external workstation CD-ROM or diskette drive, respectively.

3.	Launch SETUPDOC on your workstation.

4.	At the Select Collection Source Directory step, select the drive letter corresponding to your CD-ROM drive (usually D:) or diskette drive (letters A: through C:).

See

Select Document Collection Source Directory


Local Document Collection on Network Viewer

If a viewer on a network is configured to access a document collection on a local hard disk, only the user at that workstation will see the collection.

Other network users see an empty collection unless the identical collection is installed on their individual workstation.

To add the document to the network viewer, choose Add.

To return to the Configure Viewer dialog box, choose Cancel.

See also

Private and Shared Document Collections


Maintenance Options

Choose Create Icon to create a Program Manager icon for an existing viewer.

Choose Configure Viewer to change which document collections the viewer accesses.

Choose Copy SETUPDOC to copy this installation program to another location.

See

Novell Online Documentation Setup


Need Shared Configuration

For a document collection to be accessed as shared, it must be referenced in a shared collection list file (SYSDOCS.CFG).

The viewer being configured does not currently reference a shared collection list file (SYSDOCS.CFG).

To select a shared collection list file (SYSDOCS.CFG), choose Continue.

To return to the Configure Viewer dialog box, choose Cancel.

See

Private and Shared Document Collections

Shared Collection Lists

Changing a Viewer's Shared Collection List


Novell Online Documentation Components

Novell online documentation has two components: the document collection and the DynaText viewer.

Document collections contain electronic versions of Novell product manuals. Many collections are available in multiple languages.

Collections can be accessed by any combination of DynaText viewers depending on how the viewers are configured.

DynaText viewers allow you to look at the books in document collections. Viewers are available in various languages.

See

Online Documentation Overview

Using Novell Online Documentation


Novell Online Documentation Setup
The following material applies to the Novell Online Documentation Setup dialog box. For more complete help with tasks and general program help, choose the Contents button.

Novell Online Documentation Setup

This is SETUPDOC's main window, presenting options for installing, deleting, and maintaining Novell online documentation.

These options are organized into three categories:

DynaText Viewer Options

Document Collections Options

Maintenance Options

After completing a procedure, you will return to this main window.


Novell's Online Documentation Setup and Configuration Program, SETUPDOC

SETUPDOC runs on Windows 3.1x, Windows NT, and OS/2 workstations.

Use SETUPDOC whenever possible to install and maintain Novell online documentation. You can use it even if you intend to access collections from Macintosh workstations.

It is easy to use, and it ensures installations that conform with Novell's standards.

With SETUPDOC you can

Install and delete document collections and DynaText viewers.

Easily configure viewers.

Create viewer icons at individual workstations.


Online Documentation Overview

Novell online documentation is an electronic copy of Novell product manuals.

When possible, use SETUPDOC to install and maintain online documentation components.

See

Novell Online Documentation Components

Using Novell Online Documentation


Overwrite Document Collections

A root directory can contain only one copy of each document collection.

If you attempt to install a collection in a directory in which an identical collection is already installed, SETUPDOC asks you if you want to overwrite the existing collection.

To overwrite the existing collection, choose Yes.

To avoid overwriting the existing collection and return to the previous dialog box, choose No.


Private Collection

A private collection is accessible to a single viewer. It is typically installed on a workstation's local hard disk with the viewer that accesses it.

See

Private and Shared Document Collections


Private Collections

A private collection is accessible to a single viewer, and is typically installed on a workstation's local hard disk with the viewer that accesses it.

A viewer accesses private collections by reading its configuration file, DYNATEXT.INI. Because viewers do not share configuration files, collections listed in a viewer's configuration file are private to a given viewer.

SETUPDOC configures collections installed on a local hard disk as private collections. Collections on a local hard disk cannot be configured as shared collections.

If a collection is to be accessed by more than one viewer, configure it as a shared collection to reduce administrative burden.

See

Shared Collections

Configuration File Concepts

Configuring a Document Collection as Shared or Private


Private and Shared Document Collections

Document collections can be designated as private or shared, depending on the configuration of viewers that access them.

See

Private Collections

Shared Collections

Configuration File Concepts

Configuring a Document Collection as Shared or Private


Restricting User Access to Collections

To restrict access to collections, you must first restrict user access to the viewer that will access the collections. Then configure that viewer to access the collections as private.

Restrict access to the viewer by installing it on a local hard disk or by limiting user access rights to the viewer directory on the network.

To further restrict access, you can also limit access rights to the \DOC directory where the collections are installed.

See

Configuring Viewers

Configuring a Document Collection as Shared or Private


Rights Required

To install online documentation on a NetWare server using SETUPDOC, you must log in as the user Supervisor or Admin, or have the following rights:

Read [R], Write [W], Create [C], Erase [E], Modify [M], File Scan [F], and Access Control [A] rights in the directory where you are installing a viewer or collection

Read [R], Write [W], Create [C], and Modify [M] rights in the SYS:PUBLIC directory on the server where the file SYSDOCS.CFG resides; or Read [R], Write [W], and Modify [M] rights to SYSDOCS.CFG

See also

Hardware and Software Requirements


Root Directory

The top-level directory on a local hard disk or network volume.


SETUPDOC

SETUPDOC is Novell's online documentation setup and configuration program. It currently runs on Windows 3.1x, Windows NT, and OS/2 workstations. Use SETUPDOC whenever possible to install and maintain Novell online documentation.

See

Novell's Online Documentation Setup and Configuration Program


SETUPDOC and Shared Collection Lists

You can use SETUPDOC to configure any available shared collection list.

SETUPDOC assumes any collection it installs on the network is a shared collection.

It creates or updates the appropriate shared collection list file automatically whenever collections are installed or deleted.

See

Shared Collection Lists


SYSDOCS.CFG

The shared collection list file (SYSDOCS.CFG) specifies the name and location of all shared collections a viewer can access. It is located in a SYS:PUBLIC directory on its own NetWare server.

See

Shared Collection Lists


Select Destination

From the directories shown, select the destination where you want to install SETUPDOC.

To select the SETUPDOC destination

1.	Select the directory where you want to install SETUPDOC.

2.	Choose OK.

See

Copying SETUPDOC


Select Document Collection Destination Directory

Document collections must be installed in a root directory.

If you are logged in to a NetWare network, SETUPDOC displays a list of both local and network root directories.

To select the document collection destination directory

1.	Select the directory in which you wish to install a document collection.

2.	Choose OK.

See

Displaying Additional Information About a Document Collection

Installation Location Options

Installing a First Viewer and Collection

Installing Additional Collections


Select Document Collection Directory

A list displays the directories containing document collections.

To select document collections to delete

1.	Select the directory containing the document collections you wish to delete.

2.	Choose OK.

See

Displaying Additional Information About a Document Collection

Deleting a Collection


Select Document Collection Directory_1
Select Document Collection Directory

A list displays the directories containing collections for which you may want additional information.

Additional information about collections includes manufacturer, product name, version, serial number, installation date, and platform.

To select a document collection directory

1.	Select the directory containing the document collection for which you want additional information.

2.	Choose OK.


Select Document Collection Source Directory

A list displays source directories containing document collections.

To select the document collection source directory

1.	Select the directory containing the document collection you wish to install.

2.	Choose OK.

If SETUPDOC displays no directories containing collections, install a collection from the CD-ROM or source diskettes.

See

Displaying Additional Information About a Document Collection

Loading CD-ROM Discs That Contain Collections

Installing a First Viewer and Collection

Installing Additional Collections


Select Document Collections to Delete

A list displays the collections in the selected directory.

To select document collections to delete

1.	Select the document collections you wish to delete.

If a document collection you do not wish to delete is selected, deselect it.

2.	Choose OK.

See

Deleting a Collection


Select Document Collections to Display

A list displays the collections in the directory you selected.

To select document collections to display

1.	Select the document collections you want additional information about.

If a collection you don't want additional information about is selected, deselect it.

2.	Choose OK.


Select Document Collections to Install

A list of available document collections is displayed.

To select the document collections

1.	Select the document collections you wish to install.

If a collection you do not wish to install is selected, deselect it.

2.	Choose OK.

See

Installing a First Viewer and Collection

Installing Additional Collections


Select Shared Configuration

A list displays the shared collection list files (SYSDOCS.CFG) that you can configure your viewer to access and an option not to access any shared collection list file.

If you have Create [C] rights in a SYS:PUBLIC directory of a server that doesn't contain a SYSDOCS.CFG file, the create option also appears.

When you save changes, SETUPDOC modifies the SYSCONFIG line in the DYNATEXT.INI file (see Configuration File Concepts).

To specify a new or different shared collection list (SYSDOCS.CFG) file

1.	To preserve current settings, select Cancel.

2.	If you don't want the viewer to access a Shared Collection List file, choose <none>; then choose Select.

3.	To create a new Shared Collection List file, choose <create>; then choose Select.

A <create> appears if you have Create [C] rights in a SYS:PUBLIC location of a server that doesn't contain a SYSDOCS.CFG file.

4a.	Select the directory for the new list file; then choose Create.

4b.	Select the Shared Collection List file you just created; then choose Select.

Configure the empty Shared Collection list using the procedure under Changing Viewer Access to Document Collections.

4.	To access a different Shared Collection List, select a file; then choose Select.

5.	Choose Save to save changes.

See

Shared Collection Lists

Configuring Viewers

Configuration File Concepts


Select Viewer

1.	Select the directory containing the viewer you wish to install or for which you wish to create an icon.

2.	Choose OK.

See

Displaying Additional Information About a Viewer

Creating a Windows Icon for an Existing Viewer

Installing a First Viewer and Collection

Installing Additional Viewers


Select Viewer Destination Directory

A viewer must be installed in a root directory.

If you are logged in to a NetWare network, the displayed list includes both local and network root directories in which you can install the viewer.

To select a destination directory

1.	Select the directory in which you wish to install the viewer.

If a root directory already contains a viewer, the viewer is listed with the directory.

2.	Choose OK.

See

Displaying Additional Information About a Viewer

Installation Location Options

Installing a First Viewer and Collection

Installing Additional Viewers


Select Viewer Languages to Delete

A list of languages that have been installed for the viewer is displayed.

You can delete one or more languages, or delete the entire viewer.

To delete particular languages

1.	Select each language you wish to delete.

If a language is selected that you do not wish to delete, deselect it.

2.	Choose OK.

To delete the entire viewer

1.	Select the Delete Entire Viewer check box.

2.	Choose OK.

See

Deleting a Viewer


Select Viewer Languages to Install

The language the viewer uses depends on two things:

Which viewer languages you install

The setting in the Program Manager's International Control Panel

To select viewer languages to install

1.	Select the languages to install from the list of available languages.

If a language you do not want is already selected, deselect it.

2.	Choose OK.

See

Installing a First Viewer and Collection

Installing Additional Viewers


Select Viewer to Delete

A list of viewers you can delete is displayed.

In this dialog box, you select the viewer. In the following dialog box, you will select which viewer languages to delete.

To select a viewer to delete

1.	Select the directory containing the viewer you wish to delete.

2.	Choose OK.

See

Displaying Additional Information About a Viewer

Deleting a Viewer


Select Viewer to Display

A list displays the viewers for which you may want additional information.

The information includes the viewer's location, manufacturer, version number, platform, and other product information.

To select a viewer

1.	Select the viewer for which you want additional information.

2.	Choose OK.


Select Viewer_1
Select Viewer

A list displays the viewers.

To select a viewer to configure

1.	Select the directory containing the viewer.

If you choose a viewer whose configuration you cannot change, the Configure button will change to Information.

2.	Choose Configure.

See

Configuring Viewers


Setting Variable or Specific Language Access for a Document Collection

Ensure you understand how the changes to language access will affect how viewers access document collections (see list of topics under "See also," below).

To set variable or specific language access for a document collection

1.	From the Configure Viewer box's upper list, select any language version of any collection.

2.	Select Specific or Variable.

3.	When you finish, choose Save to save your changes.

After SETUPDOC rescans and updates its setup information, its main window reappears.

4.	Ensure that the NWLANGUAGE variable is set for each affected workstation (see Setting a Workstation's NWLANGUAGE Variable).

See also

Specific Language Access

Variable Language Access

When to Use Variable Language Access

If You Change Language Access from Variable to Specific

If You Change Language Access from Specific to Variable

Variable Language Access Checklist

For other viewer configuration options, see

Configuring Viewers


Setting a Workstation's NWLANGUAGE Variable

If you use variable language access, set the NWLANGUAGE environment variable for each affected workstation (in the workstation's AUTOEXEC.BAT or STARTNET.BAT file).

Be sure to quit Windows, set the variable, then restart Windows. Environment changes made in a DOS box from within Windows 3.1x don't affect other programs running in Windows 3.1x.

The syntax is "SET NWLANGUAGE=language." Language is the language directory name in the collection's directory path. For example:

SET NWLANGUAGE=ESPANOL

This applies to Windows 3.1x, Windows NT, and OS/2 workstations. The Macintosh viewers contain a hard-coded NWLANGUAGE setting.

See

Variable Language Access

Configuring Viewers


Shared Collection

A shared collection is accessible to multiple viewers. It is placed on a NetWare server in a directory that many users have access rights to.

See

Private and Shared Document Collections


Shared Collection Lists

Shared collection lists provide a centralized list of collections available on the network. They can greatly decrease administrative burden.

DynaText viewers that are supplied by Novell support shared collection lists. DynaText viewers supplied by other vendors may not.

Shared collection lists are stored in a file named SYSDOCS.CFG. Each file contains lists for the various viewer platforms.

Each shared collection list must be located on the SYS volume in the PUBLIC directory on its own NetWare server.

See

SETUPDOC and Shared Collection Lists

Configuration File Concepts

Configuring a Document Collection as Shared or Private

Changing a Viewer's Shared Collection List


Shared Collections

A shared collection is accessible to multiple viewers. It is placed on a NetWare server in a directory where many users have access rights.

A viewer accesses shared collections by reading the shared collection list file, SYSDOCS.CFG, on a server.

SETUPDOC configures collections installed on the network as shared collections (if the installer has rights to modify the shared collection list file).

You can change the access status of network collections to private if you have rights to modify the viewer's DYNATEXT.INI file.

Caution:	Accessing a local collection from a network viewer allows only users who have the given collection installed on their local hard disks to see it.

See

Private Collections

Configuration File Concepts

Configuring a Document Collection as Shared or Private


Specific Language Access

Specific language access means that the collection access path in the configuration file contains a language directory name.

Users of the viewer being configured can view collections in whatever languages you install and provide access to. Multiple language versions of the same collection can be made available to a single viewer.

When a collection is installed, SETUPDOC uses specific language access in the collection access paths it creates.

For an example, see Example: Specific Language Access.

See also

Variable Language Access

When to Use Variable Language Access

If You Change Language Access from Variable to Specific

If You Change Language Access from Specific to Variable

Variable Language Access Checklist

Setting Variable or Specific Language Access for a Document Collection

Setting a Workstation's NWLANGUAGE Variable


Success

This message box only appears the first time you successfully install at least one document collection and at least one viewer consecutively.

To exit SETUPDOC, choose Exit, then Yes.

To return to SETUPDOC's main window, choose Continue.


Using Novell Online Documentation

Use Novell Online Documentation just as you use printed manuals:

Open a book and read it page by page.

Insert bookmarks.

Highlight text.

Jot down notes in the margin.

Use it to locate information in ways not possible with printed manuals:

Use search forms, Boolean operators, and other powerful search capabilities to locate information quickly.

Click on a cross-reference to access related information immediately.

Open multiple windows to view several books, even while running other applications.

See

Online Documentation Overview

Novell Online Documentation Components


Variable Language Access

Variable language access means that the collection access path in the configuration file contains the NWLANGUAGE variable rather than the language directory name.

Users of the viewer being configured can access only one of the installed language versions of a collection.

The language version users access depends on the language name assigned to the NWLANGUAGE variable in their workstation's environment.

For an example, see Example: Variable Language Access.

See also

Specific Language Access

When to Use Variable Language Access

If You Change Language Access from Variable to Specific

If You Change Language Access from Specific to Variable

Variable Language Access Checklist

Setting Variable or Specific Language Access for a Document Collection

Setting a Workstation's NWLANGUAGE Variable


Variable Language Access Checklist

If you decide to use variable language access, ensure that:

The NWLANGUAGE variable is set for each workstation accessing the collections (see Setting a Workstation's NWLANGUAGE Variable).

If you use variable language access and each workstation environment is not properly prepared, users see empty collections.

The same language versions are installed for each collection accessed through variable language access.

Note:	If you select variable access for a shared collection, you affect every viewer that uses the SYSDOCS.CFG file.

For an example, see Example: Variable Language Access Checklist.

See also

Specific Language Access

Variable Language Access

When to Use Variable Language Access

If You Change Language Access from Variable to Specific

If You Change Language Access from Specific to Variable

Setting Variable or Specific Language Access for a Document Collection

Setting a Workstation's NWLANGUAGE Variable


Viewer Displays Incorrect Collection Titles

To resolve the problem

1.	Delete the existing Program Manager icon.

2.	Create a new icon using SETUPDOC.

The viewer is accessing the wrong DYNATEXT.INI file.

Novell standards require that the .INI file be in the \DOCVIEW\DTAPPWIN directory, and that the command line contain the -ini.\DYNATEXT.INI parameter.

See

Creating a Windows Icon for an Existing Viewer


Viewer Information

This message box displays the manufacturer, product name, version number, serial number, installation date, and platform of the viewer you selected.

To return to SETUPDOC's main window, choose Close.


Viewer Installation Fails

Viewer installation failure may be caused by insufficient disk space.

To resolve the problem

1.	Make space available (as much as 6 MB) on the disk or volume where you tried to install the viewer, or install the viewer on another disk or volume with sufficient available space.

2.	Install the viewer.

See

Installing a First Viewer and Collection


Viewer Languages

To make the viewer available in a given language, you must install that viewer language and choose the appropriate setting in Program Manager's International Control Panel.

Windows 3.1x (including Windows NT and OS/2) allows a single DynaText viewer to be configured for each language you use. Macintosh requires a separate viewer for each language.


Viewer and Collection on CD-ROM (Workstation or Server)

This option is only for Windows 3.1x, Windows NT, and OS/2.

Advantages

Effective if users access online documentation only occasionally

Consumes no hard disk space; installation simple; little maintenance required

Disadvantages

It only accesses collections on CD-ROM.

Speed in loading the viewer and accessing collections depends on the CD-ROM drive.

Macintosh viewers are inaccessible (files are compressed).

See

Examples: Viewer and Collection on CD-ROM

Installation Location Options

Creating a Windows Icon for an Existing Viewer


Viewer and Collection on a Server

Advantages

All users with necessary rights can access online documentation.

All collections and viewers reside in one location for easy tracking.

Central management decreases administrative burden.

Centralized installation saves workstation disk space.

Disadvantages

If the server is unavailable, the documentation is inaccessible.

Users cannot customize the viewer.

See

Examples: Viewer and Collection on a Server

Installation Location Options

Installing a First Viewer and Collection


Viewer and Collection on a Workstation

Advantages

Fastest access for individual workstations

Especially effective for system administrators with portable computers

Access to online documentation even if the server is unavailable

Disadvantages

A collection is accessible only from the workstation it is installed on.

Having viewers and collections in multiple locations increases administrative burden.

See

Examples: Viewer and Collection on a Workstation

Installation Location Options

Installing a First Viewer and Collection


Viewer on a Workstation; Collection on CD-ROM (Workstation or Server)

Advantages

This is effective if online documentation is accessed only occasionally.

Minimal disk space is required (at the most, 6 MB per viewer).

If the CD-ROM is on a drive mounted as a NetWare volume, many users can access the collection.

Disadvantages

Access speed depends on the CD-ROM drive.

See

Examples: Viewer on a Workstation; Collection on CD-ROM

Installation Location Options

Installing a First Viewer and Collection


Viewer on a Workstation; Collection on a Server

Advantages

This is especially helpful if multiple collections are stored in multiple locations.

Each viewer is configurable to access only desired collections.

Users can configure the viewers to suit their needs.

Disadvantage

Multiple viewer installations increase administrative burden.

See

Examples: Viewer on a Workstation; Collection on a Server

Installation Location Options

Installing a First Viewer and Collection


When to Use Variable Language Access

Because variable language access requires additional system administration, use it only when both of the following conditions apply:

You installed multiple language versions of a collection.

You want users to view only one language version of that collection.

Otherwise, use specific language access.

See also

Specific Language Access

Variable Language Access

If You Change Language Access from Variable to Specific

If You Change Language Access from Specific to Variable

Variable Language Access Checklist

Setting Variable or Specific Language Access for a Document Collection

Setting a Workstation's NWLANGUAGE Variable