Installation Guide FreeBSD 2, BSDI 2.1

Installing NetCon FreeBSD 2.X, BSDI 2.1

Note: If NetCon is already installed see the section "Removing NetCon" later in this manual to completely remove NetCon before installing a NEW version.

1. Login as root. Verify that the "/usr" directory is accessible and that the network adapter is installed with TCP/IP and both are fully operational.

2. Copy or download the distribution file bsd61.tgz or bsdi61.tar to temporary directory or change directory to the CDROM or other location containing the distribution file.

FreeBSD

# pkg_add bsd61.tgz (Return)

BSDI 2.1

# cd /

# tar xvf /tmp/bsdi61.tar

# /tmp/ncinstall

The "/tmp/ncinstall" script calls "installsw" which will display the installation progress and the Following dialog.

Installing NetCon 6.1 Client and Server for BSDI... (package 1 of 1).........
Uncompressing files...
Updating System  files...
Backing up kernel and boot files...
Is this a STANDALONE NetCon server (No other NetWare Servers on NetWork)
[Y/N] Default [N]: 

If this is the only NetWare server on the network enter Y otherwise N.

The following is only displayed if you DO NOT have a standalone system. This information is used as an example of how to auto-mount the NetWare server during boot. It is also used to obtain access control information such as group membership.

Enter NetWare Server's Name (IN CAPS):

NW312

Enter the name of the NetWare server you wish to mount.

Enter NetWare Server's Volume to mount[SYS] (IN CAPS):

SYS

Enter the Volume on the NetWare server you wish to mount.

Enter NetWare Server's Directory to mount[/]:

/

Enter The NetWare server's subdirectory to mount.

Enter Unix Directory to mount NetWare[/netware]: 

/netware

Enter the Unix driectory mount point.

Enter NetWare Server's Supervisor Password(IN CAPS):

Enter the NetWare Server's Supervisor Password of the example mount.

 
extracting NetCon6.1 man pages....
extracting NetCon6.1winsock.dll and Applications....

If this is a BINARY version of BSDI (no source code) then a new kernel and boot file will be copied to the root directory ("/bsd and /boot) the original file will be backed up to "/bsd.org" and "/boot.org". If source code is included you will be prompted to rebuild the kernel.

Enter the of the Kernel configuration to use as a model to build a new NetCon Kernel;[GENERIC]
GENERIC

If you have created a custom configuration file for the bsdi kernel enter the name of that file othewise use the default [GENERIC]

Do you want to rebuild and install a kernel now? (y/n);[y]
y

You Must rebuild the Kernel to make NetCon operational.

Before the NetCon software can become operational you MUST;.
1) Reboot the system and brand the software with netcbrand.
2) Reboot the system again after branding the software.
Installation complete, Thank you for using NetCon!

All packages were installed successfully.

FreeBSD

The "pkg_add" utility will display the Following dialog.

Uncompressing files...
Updating System  files...

Is this the First and Only NetWare server on your NetWork

(*) N No there are other Novell NetWare servers on my network.

() Y Yes this is the First and only NetWare server on my network.

If this is the only NetWare server on the network enter Y otherwise N.

The following is only displayed if you DO NOT have a standalone system. This information is used as an example of how to auto-mount the NetWare server during boot.

Enter NetWare Server's Name (IN CAPS):

NW312

Enter the name of the NetWare server you wish to mount.

Enter NetWare Server's Volume to mount[SYS] (IN CAPS):

SYS

Enter the Volume on the NetWare server you wish to mount.

Enter NetWare Server's Directory to mount[/]:

/

Enter The NetWare server's subdirectory to mount.

Enter Unix Directory to mount NetWare[/netware]: 

/netware

Enter the Unix driectory mount point.

Enter NetWare Server's Supervisor Password(IN CAPS):

Enter the NetWare Server's Supervisor Password of the example mount.

Enter the Kernel configuration to use as a model to build a new NetCon Kernel
[GENERIC]

If you have a custom kernel configuration file enter that name otherwise use [GENERIC]

Do you want to rebuild and install a NEW NETCON kernel now? (y/n)

y

You Must rebuild the Kernel to make NetCon operational.

Before the NetCon software can become operational you MUST;.
1) Reboot the system and brand the software with netcbrand.
2) Reboot the system again after branding the software.
Installation complete, Thank you for using NetCon!


 
                      RESTRICTED RIGHTS LEGEND                         
                                                                    
  Use,  duplication, or disclosure by the Government is subject  to   restrictions as set forth in subdivision (b)(3)(ii) of the Rights  in Technical Data and Computer Software clause at 252.227-7013.    
        Copyright (c) 1986, 1997 NetCon Corporation                                            NetCon Corporation                                                           
          605 North Lake Circle                                                                          Crystal River, Florida 34429                              

