Installing Rundeck 1.2 on Windows

[Anthony Shortland]

Just gone through Rundeck launcher-based installation (http://rundeck.org/docs/RunDeck-Guide.html#installing-with-launcher) on a Windows 2008 Server AWS instance.

• Installed the latest JDK from http://www.java.com

C:\Users\Administrator\Desktop>dir jdk-6u24-windows-x64.exe

 Volume in drive C has no label.

 Volume Serial Number is FC27-1871

 Directory of C:\Users\Administrator\Desktop

04/06/2011  12:40 AM        70,092,056 jdk-6u24-windows-x64.exe

               1 File(s)     70,092,056 bytes

               0 Dir(s)  18,332,622,848 bytes free

C:\Users\Administrator\Desktop>dir %JAVA_HOME%

 Volume in drive C has no label.

 Volume Serial Number is FC27-1871

 Directory of C:\Java\jdk1.6.0_24

04/06/2011  12:42 AM    <DIR>          .

04/06/2011  12:42 AM    <DIR>          ..

04/06/2011  12:41 AM    <DIR>          bin

02/02/2011  07:48 PM             3,409 COPYRIGHT

04/06/2011  12:42 AM    <DIR>          demo

04/06/2011  12:41 AM    <DIR>          include

04/06/2011  12:41 AM    <DIR>          jre

04/06/2011  12:41 AM    <DIR>          lib

04/06/2011  12:41 AM            28,942 README.html

04/06/2011  12:41 AM            25,759 README_ja.html

04/06/2011  12:41 AM            21,170 README_zh_CN.html

04/06/2011  12:42 AM             5,321 register.html

04/06/2011  12:42 AM             6,779 register_ja.html

04/06/2011  12:42 AM             4,911 register_zh_CN.html

04/06/2011  12:42 AM    <DIR>          sample

02/02/2011  07:49 PM        19,864,164 src.zip

04/06/2011  12:41 AM                77 THIRDPARTYLICENSEREADME.txt

               9 File(s)     19,960,532 bytes

               8 Dir(s)  18,332,622,848 bytes free

C:\Users\Administrator\Desktop>java -version
java version "1.6.0_24"
Java(TM) SE Runtime Environment (build 1.6.0_24-b07)
Java HotSpot(TM) 64-Bit Server VM (build 19.1-b02, mixed mode)

• Downloaded the Rundeck 1.2 launcher from http://build.rundeck.org/job/release-1.2:

C:\Users\Administrator\Desktop>dir rundeck-launcher-1.2.0.jar

 Volume in drive C has no label.

 Volume Serial Number is FC27-1871

 Directory of C:\Users\Administrator\Desktop

04/10/2011  12:46 AM        44,168,846 rundeck-launcher-1.2.0.jar

               1 File(s)     44,168,846 bytes

               0 Dir(s)  18,285,166,592 bytes free

• Set the Rundeck base directory environment variable:

C:\Users\Administrator\Desktop>set RDECK_BASE=C:\rundeck

• Created the Rundeck base directory: 

C:\Users\Administrator\Desktop>mkdir %RDECK_BASE%

• Copied in in the Rundeck launcher jar file:

C:\Users\Administrator\Desktop>copy rundeck-launcher-1.2.0.jar %RDECK_BASE%

        1 file(s) copied.

• Ran the launcher:

C:\Users\Administrator\Desktop>cd %RDECK_BASE%

C:\rundeck>java -jar rundeck-launcher-1.2.0.jar

WARNING: HTTPS is not enabled, specify -Drundeck.ssl.config=C:/rundeck/server/config/ssl.properties to enable.

2011-04-10 00:56:19.614::INFO:  Logging to STDERR via org.mortbay.log.StdErrLog

2011-04-10 00:56:19.910::INFO:  jetty-6.1.21

2011-04-10 00:56:28.912:/:INFO:  Initializing Spring root WebApplicationContext

using rdeck.base system property: C:\rundeck

Using nodename as hostname: ip-0A500A8B

Using server hostname: ip-0A500A8B

Using server hostname: ip-0A500A8B

Using basedir: C:/rundeck

Using homedir: C:/rundeck

Installed outputstreams.

--------------------------------------

2011-04-10 00:56:46.103:/:INFO:  Initializing Spring FrameworkServlet 'grails'

2011-04-10 00:56:46.212::INFO:  Started SocketC...@0.0.0.0:4440

                                            

At this point I was left with Rundeck running in the command shell and was able to navigate to the home page (http://localhost:4440), login as admin/admin and run a test command ("dir").

Anthony.

[Anthony Shortland]

In order to make the Rundeck configuration persistent and available from any command shell I added the RDECK_BASE as a new system variable and %RDECK_BASE%\tools\bin to the Path system variable.

Running the dispatch command generates the following error:

C:\rundeck>dispatch -h

ANT_HOME not configured or non-existent.

Examining dispatch.bat:

C:\rundeck>type tools\bin\dispatch.bat

:: dispatch.bat

::

:: $Revision: 1022 $

::

@ECHO off

setlocal

IF DEFINED USER (

   set USER_NAME=%USER%

) ELSE (

   set USER_NAME=%USERNAME%

)

IF NOT DEFINED RDECK_BASE (

   ECHO RDECK_BASE not set

   GOTO:EOF

)

IF NOT EXIST "%RDECK_BASE%\etc\profile.bat" (

   ECHO Unable to source %RDECK_BASE%\etc\profile.bat

   GOTO:EOF

) ELSE (

        CALL "%RDECK_BASE%\etc\profile.bat"

)

IF NOT EXIST "%ANT_HOME%\bin\ant.bat" (

    ECHO ANT_HOME not configured or non-existent.

   GOTO:EOF

)

::echo Classpath is %cp%

SET cp=%RDECK_HOME%\classes;%ANT_HOME%\lib\xerces-2.6.0.jar;%ANT_HOME%\lib\xml-apis.jar

::

:: run dispatch main class

::

call "%JAVA_HOME%\bin\java.exe" ^

    -Xms64m -Xmx128m ^

        -classpath "%cp%" ^

    -Drdeck.base="%RDECK_BASE%" ^

        -Drdeck.home="%RDECK_HOME%" ^

        -Dant.home="%ANT_HOME%" ^

    %RDECK_SSL_OPTS% ^

    -Drdeck.traceExceptions="%RUNDECK_TRACE_EXCEPTIONS%" ^

    -Drdeck.cli.terse="%RUNDECK_CLI_TERSE%" ^

        com.dtolabs.rundeck.core.cli.ExecTool %*

... reveals that it relies in profile.bat:

C:\rundeck>type etc\profile.bat

set RDECK_HOME=C:/rundeck

set RDECK_BASE=C:/rundeck

set JAVA_HOME=C:/Java/jre6

:: Unsetting JRE_HOME to ensure there is no conflict with JAVA_HOME

(set JRE_HOME=)

set Path=%JAVA_HOME%\bin;%RDECK_HOME%\tools\bin;%Path%

set RDECK_SSL_OPTS="-Djavax.net.ssl.trustStore=%RDECK_BASE%\etc\truststore -Djavax.net.ssl.trustStoreType=jks -Djava.protocol.handler.pkgs=com.sun.net.ssl.internal.www.protocol"

                                                            

... but that nothing sets up ANT_HOME. In addition, the setup of the class path is awry in general (comparing to the Linux script and profile), so it's clear that there's some work to do to get the command-line tools working.

Anthony.

 [ mobile: 650.215.3117 | aim: anthony....@me.com yahoo: anthony.shortland skype: anthony.shortland]

[Greg Schueler]

there should be no dependency on ANT_HOME, that's likely old cruft, so wherever that is from it could be removed

[Anthony Shortland]

Logged as a bug: http://rundeck.lighthouseapp.com/projects/59277/tickets/253-dispatch-command-line-tool-doesnt-work-on-windows