System Administrator's Guide

Overview

The administration of the NetCon software package is simple and is accomplished by using the "netcon" menu utility and other utilities. The basic administration tasks are:

Client Functions

Mapping UNIX users to NetWare user

Mounting NetWare or NetCon Servers

Maintaining DOS/Windows user passwords

Setting up the UNIX spooler to print to a NetWare print queue

Server Functions

Specifying volumes for NetWare Users

These tasks will be covered in detail below. Adding UNIX users and groups, and maintaining passwords and the UNIX file system are handled through normal UNIX System Administration facilities and are not covered in this section.

NOTE: All functions described in this document require you to be logged in as "root" on UNIX and "supervisor" on NetWare.

Administration Tasks

Mapping UNIX users and groups to NetWare users and groups

Introduction

In order for a Unix user to gain access to NetWare files and printers he must first login to that NetWare server. Since there is no direct correlation between Unix and NetWare users, a mapping table must be set up to tell NetCon what NetWare user name and password to use for each Unix user. Every time a Unix user attempts to access a NetWare resource (file, printer. etc..) NetCon uses this table to automatically create a connection to the NetWare server and login to that server with the mapped NetWare user name and password automatically.

Here's how it works ! During the installation process you were asked to run the "netcmount" command to mount a NetWare server volume as a Unix directory. Both the NetCon "netcmount" and "netcprint" commands will first connect to the local NetCon BINDERY and check for a mapped user entry for the server name you specified. If an entry is found for that NetWare server the program continues. If no entry is found you will be prompted for a valid NetWare user name and password. The NetWare user name and password that you enter must be valid for that NetWare server. NetCon uses this user name and password to set-up a default user and group mapping entry in the NetCon BINDERY for that NetWare server.

Example:

# netcmount nw312:sys:/ /mnt (Enter)

Enter user name for server NW312 : supervisor (Enter)

Enter the password for user supervisor on server NW312 : xx (Enter)

Re-enter supervisor password : xx (Enter)

NETCMOUNT NW312:SYS:/ /mnt

#

In the above example the Unix user root attempted to mount the SYS: volume of the NetWare server NW312 to the Unix directory /mnt. The netcmount command first checks the NetCon BINDERY for a MAPPED_USER entry for the server named NW312. Upon finding none the program then prompts the Unix user for a NetWare user name and password. The program continues by first adding a default user and group entry to the NetCon bindery, then updating the "netcpass" mapping daemon and mounting the requested volume. This example would produce the following entry in the NetCon Bindery for the NetWare Server NW312.

Example:

All subsequent uses of "netcmount" and "netcprint" commands on the NetWare server NW312 will use this default entry. You may add additional mapped users and groups and change these initial default entries with the NetCon Menu Utility "netcon". (See The "NetCon Menu Utility" and this Section of the Manual for Complete Details).

REMEMBER: A NetWare User can be mapped to many UNIX Users, but a UNIX User can only be mapped to one NetWare User.

Mapping NetWare Users to UNIX users.

1. Login to UNIX as "root".

2. Type "netcon" (Enter).

     NETCON 6.0     Mon Feb 27 14:46:45 1995
Connected To File Server NETCON
UNIX User root On Netcon Client NETCON



Mapped Users For Server NW312
 SUPERVISOR root user default
 EVERYONE daemon group default
3. A login screen will be presented if you have not already set the root password for this NetCon server, login to the NetCon server with UNIX user name "root" and password. (Passwords are not displayed). You will be presented with the "MAIN MENU".

5. Select "E. Map Users and Groups To Unix" from the "MAIN MENU" and press (Enter).

6. Then select the NetWare server name you wish to modify from the "Names of File Servers On File Server X" press (Enter). You should see a screen similar to the following with the default entries that were added the first time "netcmount" or "netcprint" was run.

Example:

     NETCON 6.0     Mon Feb 27 14:46:45 1995
Connected To File Server NETCON
UNIX User root On Netcon Client NETCON



Map NETWARE Network User/Group TO Unix
SUPERVISOR root user default
EVERYONE  daemon group default
     NETCON 6.0     Mon Feb 27 14:46:45 1995
Connected To File ServerNETCON
UNIX User root On Netcon Client NETCON