All rights reserved. This product and related documentation is protected by copyright and/or U.S. Patents issued and pending and is distributed under licenses restricting its use, copying, distribution and decompliation.

3. Reboot the system to start NetCon.

# reboot

4. After the reboot you should see the following display before or right after the login: prompt:

New IPX Address: ed1 AF=6 <net:XXXXXXXX, host:XX-XX-XX-XX-XX-XX, port:0>

Verify that the "net" matches the network address of your Netware Server. If this is a stand-alone system with no other NetWare server the Net address will be "1".

Make a note of the "host:" and use it to obtain your activation key from your NetCon supplier or NetCon web site "www.netcon.com". Once you have obtained your Activation Key, login as "root" and use;

# netcbrand Activation_Key (Return)

to brand the programs. To verify that netcbrand has properly branded all the NetCon software packages type the following;

# netcbrand (Return)

You should see the following display; The number of connections and the branding of "nclogin.exe" will depend on the type of license you have obtained.

netcvt: SkAKIWgmKNDFGNDN (SCV active). 255 conns. Perm. L=Y

Address verified.

netcserv: SkAKIWgmKNDFGNDN (SCV active). 255 conns. Perm. L=Y

Address verified.

netcpass: SkAKIWgmKNDFGNDN (SCV active). 255 conns. Perm. L=Y

Address verified.

netcmount: SkAKIWgmKNDFGNDN (SCV active). 255 conns. Perm. L=Y

Address verified.

nclogin.exe: verified.

and reboot. After the second reboot NetCon should be fully operational. If this is a standalone system with no other NetWare or NetCon servers on the network the installation is now complete.

If you have other NetWare or NetCon servers on the network go to "Completing the NetCon Installation" for information on how to to add the default passwords, additional users and mount points etc...

Completing the NetCon Installation

To complete the installation of Netcon you must add the default user passwords and any mount points you wish to use with the NetCon Client.

Adding Default Passwords NetCon Client

In this release of NetCon the NeCon menu utility is not available. Therefore the password mapping is in the "/usr/lib/netcon/netcpasswd" file.

Default example entries were added during installation. To add additional servers, users or groups edit the "/usr/lib/netcon/netcpasswd" file and add the entries, use the example as a guide. You must have defaultentries for each NetWare server you wish to connect to, either for printing or file services. Each server must have a default user and group entry and a optional world entry. The default user must be root/ supervisor in order to mount the NetWare volume or print to the printer.

Example: "/usr/lib/netcon/netcpasswd" file.

#

# netcpasswd file used by /usr/bin/netcpass daemon

# NW-srv is the name of the Novell NetWare Server.

# NW-Login-name => is the Netware Login Name on the Netware Server

# NW-Passwd=> is the password on the Server (a `-' says no passwd)

# unix-username=> is the unix login name of the user

# type = either `user', `group' or `world'

# The flags field contains:

# `default' for the default machine name login

# An Entry with flags of default is required.

#

#

#[<UPPER CASE ONLY>]

# NW-srv NW-Login-name NW-passwd unix-name type flags

#

NETWARE SUPERVISOR PASS root user default

NETWARE EVERYONE - wheel group default

NETWARE OTHER - nobody world

Note: You may mount a NetWare server volume as any Unix user and use any NetWare valid users login and password provided that the NetWare user has a valid password and is a trustee on the volume you wish to mount.

Mapping a DOS Drive To A NetCon Server for the First Time.

To map a DOS drive to a NetCon Server: First re-boot the DOS P/C and login to the NetWare server. At the DOS prompt enter the map command:

Example:

C:> map k:=netcon/sys:\

Enter user name for server NETCON: root

Enter password for user ROOT on server NETCON: xxxxxx

Your station is attached to server NETCON:

DRIVE K: = NETCON\SYS: \

C:>

In the above example the DOS drive K: was mapped to the NetCon server called NETCON, SYS: volume. The DOS user logged into the NetCon server as the Unix user root with the root password. The password is automatically added to the NetCon BINDERY as a NetWare encrypted password the first time the user logs in. These passwords can be maintained with the "netcpasswd" command. See the "System Administration" sections of the NetCon Manual for complete details.

Command line Utilities

The Following command line utilities have been added to this distribution to replace some of the functionality of the "netcon menu utility" which is not available on this platform.

Example: To list NetWare servers

# netcslist

To list Groups.

# netcglist

To list users.

# netculist

To list routing gateways.

# netcgwlist

To list print queues.

# netcpqlist

To list statistical information.

# netstat -i


Installation Notes

During the installation, the following changes were made;

/usr/local/lib/netcon/netcexport

The following volumes are exported to be mapped by DOS or other NetCon Clients.

Volume Name Unix Directory

SYS = /usr/local/sys

vol1 = /

vol2 = /usr

