Attached are guidelines to BML Charisma Setups

INFORMATION RELEASE AB 133

edplogo.gif (5330 bytes)

Attached are guidelines to:-

1.	Basic AIX Procedures	pages 1-11
2.	Basic SCO Procedures	pages 12-19
3.	BML Fax Installation	pages 25-28
4.	BML Connectivity Products	pages 35-46

NOTE Pages 20-24 and 29-34 NOT ISSUED

Please review and retain for reference.

Where we have got it wrong, please provide written feedback to Chris Spicer.

POWERSTACK AIX INFORMATION RELEASE

The following sections are discussed:

1.	Creating a SYSTEM BACKUP tape.
2.	Reloading AIX Operating System using SYSTEM BACKUP tape.
3.	Loading Charisma.
4.	Configuring a Port.
5.	Configuring a Printer
6.	Test Ports/ Printers.
7.	Cable Specifications.

CREATING A SYSTEM BACKUP TAPE

Section 1

1.	Login as root user
2.	Shut the system down into maintenance mode: #shutdown -m wait for the message INIT: SINGLE-USER mode appear
3.	Enter the root password when prompted
4.	Mount filing systems to be included in the backup: # mount all OR mount file_system_name
5.	Mount .tmp filing system in addition to the above: /tmp
NB	minimum file systems now mounted should be / , /user. /tmp, /home
6.	Smit mksysb 6a) Select: The required tape device e.g. /dev/rmto 6b) Set Create MAP files to YES 6c) Set Make BOOTABLE backup to YES 6d) Set EXPAND /tmp if needed to YES 6e) Press ENTER to start the system backup
7.	Restart the system

LOADING AIX OPERATING SYSTEM

SECTION 2

1.	Load the AIX BOS CD into the CD drive
2.	Load the SYSTEM BACKUP tape into the relevant tape drive
3.	Power on the system. The system will boot from the BOS CD
4.	When prompted to select the console press F1
5.	Select English 5a) Select 3. Start the maintenance mode for system recover. 5b) Select 4. Install from system backup. 5c) Select Logical tape drive number as required. (e.g. /dev/rmto) 5d) Select 1. For English language 5e) Select 1. Start installation with default settings 5f) Select 1. Continue with installation.
NB	You will see CD activity for approximately 3 minutes followed by tape activity.
6.	After the installation the system will prompt for reboot from the hard disk.
NB	On the first reboot error messages regarding the system monitor will be reported. These can be disregarded as AIX is attempting to start the VSM installation manager.
7.	Ask the user to restore the last save files to update charisma.

Section 3

LOADING CHARISMA

1.	Create a bml user as follows:
2.	Login as root
3 .	Edit the login configuration file vi/etc/security/login.cfg And set the value of maxlogins = 0
4 .	Edit the default system profile - vi/etc/profile At the end of the profile, add the following lines: if ['tty'! = "/dev/lft0] then TERM = 'qterm' ;export TERM fi unalias r
5.	Add the login name to the AIX system
6.	Enter smit users 6a) Select: Add a user Enter the user name Leave all other options at default 6b) Select: Change a user password Enter the name of the new user Password, press return Verify password, press return.
7 .	Load Charisma - This will be on a single tape. 7a) From root cd/home/bml 7b) tar xvof /dev/rmt0

Section 4

Configuring a Port

1 .	Typically the powerstack has 4 comm ports on the rear of the system. Devices may be attached as follows: Comm Port 1 - Modem (always fitted) Comm Port 2 - Fax Box or UPS Comm Port 3 - Fax Box (if UPS installed on Comm Port 2)
2.	Other serial devices e.g. VDU's and printers, are attached to a modular server (MTS) via a thin net network connection. Each MTS has a unique network mode address 2a) Terminals will be connected to the MTS from port 1 upwards. Printers will commence on the last port down. 2b) Port 8 is the ADMIN port and will not normally be configured as a device.
3.	Configuring a comm port: 3a) From root prompt enter smit tty. 3b) Select: Add a tty. 3c) Select: The parent adaptor (See table below). 3d) Select: The Port number (See table below). 3e) Set Enable Login to disable for a dial-out service, or enable if a Login is required. 3f) Set any other serial parameters, e.g. baud rate, as required.

ab133image6.gif (21260 bytes)

