Personal tools
     DOCUMENTATION

FAQ:Install and Configure the rBuilder CLI

From rPath Wiki

Jump to: navigation, search
FAQ
Question: How do I install and configure the rBuilder command line interface?


Answer: Use the rBuilder Command Line to automate various aspects of rBuilder's operation. Install the rBuilder CLI from the rbuilder package, and configure it in a file called .rbuilderrc in the current user's home directory.

Install rbuilder

Prior to installing the rBuilder client on a machine, copy the rBA entitlement from /etc/conary/entitlements/products.rpath.com on the rBA to the same location on the client machine. Copy the rBA entitlement from /etc/conary/entitlements/rap.rpath.com on the rBA to the same location on the client machine as well.

After copying the entitlements, run the following commands:

chmod 644 /etc/conary/entitlements/products.rpath.com
chmod 644 /etc/conary/entitlements/rap.rpath.com
sudo conary update rbuilder=products.rpath.com@rpath:rba-4 --config 'searchPath group-rbuilder-dist=products.rpath.com@rpath:rba-4' --resolve


Use man rbuilder for help on the rbuilder command, or see the rBuilder CLI instructions for detailed information.

You must configure the rBuilder CLI before using the associated commands. See the next section for configuration instructions.

Configure rbuilder using ~/.rbuilderrc

Create a text file with the configuration for the rBuilder CLI, and save the file as ~/.rbuilderrc. This consists of a single directive, which is a serverURL line in the following format:

serverUrl http://<username>:<password>@<rbuilder>/xmlrpc-private/

The user credentials (<username> and <password>) should match that of a project owner or developer on an rBuilder project, and <rbuilder> is the fully qualified domain name of the rBuilder instance.

Image:Bulbgraph.png   The rbuilder operations can only be performed by one user at a time, so only one serverUrl line is necessary. If there are multiple lines, the last line will be the effective user.