(ie. install creates the '/sys' directory and assigns it to volume "SYS").

/usr/local/bin/netcon.rc

The network interfaces are configured.

/etc/rc.local.

Commands to start and stop NetCon client and server.

/usr/src/sys/sys/vnode.h

/usr/src/sys/sys/mount.h

/usr/include/sys/vnode.h

/usr/include/sys/mount.h

/usr/src/sys/conf/files

/sys/i386/conf/NETCON

/usr/src/sys/kern/vfs_conf.c

/usr/src/sys/kern/vfs_subr.c

/usr/src/sys/i386/stand/Makefile

The files were modified to add the NetCon IPX/SPX protocol stack and TFS NetWare Compatible vfs caching file system to the kernel. The original files were copied the file_name.org they will be restored with pkg_delete.

During start-up NetCon's auto-configuration utility automatically configures the network, sets up default users for each server it finds on the network and configures each UNIX printer as a NetWare print queue and print server, for access by DOS or Other NetCon Clients. See the Users Guide for complete information on using the printers.

Stand-alone installations will have all the DOS executable files copied to:

/usr/local/sys/public

/usr/local/sys/login

Starting NetCon Services

The NetCon Network Services are started and stopped automatically during boot and shutdown of the UNIX system.

The following Shell script is used to start NetCon

/usr/local/bin/netcon.rc start

The following Shell script is used to stop NetCon

/usr/local/bin/netcon.rc stop

Note: You SHOULD NOT START and STOP NetCon manually it should be loaded and started at boot time this is to keep the kernel server/user tables and network addressing in sysnc.

The following commands are executed by this script to start the Network Client Services:

/sbin/ifconfig (configure the network driver for IPX/SPX and network type).

/sbin/route (Maintains the IPX/SPX network routing tables).

netcpass (User and password mapping daemon).

netcmount (Mounts Network directories).

The following daemons, provide the Network File, Print and Terminal Server Services:

netcvt (SPX MultiScreen terminal server)

netchost (Proxy server).

netcserv (NetCon SuperServer File Print Sap Rip servers ).

When FreeBSD boots NetCon utilizes the following standard FreeBSD MACROS.

DOMAIN_SET(ns) (Add IPX/SPX address family NS 6 (Xerox Network System) to the domain switch tables.

VFS_SET(TFS_vfs_vfsops) (Add TFS vfs file system to vfs switch table).

VNODEOP_SET(TFS_vnodeop_opv_desc) (Add TFS vnode operations to vnodeop switch table)

Removing NetCon

To completely remove NetCon login as root and reboot the system into single user mode. Or if you like you can unmount any mounted NetWare servers and use "netcon.rc stop" to shut down NetCon. (Failure to unmount a NetWare server before removing NetCon may cause a "panic").

FreeBSD

# pkg_delete NetCon6.1

BSDI

# installsw -L -D -m floppy -c /usr/netcon

Ignore any errors.

Distribution

The following files are included in this distribution of NetCon 6.0 :

File Name Description

/usr/local/bin/netcvt MultiScreen terminal/Proxy server

/usr/local/bin/netcprint Network print utility

/usr/local/bin/netcmount Network mount utility

/usr/local/bin/netcpass User/Group password daemon

/usr/local/bin/netcserv SuperServer file, print, sap, rip

/usr/local/bin/netcon.rc NetCon start-up file

/usr/local/bin/netcrestart Restarts netcserv

/usr/local/lib/netcon/netcexport Volume export file

/usr/local/lib/netcon/ncterm.exe DOS terminal emulator

/usr/local/lib/netcon/setcolor.exe DOS setcolor for ncterm.exe

/usr/local/lib/netcon/nclogin.exe DOS login utility.

/usr/local/lib/netcon/ncmap.exe DOS drive mapper.

/usr/local/lib/netcon/ncslist.exe DOS server listing.

/usr/local/lib/netcon/ncapture.exe DOS printing redirector.

/usr/local/lib/netcon/nclogout.exe DOS logout utility.

/usr/local/lib/netcon/ncterm.pif WINDOWS pif file for ncterm.

/usr/local/lib/netcon/ncterm.ico WINDOWS icon for ncterm.

/usr/local/lib/netcon/keymap Example setkey for ncterm.

/usr/local/lib/netcon/ncpr Network printer setup script

/sys/netns/NETCON.o NetCon kernel module IPX/ TFS.

/usr/local/bin/rmnetcon NetCon removal utility

/usr/local/bin/netcslist Network object listing utility

/usr/local/lib/netcon/netcpasswd Unix to Netware password mapping file

/usr/local/lib/netcon/printd.bsd NetWare spooler examples

/usr/local/bin/netchost Proxy Server

/usr/local/bin/netcpatch Running Kernel patch utility for debugging.

/usr/local/bin/netcps Lists running NetCon processes.