Map NETWARE  Network User/Group To Unix
 Network Server:      NETWARE
 UNIX User/Group Name:      root
 Network User/Group Equivalent :      SUPERVISOR
 Network User Password(groups="-"):      
 Is This A user, group or world:      user
 Make This Entry The Default:      Yes
 Update Configuration:      Yes

7. To MODIFY an existing entry; Select the user mapping entry you wish to modify from the "Mapped User For Server X".

To ADD a new entry ; Press (Ins, SCO) or (space bar, SUN). In either case you should see a screen similar to the following;

Example: Adding a default user:

8 Where:

NetWare Server: - Defaults to the Selected NetWare server. This field cannot be edited.

Unix User/Group Name: - Contains the Unix user name, can be any valid Unix user or group name. Default [root].

Network User/Group Equivalent: - This field should contain a valid NetWare user or group name. It can be any valid NetWare user or group name. Every time the Unix user/group in the previous field attempts to access the NetWare Server's files or printers he will be logged into the NetWare server as this user using the password contained in the next field. If this is a user entry the Unix user will inherit the rights of this NetWare user. If this is a group entry the Unix group in the previous field will inherit the rights of this NetWare group. Default [ROOT].

Network User Password: (groups = "-"): - This field should contain a valid NetWare password for the user name contained in the previous field. For groups this entry Defaults to "-". For users a valid password must be entered (Passwords will not display). Default [-].

Is This A user, group or world: - This field is used to indicate the type of entry this is. If the entry is used to map a Unix user to a NetWare user this field should contain "user". If this entry is used to map a Unix group to a NetWare group then this entry should contain "group". Default [user]. You can also add an optional entry for "world" that all other groups that are not mapped will default to. In the above example NetCon added a default user and a default group entry. Mapping the Unix user "root" to the NetWare User "SUPERVISOR" and the Unix Group "daemon" to the NetWare group "EVERYONE".

     NETCON 6.0     Mon Feb 27 14:46:45 1995
Connected To File Server NETCON
UNIX User root On Netcon Client NETCON



Map NW312 Network User/Group To UNIX
 Network Server:      NW312
 UNIX User/Group Name:      tony
 Network User/Group Equivalent :      tony
 Network User Password(groups="-"):      
 Is This A user, group or world:      user
 Make This Entry The Default:      No
 Update Configuration:      Yes
     NETCON 6.0     Mon Feb 27 14:46:45 1995
Connected To File Server NETCON
UNIX User root On Netcon Client NETCON



Mapped Users For Server NW312
SUPERVISOR   root user default
EVERYONE      daemon group default
TONY          tony  user
Is This Entry The Default (user/group): - Every NetWare server should have one and only one default entry for a user and one for a group. This is a yes/no field. Default [No]. In the above example NetCon automatically set up both the User and Group entries as default [Yes] user and group.
     NETCON 6.0     Mon Feb 27 14:46:45 1995
Connected To File Server NETCON
UNIX User root On Netcon Client NETCON



Map NETWARE Network User/Group To Unix
 Network Server:      NW312
 UNIX User/Group Name:      root
 Network User/Group Equivalent :      MIKE
 Network User Password(groups="-"):      
 Is This A user, group or world:      user
 Make This Entry The Default:      Yes
 Update Configuration:      Yes
     NETCON 6.0     Mon Feb 27 14:46:45 1995
Connected To File Server NETCON
UNIX User root On Netcon Client NETCON



Mapped Users For Server NW312
MIKE  root  user default
EVERYONE      daemon group default
TONY          tony  user
Update Configuration: - This causes the NetCon BINDERY to be updated with the information contained on this screen. Default [Yes]. Otherwise the screen is discarded if set to [No].
     NETCON 6.0     Mon Feb 27 14:46:45 1995
Connected To File Server NETCON
UNIX User root On Netcon Client NETCON



Map NW312 Network User/Group To UNIX
 Network Server:      NW312
 UNIX User/Group Name:      other
 Network User/Group Equivalent :      OTHER
 Network User Password(groups="-"):      
 Is This A user, group or world:      world
 Make This Entry The Default:      No
 Update Configuration:      Yes
     NETCON 6.0     Mon Feb 27 14:46:45 1995
