o2cb_ctl(8) [debian man page]

o2cb_ctl(8)							OCFS2 Manual Pages						       o2cb_ctl(8)

NAME

       o2cb_ctl - Control program for the O2CB cluster service.

SYNOPSIS

       o2cb_ctl -C -n object -t type [-i] [-a attribute ]
       o2cb_ctl -D -n object [-u]
       o2cb_ctl -I [-o-z] -l manager> [-n object>] [-t type] [-a attribute]
       o2cb_ctl -H [-n object] [-t type>] [-a attribute>]
       o2cb_ctl -h
       o2cb_ctl -V

DESCRIPTION

       o2cb_ctl  is the control program for the O2CB cluster service.  Users are not advised to use this program directly but instead use the O2CB
       init service and/or ocfs2console.

OPTIONS

       -C     Create an object in the OCFS2 Cluster Configuration.

       -D     Delete an object from the existing OCFS2 Cluster Configuration.

       -I     Print information about the OCFS2 Cluster Configuration.

       -H     Change an object or objects in the existing OCFS2 Cluster Configuration.

       -h     Displays help and exit.

       -V     Print version and exit.

OTHER OPTIONS

       -a <attribute>
	      With -C, <attribute> is in format "parameter=value", where the parameter	is  a  valid  parameter  that  can  be	set  in  the  file
	      /etc/ocfs2/cluster.conf.	 With -I, <attribute> may be "parameter", indicating an attribute to be listed in the output, or it may be
	      "parameter==value", indicating that only objects matching "parameter=value" are to be displayed.

       -i     Valid only with -C. When creating something (node or cluster), it will also install it in the live cluster. If the parameter is  not
	      specified, then only update the /etc/ocfs2/cluster.conf.

       -n object
	      object  is  usually  the node name or cluster name. In the /etc/ocfs2/cluster.conf file, it would be the value of the name parameter
	      for any of the sections (cluster or node).

       -o     Valid only with -I. Using this parameter, if one asks o2cb_ctl to list all nodes, it will output it in a format suitable	for  shell
	      parsing.

       -t type
	      type can be cluster, node or heartbeat.

       -u     Valid only with -D. When deleting something (node or cluster), it will also remove it from the live cluster. If the parameter is not
	      specified, then only update the /etc/ocfs2/cluster.conf.

       -z     Valid only with -I. This is the default. If one asks o2cb_ctl to list all nodes, it will give a verbose listing.

EXAMPLES

       Add node5 to an offline cluster:

	      $ o2cb_ctl -C -n node5 -t node -a number=5
		   -a ip_address=192.168.0.5 -a ip_port=7777
		   -a cluster=mycluster

       Add node10 to an online cluster:

	      $ o2cb_ctl -C -i -n node10 -t node -a number=10
		   -a ip_address=192.168.1.10 -a ip_port=7777
		   -a cluster=mycluster

	      Note the -i argument.

       Query the IP address of node5:

	      $ o2cb_ctl -I -n node5 -a ip_address

       Change the IP address of node5:

	      $ o2cb_ctl -H -n node5 -a ip_address=192.168.1.5

SEE ALSO

       mkfs.ocfs2(8) fsck.ocfs2(8) tunefs.ocfs2(8) mounted.ocfs2(8) ocfs2console(8) o2cb(7)

AUTHORS

       Oracle Corporation

COPYRIGHT

       Copyright (C) 2004, 2010 Oracle. All rights reserved.

Version 1.6.4							  September 2010						       o2cb_ctl(8)

tunefs.ocfs2(8) 						OCFS2 Manual Pages						   tunefs.ocfs2(8)

NAME

       tunefs.ocfs2 - Change OCFS2 file system parameters.

