PSTORAGE−MAKE−MDS

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
EXIT STATUS
AUTHOR
SEE ALSO

NAME

pstorage-make-mds − create a new MDS repository and join the new MDS to a Pstorage cluster

SYNOPSIS

pstorage make−mds [−I] −r path −a address[:port] [−b address1[:port1][,address2...]] [−u user] [−p] [−P]

DESCRIPTION

The make−mds command creates a new MDS repository (with the path defined by −r path), registers it with an existing Pstorage cluster, and adds it to the auto−startup list. Creating the first MDS is a special case and requires the −I option to be specified. Additional MDSs can be joined to an existing cluster, provided that the MDS services configured for this cluster are up and running. The −b option can be used to specify IP addresses of the active MDSs if autodiscovery by a cluster name does not work (see pstorage−discovery(1)).

OPTIONS

−r, −−repo−dir=path

Path to the new MDS journal directory.

−I, −−init−cluster

Use to create the first MDS in the cluster. You can join additional MDSs to an existing cluster using the make−mds command without −I.

−a, −−address=address[:port]

Set the IP address for the new MDS. If possible, IP addresses from the storage backend network should be used.

−b, −−bs−list=address1[:port1][,address2...]

Set the bootstrap list to resolve the master MDS (optional).

−x, −−no−auto−start

Do not register the new MDS in the auto−start list (optional).

−u, −−user=user

Change the owner of the created files and directories to the specified user; the default is "pstorage". The command must be run as root (optional).

−p, −−set−password

Set a password and enable digest authentication for the new cluster. The command will ask you to type a password in the terminal or read it from stdin if the −P option is specified. You can set the password only for the first MDS server (−I) or when running the command in the manual mode (−M). To add a new MDS server to the cluster, first authenticate the server using the command pstorage −c $cluster auth−node.

−P, −−stdin−password

Same as −p, −−set−password, but read the password for the cluster from stdin rather than from the terminal.

The options below can also be used for a manual/offline cluster setup. Note, however, that these options are not recommended for use in production:

−M, −−manual

Do not register the new MDS in the cluster (optional).

−i, −−id=id

Set an identifier for the new MDS (optional).

−n, −−mds−node=id@address[:port]

Add information about an existing MDS to the journal (optional).

EXAMPLES

Create the first MDS instance on host1:

pstorage −c mycluster make−mds −I −a 10.10.10.1 −r /mnt/storage/mds −p
service pstorage−mdsd start

Create the 2nd MDS instance on host2:

pstorage −c mycluster auth−node
pstorage −c mycluster make−mds −a 10.10.10.2 −r /mnt/storage/mds
service pstorage−mdsd start

Check that the cluster is up and running with 2 MDS instances:

pstorage −c mycluster top

EXIT STATUS

0

Success

Non−zero

Failure (syntax or usage error; configuration error; cluster failure; unexpected error).

AUTHOR

Copyright © 2011−2013, Parallels, Inc. All rights reserved.

SEE ALSO

pstorage(1), mdsd(1), pstorage−overview(7)