xtfs_remove_osd - removes an OSD by copying all objects on this OSD to other
OSDs
xtfs_remove_osd [ options ] uuid:<osd_uuid>
xtfs_remove_osd removes an OSD which is currently used. It copies all
objectes on the OSD with the UUID
<osd_uuid> to other OSDs and
then shut down the OSD.
- xtfs_remove_osd -dir localhost:32638
uuid:d1feb333-d986-4e91-b8e7-eb2a48485f8b
- Starts the removing process on the OSD identified by UUID
'd1feb333-d986-4e91-b8e7-eb2a48485f8b' and copies all files automatically
to other OSDs (determinded by the OSD Selection Policy).
- -c <creds_file>
- Path to a PKCS#12 credentials file (private key + certificate) to use for
SSL authentication. Must be present when MRC URL starts with pbrpcs:// or
pbrpcg://.
- -cpass <creds_passphrase>
- An optional passphrase to access the credentials file.
- -dir <uri>
- Specifies the directory service to use (e.g. 'pbrpc://localhost:32638').
If no URI is specified, URI and security settings are taken from
'/etc/xos/xtreemfs/default_dir'. In case of a secured URI ('pbrpcs://...'
or 'pbrpcg://...'), it is necessary to also specify SSL settings.
- -h/--help
- Shows usage info.
- -t <trusted_CAs>
- Path to a PKCS#12 file containing a set of certificates from trusted
certification authorities. These certificates will be used to authenticate
the MRC. Must be present when MRC URL starts with pbrpcs:// or
pbrpcg://.
- -tpass <trusted_passphrase>
- An optional passphrase to access the truststore file.
- -d
- Enables debugging output.
- -s
- Shuts down the OSD per remote call after all object files are moved to
other OSDs. Note that the shutdown process will be performed independently
from your init system which can lead to errors if you try to start this
OSD again with your init scripts. Therefore the default is not to shutdown
the OSD. This step should be performed manually.
- --admin_password <passphrase>
- The administrator password, if password protection is enabled. Used only
if you want to shutdown the OSD automatically per remote call.
- ---ssl-protocol <ssl-protocol>
- SSL/TLS version to use: sslv3, ssltls, tlsv1, tlsv11, tlsv12. 'ssltls'
(default) accepts all versions, the others accept only the exact version
they name. 'tlsv12' is available in JDK 7+ only. 'tlsv11' comes with JDK 6
or 7, depending on the vendor.
- While the draining is in progress, it is not possible to modify the to be
moved files as they are temporarily set to read-only. Additionally, when the
draining will be started, no files of the OSD should be hold open by any
client.
- Draining an OSD that holds striped and replicated files involves certain
limitations. A striped file is currently moved to a new OSD in its entirety
rather than partially. Regardless of the original number of OSDs it was
striped across, it is relocated to a single target OSD, which implies that
the target file is not striped anymore. As a consequence, data may be moved
from OSDs that are not directly affected by the draining process.
- Furthermore, at least one OSD has to exist for each file that does not
hold any data of the file, i.e. is not included in any stripe or replica. If
all OSDs that are eligible according to the OSD selection policy have
already been assigned to a file, draining any of these OSDs will fail, as no
additional replicas can be created.
-
xtfs_chstatus(1),
xtfs_mrcdbtool(1),
xtfs_remove_osd(1),
xtfs_scrub(1),
xtfs_cleanup(1)
The xtfs_remove_osd command is part of the XtreemFS-tools package and is
available at
http://www.xtreemfs.org.