Altos Computer Systems V 386 Series User manual

Altos System
V™
Series 386
Installation


Altos
Computer
Systems
Altos System
V™
Series 386
Installation

Document
History
Copyright
Notice
Trademarks
Umltatlons
EDmON
PART
NUMBER
DATE
F'ust Edition
6~21170-001
No~ber
1987
Second Edition
6~21170-002
Jmuary
1988
Third Edition
~2117(H)()3
Narch1988
Fourth Edition
6~21170-004
May
1988
F'lfth Edition
6~21170-00s
October 1988
Sixth Edition
6~2117(H)()6
December 1988
SeftntbEdition
~2117(H)()7
July 1989
Manual
Copyript
CI987, 1988, 1989 Altos ComputerSJStems.
Programs Copyright CI987, 1988, 1989 Altos Computer SJStems.
All rights reserved. Printed
in
U.S.A.
Unless
JOu
request
and
recehe written permiIIion from Altos Computer Systems,
may not copy
my
part
of
this document
or
the
software
JOU
received, except
in
U
normal use
of
the software
or
to
make a backup copy
of
each
diskette you receive
The Altos logo,
as
it appears
in
this manual, isa registered trademark
of
Altos
ComputerSystems.
Altos System V isa trademark of Altos Computer Systems.
AOM
and
AOM nPlus are trademarks
of
Altos Computer Systems.
DOCUMENTER'S WORKBENCH
is
a trademark
of
AT&T.
UNIX is a
repered
trademark
of
AT&T.
WorkNet is a repstered trademark
of
Altos Computer Systems.
WorkNet n is a trademark
of
Altos Computer Systems.
XENIX.
is a
repered
trademark
of
Microsoft Corporation.
20120
is a trademark
of
Access Technolopes, Inc.
Altos Computer Systems reserves the right
to
make
chanps
to
the product descril
in
this manual at any time and without notice. Neither Altos
nor
its suppliers
make any warranty with respect
to
the accuracy
of
the information
in
,this
manu~

GUIDE TO YOUR ALTOS SYSTEM
VTM
SERIES 386 DOCUMENTATION
~
RUN-TIME SYSTEM
~
Installation
141
I
Part
n""""""
696-21170-
•••
690-21869-nnn
•
Installation
and upgrade
•
Set
up Multidrop and UPS
_ Using the
AOM-
Menu System
AI
;
Part
number: 690-18055-nnn
--.J
• Easy-to-use menus
to
access
programs
• Menu Manager
to
add, update,
remove menus
Operations Guide
Part
number: 690-21171-nnn
• System administration
• Accounting,
file
systems
• Backups,
port
setup
• Communications
(UUCP)
•
Error
messages
Reference
(0)
Part
number: 690-22869-nnn
• Commands
(C)
__
Reference (M)
in
Part
n.-r:
690-2287o-nM
• Miscellaneous files (M)
;
User's Guide
Part
number: 690-21178-nnn
AI
(Not shipped
with
the
Run-time system)
• Basic
concepts
and tasks
• Vi,
ed,
mall, awk,
sed
.
• Shells: sh and csh
TEXT PROCESSING SYSTEM
_ DOCUMENTER'S WORKBENCH'·
;,
Part
numbers: 690-15843-nnn
690-15844-nnn
I:.J
.
Mm
macros,
reference
~,~
• Nroff,
troff,
tbl,
eqn
wi'
DEVELOPMENT SYSTEM
Set
part
number: 690-21585-000
~
Reference (CP,
S,
F)
~
I • Programming commands (CP)
~:
•
System
calls, library routines (S)
-
'.
File
formats
(F)
:;
Programmer's Guide
~
•
Make,
sces
•
Lex,
yacc
• Signals, system resources,
device
drivers
• Adb,
sdb
•
Shared
libraries
:;
C Complier Library and User's Guide
~
•
I/O
functions, pipes
• Curses, term1nfo
• Assembly
routines
• As,
cc,
COFF,
lint,
Id
•
Error
processing
•
Character
and
string
processing
r;
C Complier Language Reference
~
• Elements
of
C
•
Program
structure
•
Declarations,
expressions
•
Statements,
functions
•
Preprocessor
directives
r;
Macro Assembler User's Guide
~
and Reference
. • How
to
use
masm
•
Error
messages
'.
Type
declarations
• Operands, expressions
•
Directives,
file control
•
Instruction
summary
order the User's Guide
or
any
of
the above manuals, call 408/434-6688, ext. 3004
d give the manual
title
and
part
number.


