sxsetup man page

sxsetup — configure and display information about an SX node

Synopsis

sxsetup [Options]...

Description

With sxsetup one can interactively or automatically configure an SX node and join it to a cluster, as well as display information about a local node.

Options

-h, --help
Print help and exit
-V, --version
Print version and exit
-i, --info
Show information and configuration of a local node, including current disk usage.
--upgrade
Upgrade local storage format and cluster databases to the latest version. This option should be used after upgrading the node to the latest software version, to make use of the new features and improvements.
--config-file FILE
Use config file to configure the node automatically.
--advanced
Enable advanced configuration options. With this option one can configure additional options such as port numbers, SSL certificate settings, or number of workers. It is also required to configure a node as a regular user instead of root.
--no-remote-copy
By default, sxsetup will create a remote volume "_sxsetup.conf" on the cluster and upload the node configuration into it. When joining a new node to the cluster, it will look for existing configurations and try to obtain some information (such as an SSL certificate) automatically, to limit the number of questions in the interactive mode. With this option no remote copy will be created.
--bare
Create a bare (unprogrammed) node. A bare node is ready to join a cluster. Multiple bare nodes can be joined to the cluster at once, to minimize time of the rebalance process.
--force-reinit
With this option one can reconfigure an existing node.
--new-ip IPaddr[/internalIPaddr]
Change the existing IP address(es) of the node. sxsetup will update the local configuration and inform the cluster about the changes. In case of problems, the original configuration will be restored.
--check
Perform the integrity check of the local storage. The process might take more time, depending on the size of the data. The node will be offline during the check.
--compact
This option will compact the node's data to release unused space to the system, see sxadm-node(1) for more information. The node will be offline during the process.
--deactivate
This option will relocate all data stored on this node to other nodes in the cluster and deactivate the node. The procedure can take more time depending on the data size and the network speed. When it's finished, the node will no longer be a member of the cluster. The local storage of the node is not deleted.
--wait
When a new node is added to a cluster, an automatic data rebalance process gets started. During the rebalance, cluster works in read-write mode but no changes to the cluster structure (eg. adding or removing nodes) are allowed. With this option sxsetup will wait until the rebalance is finished.
--debug
Turn on debug mode for the created node. This will result in a large amount of log files.

Further Documentation

Full documentation with additional examples available at: <http://www.skylable.com/docs/>

See Also

sxsetup.conf(5), sxfcgi.conf(5), sxadm(8), sxfcgi(8)

Referenced By

sxadm(8), sxfcgi.conf(5), sxreport-server(8), sxserver(8), sxsetup.conf(5).

May 2015 sxsetup 2.3 Skylable SX Manual