4.	Configuring a Modular Terminal Server. 4a) MTS's will be clearly labeled with their network mode ID. e.g. 128.0.0.2 Mode names will follow the convention mts1, mts2 etc.
5.	A menu will now be displayed . 5a) Select: Network configuration. 5b) Select: Host table 5c) Select: Add host 5d) Enter the host name of the host the MTS is connected to. 5e) Select: Change host. 5f) Enter the Internet address of the host system. 5g) Save and exit.
6.	Return to network configuration menu.
7.	Select: Add Boot Hosts. 7a) Select: Add Boot Hosts. 7b) Select the host name previously entered. Enter a file name i.e. /usr/boot/MTS_5.00 (This file does not need to exit and network booting is only required in certain circumstances 7c) Return to the main menu.
8.	Select: Line Configuration 8a) Select: Line Settings. 8b) Set speed to 19200 for local terminals and 9600 printers. 8c) Set terminal to dumb for all lines. Save and exit.
9.	Select: Virtual circuits. 9a) Set Host name to internet name of system that the port will connect to. 9b) Set type to dir tel for terminals and rev raw for printers.
NB *	Set type on line 8 to normal 9c) Set host port & MTS port to 23 for terminals. 9d) Set hot port & MTS port for printers as per the requirements in section 4 - configuring printers. 9e) Save and exit.
10.	Return to main menu.
11.	Select: Users 11a) Select: Add User Enter bml as new user name. 11b) Select: Change User Delete any characters for screen switch char. 11c) Save and Exit.
12.	Select: Set session 12a) Select: bml user 12b) Set type to login for session 1 only. 12c) Set Auto to for session 1 only. 12d) Save and Exit
13.	Return to main menu
14.	Select: Command line mode 14a) From MTS type logout 14b) Enter reboot followed by yes.
15.	Configure the Powerstack /etc/host/file.
16.	Login as root 16a) Smit hostent <er>. 16b) Select: Add a Host. 16c)Enter the IP address and Host Name of the MTS. This will usually follow the convention 128.0.0.2 mts1, 128.0.0.3 mts2

Section 5

1.	Configuring a Printer 1a) Configure the MTS as described in section 3.
	1b) As the printers are connected to a terminal server a method is required to dedicate a MTS port number to the device and to assign a pseudo device to the TCP port. S/W called SOCKIT is required to achieve the 'link'. 1 SOCKIT process needs to be started for each printer driver in this fashion.

Section 6

Installing SOCKIT

2.	Login as root
3.	cd/var/tmp
4.	Copy down SOCKIT from the tape media 4a) ??? from rock * tar -xvf /dev/rmt0
5.	Run the SOCKIT installation script: sh SockInst_AIX41
6.	Remove the remaining installation files from /var/tmp viz README_AIX41 and SockInst_AIX41 6a) cd/var/tmp 6b) rm README_AIX41 SockInst_AIX41
7.	Edit /etc/inittab to include SockIT in the AIX Startup - 7a) vi /etc/inittab 7b) Add the following line after the rcnfs entry - SockIT:2 wait: etc:rc.SockIT start> /dev/console & 1 # Start SockIT.

Configuring SockIT

1.	Once SockIT is installed the sockit startup script needs to be edited to include a SockIT process for each printer 1a) vi /etc/rc.SockIT 1b) for each SockIT process enter, after the line echo "starting SockIT daemon: \c", enter the following: SockIT -d -n /dev/LP?? mts-name tcp-port-number
NB	Replace /dev/LP?? with the name of the printer dev required. Replace mts-name with the name of the mts that the printer is connected to. Replace tcp-port-number with the TCP port number configuration on the mts - Port numbers will be specified as follows: 1c) All TCP ports will start at 2000 or higher and be 4 figure number. The last two numbers will represent the port number on the mts. This will be in the range of 1 to 32. The 2nd figure will represent the mts number. This will be in the range of 1 to 9. 1d) Example: A printer on port 6 of mts1 would be 2106 . A printer on port 24 of mts5 would be 2524. 1e) Start StockIT processes sh/etc/rc.SockIT start. 1f) Now add the printers to the LP service.
2.	From root enter smit spooler. 2a) Select: Add a print queue. 2b) Select: ATTACHMENT TYPE file - File (in /dev directory). 2c) Select: Printer Type - Other 2d) Select: Printer Type - generic - Generic Printer.
NB	Specify the name of existing FILE in /dev directory. viz: LP01 device created by SockIT. 2e) Enter the name of the new print queue to add in the ASC11 queue option. The queue name will normally be the same as the device name i.e. LP01

ab133image11.gif (29853 bytes)

Creating a system backup
Creating a Charisma programs backup tape
Loading SCO 3.2 V 4.2 on a virgin system
Loading SCO using system backup Tape
Loading Charisma using programs backup tape
Configuring a port
Configuring a printer
Testing ports/printers
Cable specification

Section 1

Creating a System Backup

Create emergency boot and root diskettes as follows:

Login as root user and then enter:
#mkdev fd<
Take option 4 (135tpi DS 18 SPT 1.44MB 3.5inch)
Take option 2 (bootable only)
Insert diskette (write enabled)
Enter Y to format

The boot file system will be created on the diskette
Remove diskette (write enabled)
Enter Y to format

The root file system will be created on the diskette
Remove diskette on completion

Perform the above operation twice to create two copies of boot and root disketted. Then quit.

Create system backup tape

Login as root user in single user mode
Insert a write enabled tape into the primary LTU
Enter:
# find. -print|cpio -ocvB -0 /dev/rStp0

The system will backup to tape. When console returns to # remove the tape

