*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> share_inst (1)              
Title
Content
Arch
Section
 

Contents


SHARE_INST(1M)							SHARE_INST(1M)


NAME    [Toc]    [Back]

     share_inst, client_inst, clone_client - diskless software installation
     tools

SYNOPSIS    [Toc]    [Back]

     share_inst	-r release [ -d	]
     client_inst -r release -c class -h	host [ -d ]
     clone_client -r release -c	class -f hostfile -clone clone-root

DESCRIPTION    [Toc]    [Back]

     Share_inst	, client_inst ,	and clone_client are tools that	install	the
     system software for diskless workstations.

     Share_inst	installs the portion of	the IRIX operating system that
     diskless workstations can share.  This shared software is known as	the
     share tree. A share tree can contain only one IRIX	release; a separate
     share tree	must be	installed for each additional IRIX release that
     clients require.

     Client_inst installs the software that is used exclusively	by an
     individual	diskless client.  This software, known as the client tree,
     contains the non-shareable	portions of an IRIX release, such as
     configuration files and other private files that pertain only to a
     particular	client.

     Clone_client allows you to	install	multiple client	trees at once.	By
     feeding it	a hostfile, one	can install many trees with no interaction.
     Also, clone_root can be either a share tree or a client tree.

     For each IRIX release, share_inst needs a parameter file,
     /var/boot/share.dat, to supply the	necessary configuration	information.
     Share.dat is a template file: /var/boot contains a	working	copy of
     share.dat for each	IRIX release that the diskless server supports.	 The
     working copy of share.dat for a given share tree is assigned the name of
     the IRIX release that the share tree contains.

     Since share.dat is	a shell	script that is invoked from share_inst,	it
     should always be executable.  When	modifying the file, a good practice is
     to	change only the	strings	within the double quotes.

     share.dat contains	the following variables:

     DISKLESS	    directory prefix for the share root, client	root, and swap
		    root

     SHARE	    directory name for share root

     SERVER_NIS	    indicates whether NIS is used for name lookups during
		    installation.  This	option will not	work with non-SGI NIS
		    masters.  The bootparam information	which gets set in the
		    SGI	NIS master takes time to propagate back	to the
		    diskless server.



									Page 1






SHARE_INST(1M)							SHARE_INST(1M)



     The client.dat file performs that same function for client_inst as
     share.dat performs	for share_inst.	Client.dat contains parameters that
     configure a specific class	or workstation architecture.

     The client.dat file contains the following	variables:

     CLROOT	    directory name for client root

     SWAP	    name of the	directory where	the swap file will be created.
		    The	swap directory must be on the same server as client
		    root.

     SWAPSIZE	    size of swap file.	The default is set to 20 MB.

     NISDOMAIN	    NIS	domain of client if the	client's domain	is different
		    than the server's

     CPUARCH	    type of CPU	architecture on	clients	in this	class.	If the
		    supporting share tree is configured	for this class of
		    clients exclusively, this variable may be set in
		    share.dat.

     CPUBOARD	    type of cpu	board on the clients in	this class.  If	the
		    supporting share tree is configured	for this class of
		    clients exclusively, this variable may be set in
		    share.dat.

     GFXBOARD	    type of graphics board on the clients in this class.  If
		    the	supporting share tree is configured for	this class of
		    clients exclusively, this variable may be set in
		    share.dat.

     MACH	    type of machine tag	assigned to this clients in this
		    class.  If the supporting share tree is configured for
		    this class of clients exclusively, this variable may be
		    set	in share.dat.

     VIDEO	    type of video option on clients in this class.  If the
		    supporting share tree is configured	for this class of
		    clients exclusively, this variable may be set in
		    share.dat.

     Both share_inst and client_inst are shell scripts that call inst(1M) to
     perform the software installation.	 They also modify files, like
     /etc/fstab	and /etc/hosts,	in the resulting trees,	so the diskless
     workstation can be	brought	up correctly.  When share_inst creates the
     share tree, it populates the tree with the	shareable files.  By
     definition, files whose pathnames begin with /usr,	/sbin, /lib, and
     /stand are	shareable.  When client_inst creates the client	tree, it makes
     a swap file and modifies client boot parameters.  It also exports
     necessary directories to the appropriate host.




									Page 2






SHARE_INST(1M)							SHARE_INST(1M)


OPTIONS    [Toc]    [Back]

     -r	release
	       Using release release. The file release.dat should exist	in the
	       /var/boot directory.

     -c	class  Using class class. The file class.dat should exist in the
	       /var/boot directory.

     -h	host   Indicates the client tree is created for	workstation named
	       host. The host must be a	valid hostname,	i.e. it	should have
	       already been assigned an	IP address.  This parameter does not
	       have any	effect when creating the share tree.

     -f	hostfile
	       A file containing a list	of valid hostnames

     -clone clone-root
	       Indicates that the client tree is to be created by cloning an
	       existing	client tree or share tree clone-root is	the full
	       pathname	of the source client/share tree.

     -d	       To remove the diskless tree.  The default is to install the
	       tree.

EXAMPLE    [Toc]    [Back]

     /var/boot/share_inst -r 6_5

     will create a share tree for a specific release 6_5.  The
     /var/boot/6_5.dat file should exist before	you run	the command.

     /var/boot/client_inst -r 6_5 -c RACER -h goldfinger

     will create a client tree for class RACER and machine goldfinger.	The
     /var/boot/RACER.dat file should exist before you run the command.

NOTE    [Toc]    [Back]

     Please see	the Diskless System Administration Guide for more details.
     This man page was not intended to give enough information to perform a
     complete install.	The NFS	release	notes contain additional installation
     information not included in the guide.

FILES    [Toc]    [Back]

     /var/boot/share_inst	   Share tree install script
     /var/boot/share_setup	   Script to create share tree config files
     /var/boot/share.dat	   Template for	release.dat
     /var/boot/client_inst	   Client tree install script
     /var/boot/client_setup	   Script to create client tree	config files
     /var/boot/client.dat	   Template for	class.dat
     /var/boot/clone_client	   Tree	cloning	script
     /var/boot/verify		   Script to check *.dat files





									Page 3






SHARE_INST(1M)							SHARE_INST(1M)


SEE ALSO    [Toc]    [Back]

      
      
     inst(1M), share_setup(1M),	yp_bootparam(1M)


									PPPPaaaaggggeeee 4444
[ Back ]
 Similar pages
Name OS Title
cl_init IRIX init program for diskless software installation
swcopy HP-UX install and configure software products; software products for subsequent installation or distribution; respec
swinstall HP-UX install and configure software products; software products for subsequent installation or distribution; respec
inst IRIX software installation tool
installf IRIX add a file to the software installation database
roboinst IRIX automatic software installation tool
info HP-UX diskless client configuration information file
sd HP-UX Software Distributor, commands to create, distribute, install, monitor, and manage software
it Tru64 configure a system after installation
sysinstall FreeBSD system installation and configuration tool
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service