SYNOPSIS

       tunefs.ocfs2 [--cloned-volume[=new-label] [--fs-features=list-of-features] [-J journal-options] [-L volume-label] [-N number-of-node-slots]
       [-Q query-format] [-ipqnSUvVy] [--backup-super] [--list-sparse] device  [blocks-count]

DESCRIPTION

       tunefs.ocfs2 is used to adjust OCFS2 file system parameters on disk.  The tool expects the cluster to be online as it  needs  to  take  the
       appropriate cluster locks to write safely to disk.

OPTIONS

       --cloned-volume[=new-label]
	      Change  the  volume UUID (auto-generated) and the label, if provided, of a cloned OCFS2 volume.  This option does not perform volume
	      cloning. It only changes the UUID and label on a cloned volume so that it can be mounted on the node that has  the  original  volume
	      mounted.

       --fs-features=[no]sparse...
	      Turn  specific file system features on or off. tunefs.ocfs2 will attempt to enable or disable the feature list provided. To enable a
	      feature, include it in the list. To disable a feature, prepend no to the name. For a list of feature names, see  the  man  page  for
	      mkfs.ocfs2.

       -J, --journal-options options
	      Modify  the journal using options specified on the command-line. Journal options are comma separated, and may take an argument using
	      the equals ('=') sign. For a list of possible options, see the man page for mkfs.ocfs2.

       -L, --label volume-label
	      Change the volume label of the file system. Limit the label to under 64 bytes.

       -N, --node-slots number-of-node-slots
	      Valid number ranges from 1 to 255. This number specifies the maximum number of nodes that can concurrently mount the partition.  Use
	      this to increase or decrease the number of node slots. One reason to decrease could be to release the space consumed by the journals
	      for those slots.

       -S, --volume-size
	      Grow the size of the OCFS2 file system. If blocks-count is not specified, tunefs.ocfs2 extends the volume to the current size of the
	      device.

       -Q, --query query-format
	      Query  the file system for its attributes like block size, label, etc. Query formats are modified versions of the standard printf(3)
	      formatting. The format is made up of static strings (which may include standard C character escapes for newlines,  tabs,	and  other
	      special characters) and printf(3) type formatters. The list of type specifiers is as follows:

		   B	Block size in bytes

		   T	Cluster size in bytes

		   N	Number of node slots

		   R	Root directory block number

		   Y	System directory block number

		   P	First cluster group block number

		   V	Volume label

		   U	Volume uuid

		   M	Compat flags

		   H	Incompat flags

		   O	RO Compat flags

       -q, --quiet
	      Quiet mode.

       -U, --uuid-reset[=new-uuid]
	      Set  the	volume UUID for the file system. If not provided, will auto generate a new UUID. The format of the provided UUID should be
	      178BDC83D50241EF94EB474A677D498B or 178BDC83-D502-41EF-94EB-474A677D498B.

       -v, --verbose
	      Verbose mode.

       -V, --version
	      Show version and exit.

       -y, --yes
	      Always answer Yes in interactive command line.

       -n, --no
	      Always answer No in interactive command line.

       --backup-super
	      Backs up the superblock to fixed offsets (1G, 4G, 16G, 64G, 256G and 1T) on disk. This option is useful  for  users  to  backup  the
	      superblock on volumes that the user either explicitly disallowed while formatting, or, used a version of mkfs.ocfs2 (1.2.2 or older)
	      that did not provide this facility.

       --list-sparse
	      Lists the files having holes. This option is useful when disabling the sparse feature.

       --update-cluster-stack
	      Updating on-disk cluster information to match the running cluster.

       blocks-count
	      During resize, tunefs.ocfs2 automatically determines the size of the given device and grows the file system such that it uses all of
	      the  available  space  on  the  device. This optional argument specifies that the file system should be extended to consume only the
	      given number of file system blocks on the device.

EXAMPLES

       [root@node1 ~]# tunefs.ocfs2 -Q "UUID = %U
NumSlots = %N
" /dev/sda1
       UUID = CBB8D5E0C169497C8B52A0FD555C7A3E
       NumSlots = 4

SEE ALSO

       mkfs.ocfs2(8) fsck.ocfs2(8) debugfs.ocfs2(8) mounted.ocfs2(8) ocfs2console(8) o2cb(7)

AUTHORS

       Oracle Corporation

COPYRIGHT

       Copyright (C) 2004, 2010 Oracle. All rights reserved.

Version 1.6.4							  September 2010						   tunefs.ocfs2(8)