Explains how to use the command-line scripts included with Cloudmin to manage users, aliases, servers, databases and resellers.
Introduction
Cloudmin comes a script named cloudmin
that can be run from the Unix shell to perform actions that are usually done from the web interface. In fact, almost all actions that can be done in a browser can also be done from the command line, or from shell scripts. This allows system, disk, image and owner creation and management to be done in a more automated function, such as from programs or scripts of your own creation.
The first parameter to the cloudmin
command is the operation you want to perform, such as create-system
. Depending on the operation, additional parameters may be needed, such as the name of the domain to create, password and so on. In almost all cases the parameters are given like --host myvps
.
The cloudmin
command must be run as root, as it needs access to system configuration files to create systems, copy files and so on. If you want to create and manage systems programatically as a different user (such as from your own CGI scripts), see the documentation on the Cloudmin Remote API instead.
All of the operations that make changes to the system output messages indicating their success or failure. Their exit status can also be checked to determine success - an exit status of 0 indicates that everything went OK, while a non-zero status indicates some problem.
All operations can be called with the --help command-line parameter to have them output details of the required and allowed parameters. Alternately, you can run cloudmin help
to get a list of all available commands, or cloudmin help
command to get information on what a particular command does.
Command Categories
API commands are broken down into the following categories :