Section 2

Creating a Charisma Programs Backup Tape

At bmltty01 enter:
tar cvt8 char* <

The Charisma programs will backup to tape in tar format When complete remove the tape.

Section 3

Loading SCO 3.2 v 4.2 on a Virgin System

Start with system powered on Load N1 Installation diskette Power on system and then wait for boot: prompt
* ONLY PRESS ENTER IF YOU ARE NOT INSTALLING ANY BOOT LOADABLE DRIVERS (B.T.L.D's) * Otherwise enter link < This will prompt you for names of packages to install The only BT.L.D's you should install at this stage are drivers for the hard disk and/or drivers for your installation media which are not part of the minimal kernel. The system will prompt you to enter the volume(s) containing the B.T.L.D. Boot will link the driver into the kernel built in memory.

ANY ERRORS AT THIS STAGE WILL ABORT THE INSTALLATION.

(The example below is for ADAPTEC SCSI Controller AHA-2940)

At packages required enter alad< (Leave N1 diskette in)
When prompted load alad diskette and press enter
When prompted load N2 installation diskette and press enter
Take Option 1 for fresh installation<
Take Option 2 for British Keyboard <
Take Option 1 for fully configurable installation<

When prompted do you want to overwrite part or all of disk contents (y/n) enter y<

Take Option 2 to use entire disk for Unix <

When system displays partition information press enter<

At next prompt enter q < (to exit fdisk)

Enter swop space allocation? (Default shown is approx RAM size)
At this point enter double the default size e.g.-
If 16MB system default - 15000 blocks (1K)
Enter double RAM size 30000 <
Separate /u file system require? Enter y<
Allocations of 1K blocks for the u/filesystem/80000 to 871192)?
Enter80000 <
Is manual adjustment to hard disk required? Enter n<
Scratch division? Enter y<
Medium selection? Enter 1 < (For Floppy)
When requested load N1 diskette and press Enter
When requested load alad diskette and press Enter (Master Installation)
When requested load B1 diskette and press Enter (o.s. Basic Utilities)
When requested load B2 diskette and press Enter
When requested load B3 diskette and press Enter
When requested enter serial number and press Enter

*THIS IS THE LICENSE NUMBER ON THE REGISTRATION CARD *

When requested enter activation key and press Enter

*THIS IS THE LICENSE CODE ON THE REGISTRATION CARD*

At the North America? Enter n <
At Standard Time Zone? Enter gmt <
At Hours West of G.M.T.? Enter 0<
At Daylight Saving? Enter y <
At what Saving Called? Enter y<
At Method? Enter 2<
At Month/Week/Day? Enter 3.4.0 <
At Time (2AM) press enter
At How Many Hours (1)? press enter
At Date Time Takes Default Or Change <
(I.E: 9604031114 =11:14am on 3rd April1996)
At Extra Option? Enter 1< (install additional software)
(At this stage the custom menu is displayed)
At select? Arrow key to highlight INSTALL and press enter Load the X1 diskette (operating system extended utilities)
A New Product?<
Entire Product?<
Continue?<
At insert X1 press enter
When Prompted load X2 diskette and press enter
When Prompted load X3 diskette and press enter
When Prompted load X4 diskette and press enter
When Prompted load X5 diskette and press enter
When Prompted load X6 diskette and press enter
When Prompted load X7 diskette and press enter
When Prompted Mail System to Use Different Name? Enter y<
When Prompted Name? Enter customers name<
When Prompted Machine Name? Press Enter
When Prompted Press Any Key to Continue? Do so
The system returns to custom Menu
At this point load the Specialix Floppy (SLXOS UNIX V.3 DRIVER)
User arrow key to highlight INSTALL and press enter
At new product? Press enter
At entire product? Press enter
At is O.S. SCO UNIX? Press enter
At continue? Press enter
At continue? Press enter
At machine type? use down arrow to select main board Type and press enter (for example only - at compatible) How many cards? Enter number of 8 port blocks and press enter Interrupt/Polled? Enter Interrupt option and press enter Are any of these cards in your machine (y/n?)
YOU WILL NEED TO CHECK IF IN ANY DOUBT ASK! DO NOT PROCEED UNTIL SURE
Megabytes? Enter RAM< size i.e. 16 and press enter the system will display the settings on the specialix card

STANDARD SETTINGS FOR FIRST CARD ARE:

MEM ADDRESS
SW1
SW2
LK1
PORTS

d000
0
d
0
8

*THE SYSTEM DISPLAYS HOW SET ON THE CARD*

Re-enter Hardware details? (y/n) Enter n and press enter number of ports? *For 1 terminal adaptor* enter 8<
Rebuild New Kernal? Enter y <
Continue? Press enter
Continue? Press enter
System security? 3 < (traditional)
Run system admin shell/continue? 2<
Password? Press enter
New Password? Enter Pssword < Or enter for none Re-enter password. Re-enter new password < Or enter for none packages to Install/Quit Default alad

