Welcome, Guest Login

Rundeck Pro Support Center

Setup a Manager controlled PRO host

Last Updated: Jul 20, 2015 04:14PM PDT
You might have a RUNDECK PRO server that you'll use as a Manager to administrate other PRO instances. Those hosts should be setup similarly to other RUNDECK managed hosts. They should be defined as nodes in a project and have SSH access provided.

User account

Create user ID for rundeck. This will be the account the other instances are going to run as (eg., "rundeck"). Here' the useradd command is run as root to create a new system login on the remote host.

root# useradd -m rundeck

Software dependencies

If you haven't installed PRO on the hosts, you'll need to install the required software dependencies:

root# yum -y install java-1.7.0 unzip curl nc xmlstarlet

SSH Configuration

Rundeck jobs pass context information as environment variables. Configure SSH daemon to accept RD_ prefixed environment variables. As root, run:

root# echo 'AcceptEnv RD_*' >> /etc/ssh/sshd_config
root# service sshd restart

Copy SSH key from "rundeck manager instance" to cluster members. As rundeck run,

rundeck$ ssh_key=$(awk -F= '/^framework.ssh.keypath/ {print $2}' $RDECK_BASE/etc/framework.properties)

rundeck$ ssh-copy-id -i $ssh_key rundeck@cluster-instance

The remote nodes should result with the authorized_keys file containing the public key of the "manager" instance.


Per host SSH Key setup

You can also create a key for each host to be managed by the Manager. Use the ssh-keygen command to create a key and then upload it to keystore of the Manager instance. Note the storage path when setting up the project (below).

You can organize the keys in the keystore any way you wish. You might upload them into a simple convention like: /keys/{host}/default.pem" (eg /keys/rundeck1/default.pem").

Project setup

On the Manager instance, create a project where you'll manage your remote rundeck instances. Eg, "cluster":

rundeck$ rd-project -a create cluster

Create a resource model with bootstrap data for each of the instances. Only the following attributes are required

  • nodename
  • hostname
  • username

Example: bootstrap.xml


    <node name="rundeck1" hostname="" username="rundeck" />

    <node name="rundeck2" hostname="" username="rundeck" />


Optional attributes

  • tags
  • ssh-key or ssh-key-storage-path

Example: bootstrap.xml


    <node name="rundeck1" hostname="" username="rundeck" tags="rundeck" 


    <node name="rundeck2" hostname="" username="rundeck" tags="rundeck"



Create Jobs to manage your instances

With a project created, you can create jobs to manage installation, configuration, health checking or any other administrative task.

seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
Invalid characters found