~About
This Manual.
USING THIS MANUAL
This manual, written for the system administrator, de-
scribes how
to
install and upgrade the Altos System
V™
operating system, and
how
to
set
up the optional Multidrop
Communications System and Uninterruptible Power Supply
(UPS).
~,
This manual does not describe
how
to
physically connect
your system
or
run the application software
that
you have
purchased with your system.
NOTE
The last section
of
this manual, "Change
Information," summarizes
the
changes
that
have
been made
to
the manual since
the
previous
version.
ORGANIZATION
This manual contains the following chapters:
Chapter 1, "Installing and Setting
Up
the Operating
System," describes
how
to
initially install and
set
up
the
operating system, reconfigure ports for your terminals and
printers, and
set
up
user login accounts.
;)
Chapter 2, ''Upgrading
Your
Operating System," explains
how
to
upgrade your operating system and install additional
hard disks.
iii

Chapter 3, "Setting
Up
Your
Multidrop System," describes
how
to
connect peripherals (terminals, printers, and so on)
to
the
communications
boards
(Multidrop, SlO,
or
ACPA).
Chapter
4,
''Uninterruptlble Power Supply," describes the
software
that
supports
an
Uninterruptible Power Supply,
and explains
how
to
select the desired power-down process
for your installation.
MANUAL CONVENTIONS
This section describes documentation conventions used
in
this manual.
Symbol
boldface
type
boldface
type
italic
type
reverse
type
Description
What you type. For example:
Type
tar
cv
files
Used for commands, programs,
utilities, functions, and options.
For example:
Use the
tar
connnand
to
back
up your files
to
floppy disk.
Variables (a value
that
can change),
such as
files,
as shown
in
the
example above. Also for manual
titles, such as Altos System V
Series 386 Operations Guide.
Key
you
press. For example:
Press
__
Press
'tAGI.
iv

Symbol
pn
••
IIIIc
a, x, n
Description
Keys you press simultaneously
(separated by a hyphen and shown
in
reverse
type).
For example:
pn
••
means you press and
hold
the
IaIIDI
key and then
press
the
d key. .
Keys you press sequentially.
Variables
that
can change. They
mean: a (any
letter),
n (any
number), x (any
letter
or
number).
For example:
Version n.na File name
xxxxxx
ADDITIONAL REFERENCE MATERIALS
For more information on your operating system,
see
the
following list
of
manuals. To order a manual, call (408)
434-6688,
ext.
3004 and give
the
manual
title
and
part
number.
Owner's Guide
(part
number 690-21264-nnn
or
690-20351-
nnn) describes
how
to
connect computer components and
per-
ipherals,
tum
on power, and use
the
diagnostic programs.
Using the AOM Menu System
(part
number 690-18055-nnn)
describes
how
to
use
the
Altos Office Manager
(AOM)
to
install software and manage
the
operating system.
v

Altos System V Series 386 User's Guide
(part
number 690-
21178-nnn) (not shipped
with
the
Run-time system) explains
basic
operating
system
concepts
and
programs
(e.g.,
vi,
ed,
sh, csh, mall,
sed,
and
awk).
Altos System V Series 386 Operations Guide
(part
number
690-21171-nnn)
tells
how
to
set
up
the
system
for
users
and
peripherals, maintain
and
back
up
the
system,
optimize
system
performance,
and
use
uucp communications programs.
This manual also
contains
system
and
LP
spooler
error
mes-
sages.
Altos System V Series 386 Reference (C)
(part
number 690-
22869-nnn) and
Altos
System V Series 386 Reference
(M)
(part
number 690-22870-nnn)
describes
the
Altos Run-time
system
commands
and
extended
utilities
sections
(C)
and
(M).
Altos System V Series 386 Development System
Set
(part
number 690-21585-000)
contains
reference
and
tutorial
material.
Manuals
in
this
set
include:
Altos System V Series 386 C Compiler
Library
and
User's Guide
Altos System V Series 386 C Compiler Language
Reference
Altos System V Series 386 Programmer's Guide
Altos System V Series 386
Macro
Assembler User's
Guide and Reference
Altos System V Series 386 Reference Sections
(CP),
(S),
and
(F)
DOCUMENTER'S WORKBENCH
(part
numbers 690-15843-nnn
and
690-15844-nnn)
describes
nun,
nroff,
trott,
and
type-
setting
functions
and
commands.
vi

