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:
Mapping UNIX users to NetWare userMounting NetWare or NetCon Servers
Maintaining DOS/Windows user passwords
Setting up the UNIX spooler to print to a NetWare print queue
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.
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.
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
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.
Example:
Example:
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.
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.
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.
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.
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)
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.
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
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 /
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.