Welcome, Guest Login

Rundeck Pro Support Center

Install RUNDECK PRO on Linux with your Mysql and LDAP

Last Updated: Jan 23, 2017 04:44PM PST

If you want to install RUNDECK PRO using your own Mysql and LDAP server, use this document.

  • Tomcat Container
  • Rundeck PRO webapp
  • Datasource: Mysql
  • Realm: OpenLDAP or ActiveDirectory
  • CLI Tools
 

1. Check Installer System Requirements

 
  • Linux based server
  • 1GB RAM
  • 500 MB DISK
  • Internet access

If you are running the installer behind the proxy, you will need to setup a curl configuration. Edit your ~/.curlrc (create it if it does not exist) :

proxy = <proxy_host>:<proxy_port>


1.2. Mysql Datasource 

Create a rundeck database in your Mysql deployment. Record the following for use with the installer.
  • URL: the URL connection string to the database (eg jdbc:mysql://192.168.50.10/rundeck?autoReconnect=true)
  • username: the database user account (eg, rundeckuser)
  • password: the password for the database user  (eg, rundeckpassword)


If you are interested in setting up a new Mysql deployment for Rundeck see https://rundeck.desk.com/customer/portal/articles/1664209-how-to-configure-mysql-for-rundeck-pro


1.3. LDAP

Rundeck PRO is tested with OpenLDAP and Active Directory. The installer will require the following options.
  • --jndi-connection-name: the distinguished name used to login to the directory (eg, 'cn=Manager,dc=example,dc=com' )
  • --jndi-connection-password: the connection user's password (eg 'password')
  • --jndi-connection-url: the URL to the ldap server (eg, 'ldap://192.168.50.11:389' )
  • --jndi-user-pattern The query pattern for finding users. (eg, 'cn={0},ou=users,dc=example,dc=com')
  • --jndi-role-base: The query pattern for finding roles (eg 'ou=roles,dc=example,dc=com' )
  • --serverxml-template: The tomcat server.xml template to use (eg, 'activedirectory')


2. Install package dependencies

 

The installer uses curl and unzip to get and extract the software. Here the yum command is used to install the dependencies for a redhat flavor Linux box:


      sudo yum install -y unzip curl java-1.7.0-openjdk


3. Setup User account

 

Select an existing or create a "rundeck" system login for rundeck operation. Here a new account called "rundeck" is added.


    useradd -m rundeck


Now, login as the rundeck user:

 

    sudo su - rundeck


4. Choose the base directory for the install

 

The RDECK_BASE is the base directory for all the RUNDECK PRO runtime files and application. You can locate this directory anywhere. Here the home directory for the rundeck user is chosen.


   export RDECK_BASE=~rundeck


If you chose a new directory, ensure it is created and writable to the rundeck user.


Change directory to the $RDECK_BASE:
 

   cd $RDECK_BASE


5. Run Installer

 

As the "rundeck" user, execute the installer command, install-all


rdpro-installer-0.9 install-all \
        --rdeck-base $RDECK_BASE \
        --datasource-driver 'com.mysql.jdbc.Driver' \
        --datasource-url 'jdbc:mysql://192.168.50.10/rundeck?autoReconnect=true' \
        --datasource-username rundeckuser \
        --datasource-password rundeckpassword \
        --jndi-connection-name 'cn=Manager,dc=example,dc=com' \
        --jndi-connection-password password \
        --jndi-connection-url 'ldap://192.168.50.12:389' \
        --jndi-user-pattern 'cn={0},ou=users,dc=example,dc=com' \
        --jndi-role-base 'ou=roles,dc=example,dc=com' \

        --serverxml-template 'openldap' \
        --server-hostname '191.168.50.15'"
 

The installer will complete and print out the URL you can use to access the application.

 

 

Specifying Active Directory

Use the --serverxml-template option to specify the template used for Active Directory:


rdpro-installer-0.9 install-all \
        --rdeck-base $RDECK_BASE \
        --datasource-driver 'com.mysql.jdbc.Driver' \
        --datasource-url 'jdbc:mysql://192.168.50.10/rundeck?autoReconnect=true' \
        --datasource-username rundeckuser \
        --datasource-password rundeckpassword \
        --jndi-connection-name 'cn=Manager,dc=example,dc=com' \
        --jndi-connection-password password \
        --jndi-connection-url 'ldap://192.168.50.12:389' \
        --jndi-user-pattern 'cn={0},ou=users,dc=example,dc=com' \
        --jndi-role-base 'ou=roles,dc=example,dc=com' \
        --serverxml-template 'activedirectory' \
        --server-hostname '191.168.50.15'"



6. Start the server

  Source the .bashrc to update the shell environment with new PATH info and then run the startup script.

    . ~/.bashrc
    startup.sh

 


7. Login to the application

Use a login from your directory service to login to the Rundeck PRO application.

 
1fb43f9155a47800b95738aff7e657fc@rundeck.desk-mail.com
http://assets1.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