Contents
) Contents
1 INSTALLING
AND
SETTING UP THE
OPERATING SYSTEM
1-3
HOW
TO START
1-4 INSTALLATION
SUMMARY
1-5 INSTALLING THE OPERATING SYSTEM
1-13 INSTALLING ADDITIONAL
HARD
DISKS
1-14 SETTING UP THE PORTS FOR TERMINALS
AND
PRINTERS
1-20 Adding a
Port
1-22 Changing a
Port
1-23
Setting
Up a
Printer
1-28 Removing a
Port
from Use
It,
1-28 Exiting
the
Port
Configuration Program
I 1-29 CREATING
AND
CHANGING USER ACCOUNTS
jV'
1-30
User
Administration Commands
1-31
Creating
a
User
Account
1-33 Guidelines
1-34 CHECKING THE FILE SYSTEM, SETTING THE
DATE,
AND
STARTING
UP
1-36 RECOVERING FROM INTERRUPTED INSTALLATION
1-37
WHERE
TO NEXT?
2 UPGRADING
YOUR
OPERATING SYSTEM
2-3 INTRODUCTION
2-4 INSTALLING THE UPDATED VERSION
2-8 INSTALLING ADDITIONAL
HARD
DISKS
3 SETTING UP
YOUR
MULTIDROP SYSTEM
~
,..'
3-3 INTRODUCTION
3-3 CALCUlATING PORT ADDRESSES
3-7 SET-UP PROCEDURE
SUMMARY
vii

Contents
4 UNINTERRUPTIBLE POWER SUPPLY
(UPS)
4-3 INTRODUCTION
4-3 SHUTKILL
4-5 SHUTSAVE
4-8
INSTALLATION CONSIDERATIONS
INDEX
CHANGE INFORMATION
FIGURES
Page
Figure
Title
1-8 1-1
1-17
1-2
1-30 1-3
1-32 1-4
3-8
3-1
4-4 4-1
4-6 4-2
4-7 4-3
TABLES
Welcome
to
Altos
System
V Menu
Port
Configuration
Screen
User
Administration
Screen
Example
of
Creating
a New
User
Account
Setting
Up
Multidrop
SHUTKILL Powerdown
SHUTSAVE Powerdown
SHUTSA
VE
Power
Restoration
Page
Table
Title
1-15 1-1
1-19 1-2
1-19 1-3
3-5 3-1
3-5
3-2
Port
Configuration
Command Line Menu
Center
Screen
Menu
Sample
COMM
Board
Configurations
and
Addresses -386
Series
2000
Sample
COMM
Board Configurations
and
Addresses -386
Series
1000
viii

Chapter 1
Installing and
~etting
Up the
Operating System
1-3
HOW
TO START
1-4 INSTALLATION SUMMARY
1-5 INSTALLING THE OPERATING SYSTEM
1-13 INSTALLING ADDITIONAL
HARD
DISKS
1-14 SETTING
UP
THE PORTS FOR TERMINALS AND
PRINTERS
1-20 Adding a
Port
1-22 Changing a
Port
1-23
Setting
Up a
Printer
1-23
Serial
Printer
1-25
Parallel
Printer
1-26 Remote
Printer
1-27
Testing
a
Printer
1-28 Removing a
Port
from Use
1-28 Exiting
the
Port
Configuration Program
1-29 CREATING AND CHANGING USER ACCOUNTS
1-30
User
Administration Commands
1-31
Creating
a
User
Account
1-33 Guidelines
1-34 CHECKING THE FILE SYSTEM, SETTING THE
DATE, AND STARTING UP
1-36 RECOVERING FROM INTERRUPTED INSTALLATION
1-38 WHERE TO NEXT?
1-1

"(9=~
---------
Installing
and Setting
Up
the Operating System
(BLANK)
1-2

)
Installing and Setting
Up
the Operating System
After you connect
the
components of your Altos computer
system and turn on
the
power,
as
described in
the
Owner's
Guide, you need
to
install the operating system programs
and utilities.
This chapter describes
how
to
install the Altos System V
operating system for
the
first time. This chapter also
describes how
to
set
up
the
system for terminals and
printers,
create
and change user accounts, and
set
up
the
system for other users.
CAUTION
The installation procedures described in this
chapter
erase
all
information
on
the
hard
disk.
If
you
are
upgrading your existing op-
erating
s.yste~
use the procedures described
in
Chapter 2.
HOW TO START
Before you begin:
1. Read
the
product Release Notes for
recent
software
changes (found in
the
Software Product folder).
2. Assemble
the
media you will need for installation:
• Root File System floppy disk
• Utilities cartridge
tape
~,
3. Connect
the
terminal you use for
the
installation
.)
procedures (called
the
"console")
to
the
console port
(also called
port
00
or
port
0) of your Altos com-
puter
system (the Owner's Guide
for
your particular
system has detailed instructions).
1-3