Connected To File Server NETCON
UNIX User root On Netcon Client NETCON



Mapped Users For Server NW312
MIKE           root   user default
EVERYONE      daemon group default
TONY          tony  user
OTHER         other  world

Adding a new Entry to Map Unix User tony to NetWare user TONY

Example:

In this example the Unix user tony was mapped to the NetWare user tony as a regular user (not the default). The second screen shows the results of a successful entry.

Changing the Default user entry to map Unix user root to NetWare user MIKE.

Example:

Adding an optional world entry.

Example:

Mounting a NetWare Server

There are two ways to mount a NetWare server volume as a Unix directory with NetCon. The first is with the NetCon command "netcmount" the second way is with the NetCon Menu Utility. We will give you examples of both.

From the command Line:

Example:

# netcmount nw312:sys:/ /mnt (Enter)

With the NetCon Menu Utility

1. Login to UNIX as "root" type "netcon" and press (Enter) .

2. Login to the NetCon Server as "root" with the root password.

3. Select "C. Mount Network Server/Volume" from the "MAIN MENU".

4. Select the NetWare server you want to mount from the list provided and press (Enter).

5. Enter the volume you want to mount.

example: "sys" (Enter)

6. Enter the full path-name of the NetWare directory you want to mount.

example: / (Enter)

NOTE: Use the UNIX directory delimiters "/" not the DOS "\".

7. Enter the UNIX directory you want the NetWare volume and directory mounted on.

example: /mnt (Enter)

8. "Make Directory Read Only" This will prevent any change to the NetWare files or directories.
     NETCON 6.0     Mon Feb 27 14:46:45 1995
Connected To File Server NETCON
UNIX User root On NetCon Client NETCON



Mount File Server NETWARE  Volume As UNIX Directory
 Network Server To Mount     NETWARE
 Volume To Mount:      sys
 Directory To Mount:      /
 Enter UNIX directory:      /mnt
 Make Directory Read Only:      No
 Make This Entry Permanent:      Yes
 Update Configuration:      Yes
9. "Make This Entry Permanent" set to "Yes" will update the NetCon start-up script "/usr/bin/netcon.rc" so this directory will automatically mount every time the Unix machine restarts.

10. "Update Configuration" must be toggled to "Yes" for the directory to be mounted. If the mount is successful you will be returned to the "MAIN MENU" otherwise correct the entry and retry.

Example: A completed mount screen.

11. Select "D. Mounted Network Server/Volumes Information" from the "MAIN MENU" to check the newly mounted volume.

Changing DOS/Windows user Passwords on NetCon server

There are two way to change the DOS/Windows user passwords on the NetCon server. The first way is with the "netcpasswd" command the second way is with the NetCon Menu Utility "netcon". Here are examples of each method.

Example: command line

# netcpasswd tony (Enter)

Changing bindery password for user TONY

Enter NEW password: xxxx (Enter)

Re-enter NEW Password: xxxx (Enter)

#

Example: netcon menu utility

# netcon (Enter)

Select "G. User Information", you will be presented with a list of users, select the user you want to change and press (Enter). Select "A. Change Password". Enter the Old Password and press (Enter). Enter the New password and press (Enter) . Then re-type the New Password and press (Enter). Press (Esc) to exit.

Changing Mapped NetWare user Passwords on NetCon Server

There are two ways to change Mapped NetWare user passwords on the NetCon server. The first way is with the "netcpasswd" command the second way is with the NetCon Menu Utility "netcon". Here are examples of each method.

Example: command line

# netcpasswd nw312 tony (Enter)

Changing mapped NETWORK password for

NETWORK user: TONY

on NETWORK server: NW312

mapped to Unix user: tony

Enter NEW network user TONY password: xxxx (Enter)

Re-enter NEW network user TONY Password: xxxx (Enter)

#

Example: netcon menu utility

# netcon (Enter)

Select "E. Map Users and Groups to Unix" from the "MAIN MENU" and press (Enter). Then select the name of the NetWare server from the list provided in "Names of File Servers On File Server X" and press (Enter). Then select the user from the list provided in "Mapped Users for Server X" and press (Enter). Then press (Enter) until the cursor is on the "Network User Password:" line. Enter the NEW password and press (Enter) until you return to the previous screen, then press (Esc) to exit netcon.

