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 ~/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.
This command needs to be followed by the commands responsible for the database initialization. As those are specific to the datastore, specific Google AppEgine database, they are not available for now in cubicweb-ctl, but they are available in the instance created.
For more details, please see CubicWeb in Google AppEngine .