*DO NOT QUIT - TAKE DEFAULT*

Boot from 7800 Family SCSI? Y <

REMOVE FLOPPY
When requested press any key to reboot

Section 4

Loading SCO Using System Backup Tape

'Tools' required:-

Boot Floppy
Root Floppy
System cpio Backup Tape

** IF NO ROOT/ BOOT DISCS AVAILABLE YOU WILL HAVE TO PROCEED AS IF VIRGIN SYSTEM LOAD I.E.: CARRY OUT SECTION 3 FIRST SO I SUGGEST "LOOK AGAIN" AND YOU MUST MAKE NEW ROOT/BOOT FLOPPYS (2 OF EACH) AFTER SYSTEM INSTALLATION COMPLETE**

Power Systems Off
Load Boot Floppy
Load System Back Up Tape into the primary LTU
Power System On
At Prompt Boot: Press Enter
When requested load root floppy and press enter
At # enter: mount /dev/hd0root /mnt<
At # enter: cd /mnt

** DO NOT REMOVE DISK**

At # enter: cpio -icvBdmul -I /dev/rStp0<

SYSTEM RESTORE WILL NOW TAKE PLACE. WHEN COMPLETE -
At # enter: cd..<
At # enter: sync<
At # enter: umount /mnt<
At # enter: sync; haltsys<

The following message will then be displayed:

**SAFE TO POWER OFF**

**PRESS ANY KEY TO REBOOT**

At this point remove root disk and system backup tape then reboot.

Section 5

Loading Charisma Using Programs Backup Tape

Login as bml
Insert the Charisma Programs Backup Tape into the primary LTU at bmltty01 prompt enter: tar vxt8<
Charisma programs will now be installed into the BML Directory

*ON COMPLETION GET USER TO LOAD CHARISMA DATA FROM SAVE FILES LATEST GOOD TAPES*

Section 6

Configure a Port

Ensure the SLXOS package is loaded (see section 3)
Enter root in multi user mode
At # enter config.si<
At OS IS SCO UNIX? Highlight YES and press enter.
At main menu highlight View/edit tty and press enter.
At View/edit tty highlight >ttya01/ttya01 and press enter.
At Parameter change/ diagnostic highlight >Edit TTY and press enter.
At ttya01/ttya01 highlight >getty entry and press enter.
At baud parity data handshake label use down arrow to highlight >38400 none 8 in:none out:soft o o and press enter
At ttya01/ttya01 use down arrow to highlight >TTYtype and press enter.
-*/4At TTY types use down arrow to highlight vt220 and press
Press escape to return back to ttya01/ttya01.
Press escape to return to main menu.
Use down arrow to highlight quit and press enter
At save changes highlight yes and press enter
You now need to enable the Ports as follows:
At # Enter enable ttya01 ttya02 ttya03 (etc. for all non printer ports) then press enter.
This will return you to the # prompt.
At this time you will either exit or configure your printers (see section 7)
If exit option used reboot the system afterwards.

Section 7

Configuring a Printer

Login to root and at # prompt enter sysadamsh and press enter
Type P (no return or enter) to get to printers
Type C (no return or enter) to get to configure
Type A (no return or enter) to get to add
At printer name enter either:
LP01 (for a printer on ttya07)
LP02 (for a printer on ttya 08)
At comment press enter
At class name press enter
At printer interface highlight existing and press enter
At name of interface enter? and press enter (for choices).
Use down arrow to highlight *standard and press enter
At connection highlight direct and press enter
At device name enter /dev/ttya07 (or ttya08) and press enter
At device highlight hardwired and press enter
At required banner highlight no and press enter
Ignore the warning message that says /dev/ttya07 is accessible by others
At press any key to continue press enter
At sysadamsh configure press escape
At printers enter S (schedule).
At schedule enter A (accept)
At destination enter ? (for choices) and press enter
At choices highlight LP02 (or LP03) and press enter
Return through remaining destinations until accept menu is displayed.
At press any key to continue press enter
At schedule press escape
At printer press escape
At sysadmsh press escape
At sysadmsh use going right arrow to highlight quit and press enter
At quit highlight yes and press enter
This will return you to the # prompt
At this time type exit and press enter.

When port and/or printers configured reboot the system

Section 8

Testing Ports and Printers

Ports

Connect a VDU to the required port on the Specialix adapter.

Configure the VDU for 38400 baud, 8 data bits, 1 stop bit and no parity

Providing the port is configured, the specialix package is loaded and charisma programs are loaded you should have a login

Get user to test using their applications

Printers

Connect a printer to the required port the specialix adapter

Providing the Port is configured, ready and enabled plus the specialix package and Charisma programs are loaded the user should be able to send prints (printers must use XON/XOFF flow control).

Section 9

Cable Specifications for Ports and Printers

ab133image19.gif (20992 bytes)

Fax Installation

Fax Software

Beacon Computer Services U-Fax version 3 installation