Printing From UNIX to NetWare

The NetCon software contains a NetWare print utility called "/usr/bin/netcprint". This utility will allow you to print to any NetWare server that has a print server and a print queue functioning. The user you are logged in to the NetWare server as, can have a NetWare default print job configuration.

Using netcprint from UNIX to a NetWare Server

To print the UNIX text file "print.txt" to the NetWare Server "NW312" print queue "printer2" type:

Example:

# /usr/bin/netcprint -s nw312 -q printer2 print.txt (Enter)

Setting Up a UNIX Spooler to print to a NetWare or NetCon Server

In order to use the standard UNIX print spooler to print to the network we must first configure the spooler to call the "/usr/bin/netcprint" utility so the print request will be sent to the NetWare Server; this is accomplished as follows:

execute the shell script "/usr/lib/netcon/ncpr" and answer the prompts.

Example;

/usr/lib/netcon/ncpr (Enter)

NetCon 6.0 lp setup for Network Printers ----------------------------------------

Enter New printer Name: nwprinter(Enter)

Enter Network Server Name: nw312 (Enter)

Enter Network Print Queue: printer2 (Enter)

Is the Above Information CORRECT(y/n/q): y (Enter)

Note: If you do not know the name of your NetWare or NetCon print queues or servers use the "netcon" menu utility, select "J. Network Information", "A. Server Information" and "F Print Queue Information" to get the names of all the servers and queues.

This will setup the UNIX lp spooler named "nwprinter" to print to the NetWare server "NetWare" queue "queue1". To now use this printer from UNIX.

Type.

lp -d nwprinter /usr/test/printfile (Enter)

SCO UNIX/ODT, SOLARIS

The "/usr/lib/netcon/ncpr" script sets up and enables a new UNIX spooler using "lpadmin" the print spooler model is "NC". The new interface file is "/usr/spool/lp/admins/lp/interfaces/nwprinter"on SCO. On SOLARIS the interface file is "/etc/lp/interfaces/nwprinter" is edited to add the proper server name and queue name for the "/usr/bin/netcprint" command.

Sun OS

On SUN systems the "ncpr" script adds an entry to "/etc/printcap" for the printer and copies "/usr/lib/netcon/printd.sun" to "/usr/lib/netcon/server_name.queue.name" then edits this file to add the proper "$NETCPRINT="/usr/bin/netcprint -s server_name -q queue_name" line.

Adding DOS Line Feed + Carriage Return To Unix Documents

SCO UNIX/ODT

Edit the interface file for the print spooler you would like to add lf=cr+lf mapping to. The interface files are located in "/usr/spool/lp/admins/lp/interfaces" directory. Remove the comment from the line starting with "#/usr/bin/xtod" and comment out the line starting with "$NETCPRINT:.

Example:

/usr/bin/xtod $files | $NETCPRINT $nopts 2>&1

#$NETCPRINT $nopts $files 2>&1

Solaris

Edit the interface file for the print spooler you would like to add lf=cr+lf mapping to. The interface files are located in "/etc/lp/interfaces" directory. Remove the comment from the line starting with "#/usr/bin/unix2dos" and comment out the line starting with "$NETCPRINT:.

Example:

/usr/bin/unix2dos $files | $NETCPRINT $nopts 2>&1

#$NETCPRINT $nopts $files 2>&1

Server Administration Functions

The NetCon server auto-configures during start-up. There are no user configuration parameters except to specify the volumes to be exported to the DOS NetWare users and other NetCon servers.

The default configuration of the "/usr/lib/netcon/netcexport" file after the installation is:

NETCON_VOLUME SYS /usr/sys NETCON_VOLUME vo11 /usr NETCON_VOLUME vo12 /

Specifying Volumes for NetWare Users

You may at any time add volumes to be used by NetWare Clients. Just edit the configuration file and restart the server or reboot the system. To add the UNIX directory "/usr/sys/public" as volume "PUBLIC". Simply, add this line:

"NETCON_VOLUME PUBLIC /usr/sys/public"

to the "/usr/lib/netcon/netcexport" file. Restart the server with the "netcrestart" utility.