Index Index for
Section 8
Index Alphabetical
listing for C
Bottom of page Bottom of
page		 

clu_create(8)


NAME

  clu_create - Create a cluster


SYNOPSIS

  /usr/sbin/clu_create [-c member_conf_file]


FLAGS

  -c member_conf_file
	    When invoked with the -c flag, clu_create runs in non-interactive
	    mode, taking its input from the specified configuration file.


DESCRIPTION

  The clu_create command creates a cluster. You must be root to run this
  command.

  When run without the -c flag, the command is interactive. It prompts for
  the information required to perform each task, displays the entered
  information so you can check its accuracy, and, only after you confirm that
  the information is correct, modifys the system.

  The command provides online help. To display a help message, type the word
  help or a question mark, ?, at any prompt. The command also writes a log
  file, /cluster/admin/clu_create.log.

  The first time clu_create is run, it creates a configuration file in
  /cluster/admin/.membern.cfg; for example, .member1.cfg. This configuration
  file contains a list of variable=value pairs. Each time clu_create is run,
  it appends the latest configuration data to this file in the /cluster/admin
  directory.

  When invoked with the -c flag, clu_create runs in non-interactive mode,
  taking its input from a configuration file.  If clu_create -c encounters a
  fatal error, it exits. In addition, no interactive options are presented.
  For example, clu_create -c does not offer to reboot the system; you must
  perform a manual reboot after the command completes.

  The following is an example of a clu_create configuration file:

       # clu_create saved configuration values:
       # date: Tue Oct 26 11:01:01 EDT 1999 hostname pepicelli.zk3.dec.com
       # Previously saved value in this file have been converted to comment
       # lines
       clu_alias_ip=16.140.112.209
       clu_boot_dev=dsk9
       clu_ic_dev=mc0
       clu_ic_host=pepicelli-mc0
       clu_ic_ip=10.0.0.1
       clu_mem_votes=1
       clu_memid=1
       clu_name=deli.zk3.dec.com
       clu_quorum_dev=dsk7
       clu_quorum_votes=1
       clu_root_dev=dsk1b
       clu_usr_dev=dsk2c
       clu_var_dev=dsk3c

  A configuration file makes it easy to re-create an existing single-member
  cluster. However, the information in the configuration file must be
  accurate; for example, host names, IP addresses, and disk dsk names.
  Because disk devices are named in order of discovery, using a configuration
  file implies that you run clu_create -c on the same system it was run on
  previously and that the storage configuration has not changed. (The date:
  comment line in the configuration file contains the date that clu_create
  was run and the name of the host on which it was run.)

  Both clu_create and clu_add_member write configuration files to
  /cluster/admin. Because there is no way to discern the type of file from
  the .membern.cfg filename, look at the comments to determine whether
  clu_create or clu_add_member created the file.

  The configuration files are generated by programs and read by programs. In
  general, do not manually edit configuration files.  We recommend that if
  you use the -c flag, you run clu_create on a copy of the configuration
  file, not on the original. The following example show how you might use
  clu_create -c after booting the operating system on which you created the
  cluster:

       # cp /cluster/admin/.member1.cfg /usr/tmp/.member1.cfg
       # /usr/sbin/clu_create -c /usr/tmp/.member1.cfg
       or
       # cd /usr/tmp
       # /usr/sbin/clu_create -c .member1.cfg

  The TruCluster Server Hardware Configuration manual describes how to set up
  and configure the processors, interconnects, and storage for a cluster.
  The TruCluster Server Software Installation manual provides detailed
  information on installing the TruCluster software and creating a cluster.
  Refer to these manuals before running clu_create or clu_create -c.

  The following list outlines the steps needed to create a new TruCluster
  Server cluster:

   1.  Using the information in the TruCluster Server Hardware Configuration
       manual, configure system and storage hardware and firmware.

   2.  Selecting AdvFS file systems, install the base operating system on a
       private disk on the system that will become the first cluster member.

					Note

	    You install the base operating system on only one system.
	    You do not have to install the operating system on each
	    system that will become a cluster member.


   3.  Configure the base operating system, including network and time
       services. Load and configure the applications you plan to use in the
       cluster.

   4.  Load the TruCluster Server license and software.

   5.  After completing the checklists in the TruCluster Server Software
       Installation manual, run the clu_create command to create a boot disk
       for the first cluster member and to create and populate the
       clusterwide root (/), /usr, and /var AdvFS file systems.

   6.  Halt the system and boot the disk containing the first member's
       cluster boot partition. As the system boots, it forms a single-member
       cluster and mounts the clusterwide root (/), /usr, and /var file
       systems.

   7.  Log in as root and run the clu_add_member command to add members to
       the cluster.


FILES

  /usr/sbin/clu_create
	    Specifies the command path.

  /cluster/admin/clu_create.log
	    Log file for clu_create.

  /cluster/admin/.membern.cfg
	    Configuration file created by clu_create.


RELATED INFORMATION

  Commands: clu_add_member(8), clu_check_config(8), clu_delete_member(8)

  TruCluster Server Hardware Configuration

  TruCluster Server Software Installation

Index Index for
Section 8
Index Alphabetical
listing for C
Top of page Top of
page