Each U-Fax copy supplied by Beacon Computer Services is licensed to one particular customer only. Therefore the correct copy must be loaded on the correct machine every time. Before starting the installation, make sure a spare serial port is available and the device name is know. Also a ufax login is required that does not have a password set. It will not matter is AIX prompts for a password so long as a Return is all that is required to bypass it.

Login as root user.
Load the installation media into a temporary directory.
mkdir/var/tmp/fax
cd/var/tmp/fax
cpio -iBcvdum </dev/rmt0

If a different tape drive or the diskette drive is being used then replace the device name as appropriate.

Start the installation.

./install

Prompt:	Is this the MAIN machine.Type y
Prompt:	Enter lib directory. Press Return to use the default of /usr/lib/ufax
Prompt:	Enter spool directory. Press Return to use the default of /usr/spool/ufax
Prompt:	Enter the company name and address the following suggestion should be used.

on line 1 type the company name, on line 2 enter the company address and on line 3 enter the company telephone number. Always place 3 spaces at the start of each line otherwise this information will appear too close to the edge of the faxed page.

Prompt:	Enter the site identification string. Type in the company name (maximum of 30 characters).
Prompt:	Is this part of a U-Fax installation over a TCP/IP network press Return
Prompt:	How many fax units do you wish to setup. Type in the number of faxboxes being installed (usually just 1)
Prompt:	Enter name of fax unit? Type of fax unit. Enter D for Dce Faxbox and Faxbox 30.
Prompt:	Enter the type of fax unit. Enter D for DCE Faxbox and Faxbox 30.
Prompt:	Is device to be connected via TCP/IP terminal server. Enter n
Prompt:	Enter the device file to be used. Type in the name of the tty device that the faxbox is to be connected i.e./dev/tty1.
Prompt:	Do you wish to set up a debug trace file. Enter n
Prompt:	Enter exchange access code. Type the number used by the local exchange to request an outside line i.e. 9 or just press Return for no number if the faxbox is connected to a direct telephone line
Prompt:	How many telex units do you wish to setup. Enter the number of telex devices to be setup (usually 0)

U-fax now needs to be registered. The system will display a Registration number and a Serial number. It will then prompt for a License number which must be obtained from Beacon Computer Services. They will ask for the registration number, serial number and the company name. The license number given must now be keyed in.

Prompt:	Do you wish to install Uniplex interface. Enter n
Prompt:	Do you wish to install WordPerfect-U-Fax interface. Enter n

The initial installation is now complete.

It is possible to license U-Fax without calling Beacon by using the temporary license number supplied on the Software Registration Card. This will only last for 30 days after which time U-Fax will fail to restart.

Beacon Computer Services U-Fax version 3 setup

Edit default portrait layout.
vi/usr/lib/ufax/Faxformats/DCE/default
Change the hpg command line to.
hpg <$FAXIN | HPTORASTER -S1E -L2 -t -f$UFXLIB/Fonts -ofax >$FAXOUT

Edit default landscape layout
vi/usr/lib/ufax/Faxformats/DCE/default
Change the hpg command line to.
hpg <$FAXIN | HPTORASTER -O -S1E -L2 -t -f$UFXLIB/Fonts -ofax >$FAXOUT

Edit the default OTI header
vi /usr/lib/ufax/Faxformats/DCE/oti.MH
Remove from the hptoraster command line.
$3 at and any trailing spaces.

The U-Fax installation fails to create the device entry /dev/ufax. This however is not required by Charisma. The installation also fails to update the AIX startup routine correctly. The following changes also needs to be made.
vi /etc/rc
Remove the last line of the file which should be ufax.rc. This command appears after an exit 0 and will not be executed it also appears to soon in the AIX startup.

Edit /etc/inittab to include the U-Fx startup
vi /etc/inittab
Add the following line after the rcnfs entry.
ufax:2:wait:/etc/ufax.rc >/dev?console 2>&1 # Start ufax

Change the permissions on the Faxbox tty device file.
chmod + rw /dev?tty??
Replace /dev/tty?? with the tty port number that the faxbox is connected to.

Charisma configuration of U-Fax.

The following changes need to be made for Charisma to make full use of U-Fax and the Faxbox 30. The additional file copied on can be supplied from the BML Technical Support department.

Copy executable scripts.
cp /var/bml/fax/bin/fax* /usr/bin
cp /var/bml/fax/bin/U* /home/bml/bin
If the bml home directory is other than /home/bml then the previous commands should be amended accordingly.

