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.

References:
ssh-copy-id
sshd_config


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

<project>

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

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

</project>


Optional attributes

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


Example: bootstrap.xml

<project>

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

        ssh-key-storage-path="/keys/rundeck1/default.pem"/>

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

        ssh-key-storage-path="/keys/rundeck2/default.pem"/>

</project>
 

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.

 
1fb43f9155a47800b95738aff7e657fc@rundeck.desk-mail.com
http://assets3.desk.com/
false
desk
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
false
Invalid characters found
/customer/en/portal/articles/autocomplete