cubicweb-ctl is the swiss knife to manage CubicWeb instances. The general syntax is
cubicweb-ctl <command> [options command] <arguments commands>
To view available commands
cubicweb-ctl
cubicweb-ctl --help
Please note that the commands available depends on the CubicWeb packages and cubes that have been installed.
To view the help menu on specific command
cubicweb-ctl <command> --help
Create your new cube cube
cubicweb-ctl newcube
This will create a new cube in /path/to/forest/cubicweb/cubes/<mycube> for a Mercurial forest installation, or in /usr/share/cubicweb/cubes for a debian packages installation.
You must ensure ~/etc/cubicweb.d/ exists prior to this. On windows, the ‘~’ part will probably expand to ‘Documents and Settings/user’.
To create an instance from an existing cube, execute the following command
cubicweb-ctl create <cube_name> <instance_name>
This command will create the configuration files of an instance in ~/etc/cubicweb.d/<instance_name>.
The tool cubicweb-ctl executes the command db-create and db-init when you run create so that you can complete an instance creation in a single command. But of course it is possible to issue these separate commands separately, at a later stage.
of special interest:
start -D
will start in debug mode (under windows, starting without -D will not work; you need instead to setup your instance as a service).
See also chapter Internationalization.