# 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.

``