DOMAIN NFS Software Release Document
Part No. 010415
Revision 00
This document describes the installation
procedure and current bugs and
limitations of the DOMAIN implementation
of the NFS protocol.
APOLLO COMPUTER INC.
330 Billerica Road
Chelmsford, Massachusetts 01824
Copyright c 1987 Apollo Computer Inc.
All rights reserved. Printed in U.S.A.
First Printing: May, 1987
This document was formatted using the FMT tool distributed with the DOMAIN
computer system.
APOLLO and DOMAIN are registered trademarks of Apollo Computer Inc.
AEGIS, DGR, DOMAIN/BRIDGE, DOMAIN/DFL-100, DOMAIN/DQC-100, DOMAIN/Dialogue,
DOMAIN/IX, DOMAIN/Laser-26, DOMAIN/PCI, DOMAIN/SNA, D3M, DPSS, DSEE, GMR, and
GPR are trademarks of Apollo Computer Inc.
NFS is a registered trademark of Sun Microsystems Inc.
Apollo Computer Inc. reserves the right to make changes in specifications and
other information contained in this publication without prior notice, and the
reader should in all cases consult Apollo Computer Inc. to determine whether
any such changes have been made.
THE TERMS AND CONDITIONS GOVERNING THE SALE OF APOLLO COMPUTER INC. HARDWARE
PRODUCTS AND THE LICENSING OF APOLLO COMPUTER INC. SOFTWARE CONSIST SOLELY OF
THOSE SET FORTH IN THE WRITTEN CONTRACTS BETWEEN APOLLO COMPUTER INC. AND ITS
CUSTOMERS. NO REPRESENTATION OR OTHER AFFIRMATION OF FACT CONTAINED IN THIS
PUBLICATION, INCLUDING BUT NOT LIMITED TO STATEMENTS REGARDING CAPACITY,
RESPONSE-TIME PERFORMANCE, SUITABILITY FOR USE OR PERFORMANCE OF PRODUCTS
DESCRIBED HEREIN SHALL BE DEEMED TO BE A WARRANTY BY APOLLO COMPUTER INC. FOR
ANY PURPOSE, OR GIVE RISE TO ANY LIABILITY BY APOLLO COMPUTER INC.
WHATSOEVER.
IN NO EVENT SHALL APOLLO COMPUTER INC. BE LIABLE FOR ANY INCIDENTAL,
INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING BUT NOT
LIMITED TO LOST PROFITS) ARISING OUT OF OR RELATING TO THIS PUBLICATION OR
THE INFORMATION CONTAINED IN IT, EVEN IF APOLLO COMPUTER INC. HAS BEEN
ADVISED, KNEW OR SHOULD HAVE KNOWN OF THE POSSIBILITY OF SUCH DAMAGES.
THE SOFTWARE PROGRAMS DESCRIBED IN THIS DOCUMENT ARE CONFIDENTIAL INFORMATION
AND PROPRIETARY PRODUCTS OF APOLLO COMPUTER INC. OR ITS LICENSORS.
Contents
Section
CHAPTER 1 OVERVIEW OF DOMAIN NFS SOFTWARE. . . . . . . . . . . . . . . . 1-1
CHAPTER 2 SOFTWARE INSTALLATION PROCEDURES . . . . . . . . . . . . . . . 2-1
2.1 Conventions and Terminology . . . . . . . . . . . . . 2-1
2.2 Planning the Installation . . . . . . . . . . . . . . 2-2
2.3 Additional Information About Administrative-mode
Installations . . . . . . . . . . . . . . . . . . . . 2-3
2.4 Installation Procedure. . . . . . . . . . . . . . . . 2-4
2.4.1 Administrative Mode . . . . . . . . . . . . . 2-4
2.4.2 User Mode . . . . . . . . . . . . . . . . . . 2-10
CHAPTER 3 BUGS AND LIMITATIONS . . . . . . . . . . . . . . . . . . . . . 3-1
3.1 Software Bugs and Limitations . . . . . . . . . . . . 3-1
3.2 Documentation Errata. . . . . . . . . . . . . . . . . 3-2
Contents iii
CHAPTER 1
OVERVIEW OF DOMAIN NFS SOFTWARE
WARNING: The system administrator for your site must establish uniform user
and group IDs across the networks as described in Appendix B of
Using__NFS__on__the__DOMAIN__Network before anyone installs NFS
software.
The DOMAIN implementation of the NFS (Network File System) protocol allows
users of DOMAIN workstations and other systems to transparently access each
other's files.
The DOMAIN implementation derives several advantages from its close
association with the DOMAIN/IX and AEGIS operating systems, advantages not
found in other NFS implementations.
For example, the DOMAIN NFS software lets users at foreign systems mount the
DOMAIN network root directory (//) to gain access to remote filesystems
anywhere on a DOMAIN network. Users at DOMAIN workstations can similarly
mount foreign filesystems in the network root directory and thereafter share
the same names when accessing those filesystems.
Another DOMAIN NFS feature is that remote filesystems mounted by a DOMAIN
workstation remain mounted until you explicitly unmount them. In addition,
the DOMAIN NFS software uses dedicated gateway objects as mount points for
remote filesystems instead of the directories used by other NFS
implementations.
Note that to successfully install NFS software on a DOMAIN network as
described in Chapter 2 of this document, you must have a DOMAIN gateway node
connecting your site's DOMAIN network to a foreign network supporting one or
more systems. In addition, you must perform an Administrator install (see
sections 2.4.1 and 2.4.2 for instructions) before you can perform a Client
install; a Client install requires the software made available by an
Administrator install in the /etc directory. Furthermore, You must perform
Administrator installs on the primary and all slave DOMAIN/IX system
administration nodes in the DOMAIN network (see System_Administration_for
DOMAIN/IX_BSD4.2 or System_Administration_for__DOMAIN/IX__System__V for more
information about these nodes); take care to execute the Administrator
installs ON these nodes and NOT through links to the /etc directories of
these nodes.
1-1 DOMAIN NFS Version 1.0
CHAPTER 2
INSTALLATION PROCEDURE
This chapter describes how to install the NFS software on the DOMAIN
network. You can add this software to a user node (one equipped with monitor
and keyboard) or a DOMAIN server processor (DSP) that is running the software
listed below:
Software Release 9.5
DOMAIN/IX, 9.5
TCP/IP, Version 3.0
If the user node or DSP is not running the specified software or more recent
versions, follow the appropriate software update procedures as described in
Installing_DOMAIN_Software (Order No. 008860) or in the appropriate release
notes.
NOTE: The user node or DSP must have a minimum of 4000 blocks of
available disk space for a successful installation of this
software.
2.1 Conventions and Terminology
Before you start, make sure you understand these terms and conventions:
Work Node The user node at which you perform the installation
procedure.
Target The directory into which you're installing software. The
target can be a node entry directory (for example, //target)
or any subdirectory (for example, //target/product). If the
target is on a user node, then the work node and the user
node can be the same node.
NOTE: When you are installing software to update a
diskless node, the target is the node entry
directory of the partner node. If the target of
2-1 DOMAIN NFS Version 1.0
such an installation already contains the software,
then you do not need to install it.
Secure network A network that uses a registry of user accounts and access
control lists (ACLs) to control log-in privileges and access
to files and directories. Note that an open network does not
use a registry or ACLs.
Source area An on-line master area of DOMAIN software. An administrator
installs software from the distribution media into the source
area and users install software from the source area over the
network. The source area can be a node's entry directory or
any subdirectory.
Source media The media (floppy disks, magnetic tape, cartridge tape, or
another node in the network) that contains the software.
< > Angle brackets ( < > ) enclose the name of a key on the
keyboard.
2.2 Planning the Installation
There is one installation procedure. You can use the procedure in one of
three modes: ADMINISTRATIVE mode, USER mode, or SPECIAL-CASE mode.
ADMINISTRATIVE mode creates a source area by copying the INSTALL program and
the new software from the distribution media to the target. You use the
administrative mode when no source area for this release exists in the
network. See Section 2.3 for more information about administrative-mode
installations.
USER mode involves copying your new software from a source area onto another
node in the network; it's the simplest and most commonly used mode. You can
install in user mode only AFTER an administrative-mode installation has
initialized the source area with the INIT_SOURCE program.
Two default conditions apply to a user-mode installation. The defaults are:
o The INSTALL program automatically copies the new software over the
network from the initialized source area, instead of asking you to
specify the source area.
o The INSTALL program uses the SID "user.sys_admin" during the
installation, rather than your own login SID.
To install in user mode, get the source area's pathname from your system
administrator, then go on to Section 2.4.2.
DOMAIN NFS Version 1.0 2-2
SPECIAL-CASE mode involves special cases in which you need to override the
user-mode defaults. The special cases are:
o You want to install software from an initialized source area on the
network, but your own login SID gives you more rights to a target's
protected directories than the default SID "user.sys_admin"
o You want to install software from a source other than an initialized
source area (for example, source media)
o You want to install additional software in a source area that was
initialized during a previous administrative-mode installation
The installation procedure enters special-case mode when you invoke the
INSTALL program with its -my_sid option. Specifying this option overrides
the user-mode defaults, which means that the INSTALL program (1) uses your
own login SID instead of "user.sys_admin" and (2) prompts for source media
rather than automatically copying the software over the network from an
initialized source area. In all other respects, special-case mode behaves
like one of the other two modes of installation (your choice of source
determines which one).
If you want to install software from an initialized source area on the
network while using your own login SID, follow the directions for user-mode
installations in Section 2.4.2. These directions include provisions for
installing software in special-case mode.
If you want to install software from a source other than an initialized
source area, or you want to install additional software in a previously
initialized source area, follow the directions for an administrative-mode
installation in Section 2.4.1. These directions also include provisions for
installing software in special-case mode.
2.3 Additional Information About Administrative-mode Installations
The target of an administrative-mode installation generally serves as the
source for subsequent user-mode installations (the administrative-mode target
pathname is therefore the same as the user-mode source pathname). User-mode
installations use both the INSTALL program and the software stored in the
source area.
ADMINISTRATIVE MODE USER MODE
SOURCE --------------------> TARGET (user node or DSP)
______
(media) SOURCE -------------------> TARGET
2-3 DOMAIN NFS Version 1.0
Your choice of target for an administrative-mode installation depends on
whether you want the target node to RUN the software as well as act as a
SOURCE for the software. If you also want the node to run the software, make
the target the node's entry directory (for example, //ergo). If you just
want the node to contain the software, you should make the target a
subdirectory (for example, //ergo/product/source_area). In either case,
users should then use the target of your administrative-mode installation as
their source area.
You can install different optional software products into the same source
area or into separate source areas. Whichever route you take, you can then
selectively install optional products on user nodes or DSPs from the source
area(s).
If you have a secure network, you must have system administrator rights to
install in administrative mode. Also, during the procedure you must
initialize the source area by running the INIT_SOURCE program. This program
marks the installation program in the source area with special privileges for
subsequent user-mode installations, such as use of the SID "user.sys_admin"
during installation. The INSTALL program can then install software in
protected system directories, even though the user running the program does
not have rights to modify these directories. In open networks, you create a
source area but you don't run INIT_SOURCE, since all users have rights to
modify their system directories.
2.4 Installation Procedure
The following sections describe the administrative mode and the user mode of
installation. To install software in special-case mode, consult Section 2.2
to determine which set of instructions you should follow.
2.4.1 Administrative Mode
NOTE: You can enter "q" or "quit" at any prompt in the INSTALL program to
abort the installation and return to the Shell.
1. If you intend to create a source area for future installations, log
on to a work node using a system administrator account (for example,
my_name.sys_admin.%.%). Otherwise, log on using your own account
(for example, my_name.%.%.%).
2. Set your working directory to the installation target. This target
will become the source area for user installations. It can be a node
DOMAIN NFS Version 1.0 2-4
entry directory (like //ergo) or it can be any subdirectory created
prior to the installation (like //ergo/product/source_area). For
example:
wd //ergo
3. Insert the source media into the drive and enter the RBAK command
shown below. If you are using a tape cartridge, use the CT option
shown in the example. If you are using a magnetic tape, use the M0
(Mzero) option. If you are using a floppy disk, use the F0 (Fzero)
option.
NOTE: If you are using multiple floppy disks, insert the floppy
disk with the numeral 1 at the end of its label (for
example, "FLP8_product_n.n_1").
All of the RBAK commands shown below create an INSTALL directory on
the target and write the installation software to the directory.
When entering the RBAK command, use lower-case characters to ensure
visibility of the install directory in case-sensitive environments.
Note that you can leave the source media in the drive for use in a
later step; if you remove the source media after executing the RBAK
command, the INSTALL program will later prompt you to re-insert the
media.
/com/rbak -dev ct -f 1 install -as install -L -ms -force -sacl -du
/com/rbak -dev m0 -f 1 install -as install -L -ms -force -sacl -du
/com/rbak -dev f0 -f 1 install -as install -L -ms -force -sacl -du
4. Set your working directory to the INSTALL directory on the target.
For example:
wd //ergo/install
5. Execute the INSTALL program and follow the prompts. If you are
installing software in special-case mode, use the -my_sid option.
For ADMINISTRATIVE MODE, type:
install
For SPECIAL-CASE MODE, type:
install -mysid
2-5 DOMAIN NFS Version 1.0
6. The program may prompt you to enter an installation type, based on
what products already exist in the source area. If it does, answer
OPT and proceed. For example:
****************************************
* SOFTWARE INSTALLATION -- Version n.n *
****************************************
Software installation TYPES are:
STD -- Install standard software
RESTART -- Restart the software installation
ACL -- Set ACLs for existing software
CLEANUP -- Run the Cleanup Procedure for ADD MODE installations
OPT -- Install optional software (e.g., Pascal, FORTRAN)
Please enter installation TYPE: OPT
7. When the program displays the names of one or more optional
products, type the name "NFS" as shown in the sample menu below.
Name Description Disk Blocks Needed
(Adding New Software)
NFS Network File System 4000
OTHER If the optional product that you would like to install
is not listed above, choose OTHER.
*Note: When you choose OTHER, you are asked a few questions
then shown a display of Apollo's optional products. Check
with your system administrator to determine which products
your site has purchased and in which directory these
products have been installed.
Enter the name of a single product you would like to install: NFS
DOMAIN NFS Version 1.0 2-6
8. The INSTALL program then displays the following text.
*********************************************
* *
* A NODE MUST HAVE THE FOLLOWING SOFTWARE *
* (SPECIFIED VERSION OR LATER) TO RUN NFS. *
* *
* SOFTWARE RELEASE 9.5 *
* DOMAIN/IX, 9.5 *
* TCP/IP, VERSION 3.0 *
* *
*********************************************
If you specified a node's entry directory (for example, //ergo) as
your installation target in Step 2 and the node isn't running the
indicated software, then terminate the INSTALL program and install
the specified (or more recent) versions of the software. To
terminate the INSTALL program, type "quit" and press <RETURN>.
If the installation target does have the indicated software, or if
you specified a subdirectory (for example, //ergo/product) in Step
2, then proceed to the next step.
9. When prompted for the name of the target, enter the appropriate
pathname (that is, the node entry directory or subdirectory that you
specified in Step 2). For example:
The TARGET is the node or subdirectory on which you are installing
software. (e.g., '//my_node' or '//my_node/subdirectory')
Enter Target: //ergo
10. The INSTALL program asks if you are installing NFS software on an
NFS client node; these nodes run a subset of the NFS software and
link to a DOMAIN/IX system administration node for the rest. See
Chapter 1 of this document for important information about client
and administrator installs.
If you are installing software on an NFS client node, answer "Y" or
"YES." If you are creating a source area and/or installing the
software on a DOMAIN/IX system administration node, answer "N" or
"NO."
Is the installation to //ergo a CLIENT install ?
Enter YES or Y or NO or N :
2-7 DOMAIN NFS Version 1.0
11. If you answered "N" or "NO" in the previous step, the INSTALL
program asks if you are installing NFS software on a DOMAIN/IX
system administration node (these nodes receive all of the NFS
software). If you are installing the software on a DOMAIN/IX system
administration node and/or creating a source area, answer "Y" or
"YES"; otherwise, answer "N" or "NO" to terminate the INSTALL
program.
Is the installation to //ergo a ADMINISTRATOR install ?
Enter YES or Y or NO or N :
12. The INSTALL program prompts for the source media. Enter your
choice.
Source MEDIA is one of:
CTAPE -- Cartridge Tape
MTAPE -- Magnetic Tape
FLOPPY -- 8" or 5 1/4" Floppies
NET -- An area on the network with valid Software
Enter Source Media:
13. If you are installing the software over the network, then the
INSTALL program prompts you for the source area.
The SOURCE AREA is the node or subdirectory from which you are
copying software. (e.g., '//node' or '//node/subdirectory')
Enter Source Area:
14. The INSTALL program may ask you to insert the media into the drive.
If it does, insert the media and press <RETURN>.
15. The INSTALL program installs the software, listing each file it
copies from the source media. If a correct version of a file already
exists in the target area, the program displays a message similar to
the following example and proceeds to the next file:
//ergo already has the correct version of //ergo/lib/gprlib .
Therefore, no new copy will be installed.
If the software resides on multiple floppy disks, the program
prompts you to mount (that is, insert) the next disk and to press
<RETURN> to continue.
DOMAIN NFS Version 1.0 2-8
16. When the INSTALL program finishes installing the software, it
displays the following message.
To run the NFS server on the target node
1) Issue the following command from the target node:
/com/cpf /sys/nfs/etc.exports.template `node_data/etc.exports -r
2) Edit the target node's `node_data/etc.exports file. Follow the
directions in the file to allow remote nodes to mount all or part
of the DOMAIN // filesystem.
3) Add the following DM commands in the specified order to the
target node's startup file (e.g., `node_data/startup.19l):
cps /etc/portmap -n portmap
cps /etc/mountd -n mountd
cps /etc/nfsd -n nfsd
17. The INSTALL program then displays the following menu:
Options:
RERUN -- There were errors in the transcript
pad and you wish to rerun the installation.
FINISH -- The installation ran to completion error free.
There is no additional optional software you
wish to install.
CONTINUE -- Install additional optional software.
If you encountered any errors during the installation, correct the
problem(s) and select RERUN. To locate error messages issued during
installation, search backwards for the characters @? (an at sign
followed by a question mark) in the installation's transcript pad.
If there were no errors, choose CONTINUE or FINISH. Selecting
CONTINUE brings you back to the beginning of the INSTALL program;
selecting FINISH terminates the program. If you were installing
software from magnetic tape, cartridge tape, or floppy disks, you
can now remove the media from the drive.
18. If you have a secure network and you want the target of your
installation to be used as a source area for future installations,
run the INIT_SOURCE program (also run the program if you are adding
software to a previously initialized source area). You must be
logged in as a system administrator to perform this step.
2-9 DOMAIN NFS Version 1.0
Invoke INIT_SOURCE at the Shell prompt. When prompted, enter the
pathname of the new source area (which is currently the target of
your administrative-mode installation). Here is an example:
initsource
Please enter the name of the SOURCE AREA
for your network (e.g., '//NODE/SOURCE_AREA'):
//ergo
The source area for your network
has been set to: //ergo
19. Perform this step only after completing an error-free installation
and selecting FINISH.
a. Use the Display Manager SHUT command to shut down the target
node.
<CMD> SHUT <RETURN>
b. After the SUCCESSFUL SHUTDOWN message and the > prompt
appear, reboot the node by typing the following at the
prompt:
> RE <RETURN>
> <RETURN>
MD REV xx/xx/xx
> EX AEGIS <RETURN>
This is the end of the administrative-mode installation procedure.
2.4.2 User Mode
NOTE: You can enter "q" or "quit" at any prompt in the INSTALL program to
abort the installation and return to the Shell.
1. Log on to a work node using your own account (for example,
my_name.%.%.%).
DOMAIN NFS Version 1.0 2-10
2. Set your working directory to the INSTALL directory in the source
area (if necessary, ask your system administrator for the pathname).
For example:
wd //ergo/install
3. Execute the INSTALL program and follow the prompts. If you are
installing software in special-case mode, use the -my_sid option.
For USER MODE, type:
install
For SPECIAL-CASE MODE, type:
install -mysid
4. The program may prompt you to enter an installation type, based on
what products already exist in the source area. If it does, answer
OPT and proceed. For example:
****************************************
* SOFTWARE INSTALLATION -- Version n.n *
****************************************
Software installation TYPES are:
STD -- Install standard software
RESTART -- Restart the software installation
ACL -- Set ACLs for existing software
CLEANUP -- Run the Cleanup Procedure for ADD MODE installations
OPT -- Install optional software (e.g., Pascal, FORTRAN)
Please enter installation TYPE: OPT
2-11 DOMAIN NFS Version 1.0
5. When the program displays the names of one or more optional
products, type the name "NFS" as shown in the sample menu below.
Name Description Disk Blocks Needed
(Adding New Software)
NFS Network File System 4000
OTHER If the optional product that you would like to install
is not listed above, choose OTHER.
*Note: When you choose OTHER, you are asked a few questions
then shown a display of Apollo's optional products. Check
with your system administrator to determine which products
your site has purchased and in which directory these
products have been installed.
Enter the name of a single product you would like to install: NFS
6. The INSTALL program then displays the following text.
*********************************************
* *
* A NODE MUST HAVE THE FOLLOWING SOFTWARE *
* (SPECIFIED VERSION OR LATER) TO RUN NFS. *
* *
* SOFTWARE RELEASE 9.5 *
* DOMAIN/IX, 9.5 *
* TCP/IP, VERSION 3.0 *
* *
*********************************************
If your installation target is a node's entry directory (for
example, //ergo) and the node isn't running the indicated software,
then terminate the INSTALL program and install the specified (or
more recent) versions of the software. To terminate the INSTALL
program, type "quit" and press <RETURN>.
If your installation target does have the indicated software, or if
it is a subdirectory (for example, //ergo/product), then proceed to
the next step.
7. When prompted for the name of the target, enter the appropriate
pathname. For example:
The TARGET is the node or subdirectory on which you are installing
software. (e.g., '//my_node' or '//my_node/subdirectory')
Enter Target: //ergo
DOMAIN NFS Version 1.0 2-12
8. The INSTALL program asks if you are installing NFS software on an
NFS client node; these nodes run a subset of the NFS software and
link to a DOMAIN/IX system administration node for the rest. See
Chapter 1 of this document for important information about client
and administrator installs.
If you are installing the software on an NFS client node, answer "Y"
or "YES." If you are installing the software on a DOMAIN/IX system
administration node, answer "N" or "NO."
Is the installation to //ergo a CLIENT install ?
Enter YES or Y or NO or N :
9. If you answered "N" or "NO" in the previous step, the INSTALL
program asks if you are installing NFS software on a DOMAIN/IX
system administration node (these nodes receive all of the NFS
software). If so, answer "Y" or "YES"; otherwise, answer "N" or
"NO" to terminate the INSTALL program.
Is the installation to //ergo a ADMINISTRATOR install ?
Enter YES or Y or NO or N :
10. The INSTALL program may prompt for the source media. If so, enter
NET.
Source MEDIA is one of:
CTAPE -- Cartridge Tape
MTAPE -- Magnetic Tape
FLOPPY -- 8" or 5 1/4" Floppies
NET -- An area on the network with valid Software
Enter Source Media: net
11. The INSTALL program may prompt for the source area. If so, enter
the pathname (if you don't know it, ask your system administrator).
For example:
The SOURCE AREA is the node or subdirectory from which you are
copying software. (e.g., '//node' or '//node/subdirectory')
Enter Source Area: //ergo
12. The INSTALL program installs the software, listing each file it
copies from the source media. If a correct version of a file already
exists in the target area, the program displays a message similar to
the following example and proceeds to the next file:
//ergo already has the correct version of //ergo/lib/gprlib .
Therefore, no new copy will be installed.
2-13 DOMAIN NFS Version 1.0
13. During an Administrator install (i.e., if you responded "yes" in
Step 9), the INSTALL program displays the following message after it
finishes installing the software.
To run the NFS server on the target node
1) Issue the following command from the target node:
/com/cpf /sys/nfs/etc.exports.template `node_data/etc.exports -r
2) Edit the target node's `node_data/etc.exports file. Follow the
directions in the file to allow remote nodes to mount all or part
of the DOMAIN // filesystem.
3) Add the following DM commands in the specified order to the
target node's startup file (e.g., `node_data/startup.19l):
cps /etc/portmap -n portmap
cps /etc/mountd -n mountd
cps /etc/nfsd -n nfsd
14. The INSTALL program then displays the following menu:
Options:
RERUN -- There were errors in the transcript
pad and you wish to rerun the installation.
FINISH -- The installation ran to completion error free.
There is no additional optional software you
wish to install.
CONTINUE -- Install additional optional software.
If you encountered any errors during the installation, correct the
problem(s) and select RERUN (if necessary, consult your system
administrator for assistance). To locate error messages issued
during installation, search backwards for the characters @? (an at
sign followed by a question mark) in the installation's transcript
pad.
If there were no errors, choose CONTINUE or FINISH. Selecting
CONTINUE brings you back to the beginning of the INSTALL program;
selecting FINISH terminates the program.
DOMAIN NFS Version 1.0 2-14
15. Perform this step only after completing an error-free installation
and selecting FINISH.
a. Use the Display Manager SHUT command to shut down the target
node.
<CMD> SHUT <RETURN>
b. After the SUCCESSFUL SHUTDOWN message and the > prompt
appear, reboot the node by typing the following at the
prompt:
> RE <RETURN>
> <RETURN>
MD REV xx/xx/xx
> EX AEGIS <RETURN>
This is the end of the user-mode installation procedure.
2-15 DOMAIN NFS Version 1.0
CHAPTER 3
BUGS AND LIMITATIONS
3.1 Software Bugs and Limitations
o You can use DOMAIN Pascal I/O statements to access a file on a
foreign system only if your program declares the file variable to be
of type "text." Similarly, you can use DOMAIN FORTRAN I/O statements
to access a file on a foreign system only if your program opens the
file as "sequential formatted." The next release of the language
software removes these limitations.
o None of the AEGIS and DOMAIN/IX Shells can execute a Shell script
stored on a foreign system.
o The AEGIS ld -a command doesn't list your access rights to files on
foreign systems. Use the DOMAIN/IX ls command to obtain this
information.
o When accessing links stored in foreign filesystems, use DOMAIN/IX
rather than AEGIS commands. AEGIS commands do not resolve links
stored in a foreign filesystem, though they can resolve links stored
in the DOMAIN filesystem that point to files on foreign systems.
o If a program on a foreign host that's running a UNIX operating system
executes the following sequence of system calls to reference a file
on a DOMAIN workstation:
open(file); Open the file
chmode(file, 0); Change its protection so no one can access it
write(file, ...); Write data into file
then the write call fails.
o A pathname containing an ellipsis (...) wildcard and an NFS mount
point (for example, //node1/dir1/foreign_node_mtpt/...) currently
sends the wildcard processor into an infinite loop. Until we fix
3-1 DOMAIN NFS Version 1.0
this bug in a future release, avoid using the ellipsis wildcard and
an NFS mount point in the same pathname.
3.2 Documentation Errata
The manual Using__NFS__on__the__DOMAIN__Network (no. 010414, rev. 00) makes
several erroneous references to DOMAIN/IX System V documentation and
software. Only DOMAIN/IX BSD4.2 users can use the mount, umount, showmount,
rpcinfo, and nfsstat DOMAIN NFS commands. Though DOMAIN/IX System V users
can access files and directories by using existing mount points (i.e.,
gateway objects created in the DOMAIN/IX BSD4.2 environment), they cannot use
the DOMAIN NFS software to create, delete, or otherwise affect such mount
points.
DOMAIN NFS Version 1.0 3-2