"C!:3=~
-
~-------
Installing and Setting Up the Operating System
4. Optionally,
run
the
system diagnostic
tests.
Because
the
Altos system Is
tested
before
shipping, this
step
is
optional.
However, you
can
use
the
diagnostic
tests
to
detect
problems
that
could occur
as
a result
of
shipment
(such
as
loosening
of
components and connections).
The
tests
take
about one hour.
See
your
Owner's
Guide for Diagnostics instructions.
5. Use
the
copy
utility
on
the
Diagnostics floppy disk
to
copy
the
floppy disk. Be sure
to
·leave
the
wri
te-
protect
tab
on
the
floppy while you make
the
copy.
Always
turn
the
power
off
for
30 seconds
after
using
the
system Diagnostics.
Use a
soft-tip
pen
to
hand copy
the
label information.
Store
the original in a
safe
place.
6. Make sure your
cartridge
tape
is
write-protected
(point
the
arrow on
the
tape
to
SAFE).
If
you
are
not
familiar with handling floppy disks
or
cartridge
tape,
see
the
Owner's
Guide for instructions.
CAUTION
Do
not use
the
original floppy disk
to
install
the
operating system. Always make a copy
of
tbls
and any
other
software
you value.
INSTALLATION SUMMARY
The following is a summary
of
installation procedures.
Detailed procedures
are
in
the
next
section.
1.
Start
up
(boot)
the
system from your copy
of
the
Root
File System floppy disk.
1-4

~=~
--------
Installing and Setting Up the Operating System
2. Install the utIlities from
the
cartridge tape.
3. Optionally,
set
up
the
system for terminals and
printer(s).
4. Create
or
change user login accounts.
5. Install
AOM
and optionally install any communication
software
or
any application software packages.
(Refer
to
the appropriate Altos manual for installa-
tIon instructions.)
6.
Set
up
the
system
to
display "login" on
the
other
terminals so other users
can
use the system.
INSTALLING THE OPERATING SYSTEM
Allow one-half
to
one hour
to
install
the
operating system
for
the
first time.
If
installation
is
interrupted,
the
next
time you work with
the
system a message will indicate
the
system was not shut down properly. In this event,
refer
to
"Recovering from Interrupted Installation"
at
the end
of
this
chapter.
If
you encounter problems
or
error
messages not described
in
this
manual (either during
or
after
software installa-
tion), run the system diagnostIc
tests.
During installation, you
can
correct
a typing error by press-
ing
the
••••••
key
to
back
up
to
the
error. Then
re-
type
the
character.
If
your Altos terminal
has
a screen saver (automatically
blanks
if
there
is no input from
the
keyboard
or
the com-
puter
for
15
minutes), you can
restore
the
display by
pressing any key.
1-5

_cel-_
r
~
,
------
Installing
and SeNing
Up
the Operating System
To
install
the
operating system.,
1.
Tum
on
the
power,
or
with
the
power on,
tum
it
off,
wait
30 seconds, then
tum
it
back on.
You
will see
the
system pass a series
of
power-up
tests.
Prepare
to
press any
character
when you
are
prompted
as follows:
If
your system
doesn't
pass
the
power-up
tests,
make
sure
that
your terminal is properly
set
up and con-
nected
to
the
computer
(it
should
be
connected
to
the
console port).
If
you press any
character
in time, you will see a
menu (Step 2 shows
the
first
two items
of
the
menu).
If
you
don't
press a key in time,
the
system will
attempt
to
boot from the hard disk, which
doesn't
have
the
Boot program on
it.
To
correct
this,
tum
the
RESET/RUN key (on
the
front
of
your system)
to
RESET, then
to
RUN,
and press a key when prompted.
2.
If
you have not already done so, remove
the
card-
·board from
the
floppy disk and
tape
drive.
And,
if
you previously
put
a
write-protect
tab
on your copy
of
the
Root floppy disk, also remove
it.
When
you
see
the
following display (or one similar
to
it),
insert
the
floppy disk into
the
disk drive.
NOTE
Make sure your copy
of
the
Root floppy disk
doesn't
have a
write-protect
tab, so the
sys-
tem can place information on
it.
1-6

\.
l
liIriii'
Installing
and
Setting
Up
the Operating System
Type 2
to
boot from
the
floppy disk. The sequence
looks similar
to
the
screen
that
follows.
The screen displays messages
that
the
system is load-
ing code,
the
size
of
memory, and
the
number
of
users
licensed for
the
system. (This takes several minutes.)
Then you
are
asked
if
you want
to
check the file sys-
tem. Type y.
3. Next, the Welcome
to
Altos System V
menu
appears as
shown in Figure 1-1.
1-7

,.re=~
------
---
Installing
and Setting
Up
the
Operating
System
Figure 1-1. Welcome
to
Altos System V
Menu
Type a and press
I@d.
4. The screen displays:
Because this is
the
first
time
you're
installing the
operating system,
the
hard disk does not have any
data
on
it.
Type y and press
l@mL
1-8
Table of contents