swift-init - init tool
/usr/lib/swift/swift-init <server> [<server> ...] <command> [options]
swift-init(1) OpenStack Swift swift-init(1)
NAME
swift-init - Openstack Swift swift-init tool
SYNOPSIS
/usr/lib/swift/swift-init <server> [<server> ...] <command> [options]
DESCRIPTION
The suite of servers implementing OpenStack Swift should be managed
using the Solaris Service Management Facility, smf(7). There are six-
teen services:
svc:/application/openstack/swift/swift-account-auditor
svc:/application/openstack/swift/swift-account-reaper
svc:/application/openstack/swift/swift-account-replicator
svc:/application/openstack/swift/swift-account-server
svc:/application/openstack/swift/swift-container-auditor
svc:/application/openstack/swift/swift-container-replicator
svc:/application/openstack/swift/swift-container-server
svc:/application/openstack/swift/swift-container-sync
svc:/application/openstack/swift/swift-container-updater
svc:/application/openstack/swift/swift-object-auditor
svc:/application/openstack/swift/swift-object-expirer
svc:/application/openstack/swift/swift-object-replicator
svc:/application/openstack/swift/swift-object-server
svc:/application/openstack/swift/swift-object-updater
svc:/application/openstack/swift/swift-proxy-server
svc:/application/openstack/swift/swift-replicator-rsync
Each service is described more completely in its corresponding manual
page. Note that there are no dependencies between the services,
although most of them should be started in groups, even if the entire
suite isn't necessary.
Although the swift-init tool can be used to manage the services, doing
so is not supported on Solaris.
The swift-init tool can be used to initialize all swift daemons avail-
able as part of OpenStack Swift. Instead of calling individual init
scripts for each swift daemon, one can just use swift-init. With swift-
init you can initialize just one swift service, such as the "proxy", or
a combination of them. The tool also allows one to use the keywords
such as "all", "main" and "rest" for the <server> argument.
Servers:
proxy
- Initializes the swift proxy daemon
object, object-replicator, object-auditor, object-updater
- Initializes the swift object daemons above
container, container-update, container-replicator, container-audi-
tor
- Initializes the swift container daemons above
account, account-auditor, account-reaper, account-replicator
- Initializes the swift account daemons above
all
- Initializes all the swift daemons
main
- Initializes all the main swift daemons
(proxy, container, account and object servers)
rest
- Initializes all the other swift background daemons
(updater, replicator, auditor, reaper, etc)
Commands:
force-reload: alias for reload
no-daemon: start a server interactively
no-wait: spawn server and return immediately
once: start server and run one pass on supporting
daemons
reload: graceful shutdown then restart on supporting
servers
restart: stops then restarts server
shutdown: allow current requests to finish on supporting
servers
start: starts a server
status: display status of tracked pids for server
stop: stops a server
Options:
-h, --help show this help message and exit
-v, --verbose display verbose output
-w, --no-wait won't wait for server to start before
returning
-o, --once only run one pass of daemon
-n, --no-daemon start server interactively
-g, --graceful send SIGHUP to supporting servers
-c N, --config-num=N send command to the Nth server only
-k N, --kill-wait=N wait N seconds for processes to die
(default 15)
-r RUN_DIR, --run-dir=RUN_DIR directory where the pids will be
stored (default /var/run/swift)
--strict return non-zero status code if some config is missing.
Default mode if server is explicitly named.
--non-strict return zero status code even if some config is miss-
ing. Default mode if server is one of aliases `all`, `main` or
`rest`.
--kill-after-timeout kill daemon and all children after kill-wait
period.
DOCUMENTATION
More documentation about OpenStack Swift can be found at
http://swift.openstack.org/index.html
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+-----------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------------+
|Availability | cloud/openstack/swift |
+---------------+-----------------------+
|Stability | Uncommitted |
+---------------+-----------------------+
SEE ALSO
swift-account-auditor(1), swift-account-reaper(1), swift-account-repli-
cator(1), swift-account-server(1), swift-container-auditor(1), swift-
container-replicator(1), swift-container-server(1), swift-container-
sync(1), swift-container-updater swift-object-auditor(1), swift-object-
expirer(1), swift-object-replicator(1), swift-object-server(1), swift-
object-updater(1), swift-proxy-server(1), swift-replicator-rsync(1),
smf(7)
NOTES
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from https://tarballs.open-
stack.org/swift/swift-2.7.0.tar.gz
Further information about this software can be found on the open source
community website at http://www.openstack.org/.
OpenStack 8/26/2011 swift-init(1)