Copy additional font files.
cp /var/bml/fax/Scans/* /usr/lib/ufax/Scans

Copy updated default faxheader.
If using U-Fax version 3.1 or earlier use the following.
cp /usr/lib/ufax/.faxheader /usr/lib/ufax/faxheader.def
cp /var/bmlfax/faxheader.31 /usr/lib/ufax/.faxheader

If using U-Fax version 3.2 or later use the following.
cp /usr/lib/ufax/Setup/faxheader /usr/lib/ufax/Setup/faxheader.def
cp /var/bml/fax/faxheader.32 /usr/lib/ufax/Setup/faxheader

Run ufx remedy to reset permissions on all U-Fax files.
/usr/lib/ufax?bin/ufxremedy

Create U-Fax / Charisma working directories.
mkdir $HOME/FAX $HOME/UFAX

Edit the bml.profile to include the following environment assignment.
If setting up for Charisma version 4 use the following.
dd_UFAX=$HOME/UFAX;EXPORT DD_UFAX

If setting up for Charisma version 5 use the following.
dd_FAX=$HOME/UFAX;EXPORT DD_UFAX

Create U-FAX / Charisma headers directory and copy standard header files.
mkdir $dd_SL/UFAX
cp /var/bml/fax/SL/UFAX/*dd_SL/UFAX

U-Fax installation is now complete. The fax hardware should now be setup and the whole system rebooted reactivate the new installation.

Fax Hardware.

DCE Faxbox 30.

The DCE Faxbox 30 requires the following configuration to function correctly. An ASCII terminal can be used directly on the back of the Faxbox 30 or it can be configured by using cu or ufxtalk from the Unix system. A terminal should be setup at 9600 baud, 8 data bits, 1 stop bit, no parity.

To use cu to setup the Faxbox execute the following commands.
Edit the UUCP devices file and change permissions on the Faxbox tty device name.
vi /usr/lib/uucp/Devices
Add the following line to the end of the file.
Direct tty?? - 9600 direct

chmod +rw /dev/tty??
Replace tty?? with the tty port name that the Faxbox is connected to.

To access the Faxbox use the following.
cu -I tty??

To quit a cu connection press Return ~.Return.

Ufaxtalk can be used to setup the Faxbox once U-Fax has been installed and configured.
To start ufxtalk enter.
/usr/lib/ufax/bin/ufxtalk DCE1
Replace DCE1 with then name of the Faxbox to be configured.

To quit ufxtalk press Return~.Return.

Faxbox 30 configuration.

Connect to the Faxbox using 1 of the above methods and enter the following. All commands typed into the Faxbox are not echoed to the screen, but the current value can be seen by typing in the parameter followed by a ? i.e. TBN?.

Enter ^K (this is not control K, but a carat "^" followed by a "K") This will return the current indent of the Faxbox and provide conformation that the Faxbox is communicating with the Unix system.

Enter ^p to enter setup mode. The Faxbox will return a message to confirm it is in setup mode.

Enter:	FLC=B to set Xon/Xoff flow control
Enter:	TBN=C to turn off the top banner
Enter:	BBN=C to turn off the bottom banner
Enter:	RDF=B to set Group 3 fax mode
Enter:	DPD=A to set tone dialing
Enter:	DTD=A to set blind dialing (default) i.e. will dial a number if no dialtone s heard. DTD=B can be set if a dialtone should be heard before the number is dialed.
Enter:	CSI=Customer Name (this is a maximum of 30 characters).
Enter:	SAV=Y to set save on exit mode to yes.

Enter ^t to exit from setup mode.

The Faxbox should now be powered off and back on again.

Connectivity Products.

Terminal Emulation

Century Software TinyTERM Plus for Windows 3.1x (Serial and TCP/IP).

The installation routines for TinyTERM Plus and TinyTERM Plus NFS are all similar the only main differences being the name of the application, the directory the software is installed into and the program icon names (TinyTerm uses C:\TT, Tiny Term Plus use C:\TTPLUS). The functionality of each program is identical as far as the emulation mode is concerned. The instructions below apply to TinyTERM Plus but can still be used for all other versions of TinyTERM.

TinyTERM installation

Start Microsoft Windows for Workgroups (ver 3.11).

Select:	Program Manager window.
Select:	File menu
Select:	Run... option
Enter:	a:\setup

This starts the setup routine and displays the installation startup screen.

Select:	Install TinyTERM Plus for Windows and click OK button
Prompt:	Select a fixed drive to receive the software. Click on the disk drive to install TinyTERM on and click OK button.
Prompt:	Chose your installation directory on a fixed drive. Click on OK button to use the default directory (C:\TTPLUS)

The installation routine will now proceed to copy on the programs from the supplied disks. Insert each disk when it is requested. Next a list of communication drivers will be displayed. Select from this list either a COM port for a serial connection(in most cases this will be COM2) or Wollongong Pathway (Winsock) if a TCP/IP connection is required. Then click OK button TinyTERM now needs to be licensed.

Prompt:	Enter Serial Number Type in the serial number from the Activation Key Card supplied.
Prompt:	Enter Activation Key Type in the activation key from the same Activation Key Card that the serial number came from. If both numbers are correct the installation will continue, otherwise another chance will be given to key in the license information again.

The installation will now need to make modifications to the AUTOEXEC.BAT and WIN.INI.

Prompt:

Go ahead and modify to allow install to make any necessary changes.

The installation routine is now complete.
Close Windows and Reboot the PC

ab133image25.gif (881542 bytes)

Change:	Terminal Emulation to VT220-7
Change:	National Replacement Char Set to BRITISH
Click:	OK button when complete
Select:	Configure menu
Select:	Keyboard... option

Set Keyboard Scheme to Default then click Edit button.

ab133image26.gif (30042 bytes)

Change:

Keyboard language to United Kingdom.

The following table details the keys that need to be reprogrammed. To program a key use the following sequence.

Click:	Key to be changed.
Click:	Action field and change from DEFAULT to MACRO
Click:	Value field and type in the required character sequence. When entering the new sequence the escape string "<esc>" does not mean press the Escape key but type in the 5 characters. When this part of the string has been accepted it will appear in the value viewer as ^\| to represent the escaped character
Click:	Set button to program the new sequence. Repeat this sequence for all keys then click OK when complete.

Key to be programmed	sequence to be entered
F5	<esc>[16~
INS	<esc>[1~
HOME	<esc>[2~
PG UP	<esc>[3~
DEL	<esc>[4~
END	<esc>[5~
PG DN	<esc>[6~
Keypad*	*
Keypad+	+

Select:	Configure menu
Select:	Colour ...option

ab133image27.gif (761754 bytes)

Select:	File menu
Select:	Exit option

TinyTerm will then display the following screen.

ab133image28a.gif (189756 bytes)

Click:	Yes button to save the changes to the DEFAULT.TAP file
Create a Charisma program icon the Program Manager Main windows as follows.
Select:	Century Software program group
Select:	TinyTERM Plus icon
Hold down the Control key then click on the TinyTERM Plus icon and drag the icon to the main window. This will create a copy of the TinyTERM Plus icon in the Main window.
Select:	TinyTERM Plus program icon in the Main window
Select:	File menu
Select:	Properties... option

ab133image28b.gif (114932 bytes)

Change:	Description to Charisma.
Click:	OK button when complete

ab133image28c.gif (89244 bytes)

The configuration of TinyTERM is now complete.

Network Connectivity

Microsoft Windows for Workgroups Network

This basic configuration will allow for the sharing of disk drive and printer resources between PC based systems. It will also provide a basis for the installation of Century Software TCP/IP and NFS.

Start Windows for Workgroups.

Select:	Program Manager window.
Select:	Network window
Select:	Network Setup icon

ab133image29a.gif (16612 bytes)

Click:

Network button

ab133image29b.gif (20409 bytes)

Select:	Install Microsoft Windows Network. A . will appear beside the option.
Click:	OK button when complete
Click:	Sharing button

ab133image29c.gif (9693 bytes)

Click:

I want to be able to give other access to my files if other machines need to access disk drives printers attached to this PC (x appears in check box to enable the option).

Click:	I want to be able to allow others to print to my printer(s) if other machines need to access any printers attached to this PC.
Click:	OK button when complete.
Click:	Drivers button.

ab133image30a.gif (16197 bytes)

Click:

Add Adapter button.
This will produce a list of Network Adapter drivers currently supplied with Windows for workgroups. This is not the only adapters supported. BML currently use the following network adapters.

Ethernet adapter	Network Adapter
3 Com 3C503	3 Com EtherLink II or IITP (8 or 16-bit)
3 Com 3C503-16	3 Com EtherLink II or IITP (8 or 16-bit)
3 Com 3C509	3 Com EtherLink III 3 Com EtherLink III (3C5X9) - latest driver release.

Select:	The appropriate driver required and click OK button. It would be recommended that the latest driver (i.e. the one supplied with the ethernet adapter) is used installation. Use the following additional instructions to install the new driver.
Select:	Unlisted or Updated Network Adapter option and click OK button. The installation will then prompt for the unlisted, Update or vendor-provided network driver disk. This disk should be placed in the diskette drive and the Pathname for the Windows.DOS driver files typed in. The 3Com 3C5x9 drivers appear in A:\NDIS\WFW.
Click:	OK button when complete. A new list of Network Adapters will then be displayed.
Select:	The appropriate driver and click OK button The Network Drivers screen will now display the drivers it will install.
Click:	Close button to exit this screen. The Network Setup screen will be redisplayed showing he new configuration setup.

ab133image30b.gif (19578 bytes)

Click:

OK button to continue the installation.

The installation will now request a Network User name.

ab133image31.gif (14046 bytes)

Change:	User Name and Computer Name to the either the Internet name of the OC or leave at the default provided by windows. The Workgroup name can be left at the default. These can always be changed later.
Click:	OK button when complete.

The installation routine will now start to copy on the additional files from the Windows installation media and any ethernet adapter driver disks.

Windows will then prompt to restart computer or continue with windows. Click Restart Computer button.

The configuration of the Windows for the Workgroups is now complete.

Century Software TinyTERM TCP/IP VxD drivers for Microsoft Windows.

Century Software actually use the Wollongong Pathway Runtime for Windows to provide it's TCP/IP drivers for Windows for Workgroups.

TCP/IP VxD driver installation.

To make the installation easier make sure the Windows for Workgroups network is already configured. See the section Microsoft Windows for Workgroups Network.

Start Microsoft Windows for Workgroups.

Select:	Program Manager window.
Select:	File menu.
Select:	Run... option
Enter:	a:\setup This starts the setup routine and displays the Pathway welcome screen.
Click:	Install button to start the installation. The installation prompts to license the product. Only a Name and Company Name need to be entered since the VxD driver is no longer subject to a license requirement. If a user name is not known then just enter a full stop.
Click:	OK button when complete
Prompt:	Source directory to copy files from. Use the default A:\.
Prompt:	Destination directory to copy files to. Use the default C:\PATHWAY.
Click:	OK button when complete.
Click:	Express button to run an express installation.

The installation now shows the TCP/IP configuration screen.

ab133image32.gif (394297 bytes)

Enter:	Computer name i.e. enter the Internet name of the PC.
Enter:	IP Address for the PC.
Enter:	Subnet Mask. This will be 255.255.0.0 for a BML supplied system using the Class B address range i.e. 128.0.1.1. So long as the Windows for workgroups network has already been configured, Then the network adapter will already have been correctly selected. Otherwise the driver will need to be loaded manually from the vendor supplied driver disk.
Click:	OK button when complete.
Prompt:	Are you ready to proceed now. Click Yes button to continue the installation. Click No to return to the previous screen. The installation program will now copy on the necessary files from the installation disk.
Prompt:	Interface Description. This allows a single line of text to be entered to describe the installation within the TWGTCP.INI configuration file. Normally just click OK button to continue.

Once the installation has finished click Reboot System button to activate the new installation.

Start windows for workgroups.

Select:	Program Manager window.
Select:	Pathway Access window.
Select:	Config icon. Double click on icon to start the application.
Select:	Interface menu.
Select:	Edit HISTS file option.
Enter:	Host IP address, Tab, Host Internet name i.e. 128.0.0.1 host.
Select:	File menu.
Select:	Exit option.
Click:	Yes button to save the changes.
Select:	File menu.
Select:	Exit option to close configuration screen.

To test the TCP/IP installation use the following.

Select:

Ping icon. Double click on icon to start the application.

ab133image33a.gif (144020 bytes)

Enter:	IP address or Host name of an attached Unix system.
Click:	Start button. The test will;; then start and after a few seconds the Results button will become available (the word Results will not be grayed-out).
Click:	Results button If the test completes successfully a screen similar to below will be seen.

ab133image33b.gif (201110 bytes)

This shows a 0% loss in packets sent.
If the test fails a screen similar to below will be sent.

ab133image33c.gif (202548 bytes)

This shows a 100% loss of packets which is a complete failure.

Click:	OK button to close the results window.
Click:	File menu
Click:	Exit option to leave the ping program

Century Software TinyTERM NFS VxD drivers for Microsoft Windows.

Century Software actually use the Wollongong Pathway Client NFS for Windows to provide it's NFS drivers for Windows for Workgroups.

NFS VxD drivers installation.

Start Microsoft Windows for Workgroups.

Select:	Program Manager window
Select:	File menu
Select:	Run.. option
Enter:	a:\setup This starts the setup routine and displays the Pathway welcome screen.
Click:	Install button to start the installation
Prompt:	Source directory to copy files from. Use the default A:\.
Prompt:	Destination directory to copy files to. Use default C:\PATHWAY
Click:	Continue button when complete
Prompt:	Are you ready to proceed now?
Click:	Yes button to start the installation The installation program will now copy on the necessary files from the installation disk and modify any files necessary.

Once the installation has finished click Restart Windows button to activate the new installation.

The NFS installation can be tested as follows but only if the PC is connected to a Unix host that is configured to run NFS.

Select:	Program Manager window
Select:	Main window
Select:	File Manager icon. Double click on the icon to start the application
Select:	Disk menu
Select:	Connect Network Drive... option. This will display the Windows for Workgroups network connection screen.
Click:	Other button to select the PathWay Networks Connection window.

ab133image34.gif (19889 bytes)

Click:

Browse button to display a list of available host systems.

ab133image35a.gif (18130 bytes)

Clicking on an NFS host will display a list of exported Mount Points
Click on a Mount Point and then click OK button
This will then return to the PathWay Network Connections window

Click:

Connection button

ab133image35b.gif (13161 bytes)

Click:	Username field and enter a valid username.
Click:	Password filed and enter the appropriate password for the username previously entered.
Click:	OK button when complete If NFS is installed and working correctly then the Current Drive Connections field in the PathWay Network Connections window will display the new drive connection.

ab133image35c.gif (20892 bytes)

Click:	The drive connections window.
Click:	Disconnect button to remove the drive connection
Click:	Close button to exit.
Click:	File menu
Click:	Exit option to leave the File manager.

Return to Index