9.3. create

9.3.1. create distro

rocks create distro [arch=string] [dist=string] [md5=bool] [rolls=string] [root=string] [version=string]

Create a Rocks distribution. This distribution is used to install Rocks nodes.

parameters

[arch=string]

The architecture of the distribution. The default is the native architecture of the machine.

[dist=string]

The directory name of the distribution. The default is: "rocks-dist".

[md5=bool]

Calculate MD5SUM of all packages. Default is 'yes'.

[rolls=string]

A list of rolls that should be included in the distribution. This must be a list separated by spaces of the form: rollname,version. For example: rolls="CentOS,5.0 kernel,5.0". The default is to include all the enabled rolls for the native architecture. To get a list of enabled rolls, execute: "rocks list roll".

[root=string]

The path prefix location of the rolls. The default is: /export/rocks/install.

[version=string]

The version of the distribution. The default is the native version of the machine.

examples

# rocks create distro

Create a distribution in the current directory.

9.3.2. create keys

rocks create keys [key=string] [passphrase=boolean]

Create a RSA private/public key pair. These keys can be used to control the power for host and to open a console to VM. The private key will be stored in the specified by the 'key' parameter and the public key will be written to standard out.

parameters

[key=string]

The filename that will be used to store the private key.

[passphrase=boolean]

Set this to 'no' if you want a passphraseless private key. The default is 'yes'.

9.3.3. create mirror

rocks create mirror {path} [arch=string] [rollname=string] [version=string]

Create a Roll ISO image from the packages found in the repository located at 'URL'.

arguments

path

The network location of the repository of packages.

parameters

[arch=string]

Architecture of the mirror. (default = the architecture of of the OS running on this machine).

[rollname=string]

The base name for the created Roll. (default = 'updates').

[version=string]

The version number of the created Roll. (default = the version of Rocks running on this machine).

examples

# rocks create mirror http://mirrors.kernel.org/centos/4.5/updates/i386/RPMS rollname=updates version=4.5

Will mirror all the packages found under the URL http://mirrors.kernel.org/centos/4.5/updates/i386/RPMS and will create a Roll ISO image named 'updates-4.5-0.i386.disk1.iso'.

9.3.4. create new roll

rocks create new roll {version} {name} {color} [color=string] [name=string] [version=string]

Create a new roll from a template.

arguments

version

name

color

parameters

[color=string]

[name=string]

[version=string]

examples

# rocks create new roll

9.3.5. create package

rocks create package {directory} [prefix=string] [release=string] [version=string]

Create a RedHat or Solaris package from a given directory. The package will install files in either the same location as the given directory, or a combination of the directory basename and the provided prefix.

arguments

directory

The source directory of the files used to create the OS-specific package.

parameters

[prefix=string]

The prefix pathname prepended to the base name of the source directory.

[release=string]

Release number of the created package (default is '1')

[version=string]

Version number of the created package (default is '1.0')

examples

# rocks create package /opt/stream stream

Create a package named stream in the current directory using the contents of the /opt/stream directory. The resulting package will install its files at /opt/stream.

# rocks create package /opt/stream localstream prefix=/usr/local

Create a package named localstream in the current directory using the contents of the /opt/stream directory. The resulting package will install its files at /usr/local/stream.

9.3.6. create roll

rocks create roll {roll...}

Create a roll. You may specify either a single XML file to build one Roll or a list of ISO files to build a Meta Roll.

arguments

roll

Either a list of Roll ISO files or the name of a single Roll XML description file. If a list of Roll ISO files to be merge together into a single Roll. Otherwise the single argument is assumed to be the name of the XML file generated by the top level Makefile in the Roll's source.

examples

# rocks create roll roll-base.xml

Creates the Rocks Base Roll from the roll-base.xml description file.

# rocks create roll base*iso kernel*iso

Create a composite Roll from a list of Roll ISOs.