The Administrator Guide has a section "Setting up a RDB Datasource", but it doesn't contain the info for SQL Server (which led me to believe it wasn't supported).

http://rundeck.org/docs/administration/setting-up-an-rdb-datasource.html

However - in the Installation Guide, in the "Install on Windows" section, there are instructions for using SQL Server

http://rundeck.org/docs/administration/installation.html#mssql-as-a-backend

I'd suggest moving the info from the Installation guide to the Administrator Guide.

This is in the version 2.11.4 documentation.

page: http://rundeck.org/docs/manual/creating-job-workflows.html

The documentation for modifying quartz.properties needs to be modified: http://rundeck.org/docs/administration/tuning-rundeck.html#quartz-job-threadcount

quartz.properties is no longer an option, so rundeck-config.properties is the only way

Issue type: Bug report

See image. That's clearly not a correct "exhausted list" of all possible Log Levels.

Pulled from the latest docs: http://rundeck.org/docs/api/index.html#output-content

My Rundeck detail

• Rundeck version: 2.10.7

For the time being, can I get a real list of all Log Levels? I'm trying to write a mapper class for output entries.

Thanks,

Issue type: Bug report
My Rundeck detail

• Rundeck version: 2.7.3-1
• install type: WAR
• OS Name/version: CentOS 7.3

Expected Behavior
When Rundeck is installed and a project is defined with a script Resource Model Source, we expect it to be able to run a job in this project right away, loading the execution nodes from the resource model source.

Actual Behavior
When a job is executed in a project after setup as described above, the execution fails with the following error:

com.dtolabs.rundeck.core.NodesetEmptyException: No matched nodes: NodeSet{includes={name=sample-node, dominant=false, }}
at com.dtolabs.rundeck.core.execution.workflow.NodeFirstWorkflowExecutor.validateNodeSet(NodeFirstWorkflowExecutor.java:350)
at com.dtolabs.rundeck.core.execution.workflow.NodeFirstWorkflowExecutor.executeWorkflowImpl(NodeFirstWorkflowExecutor.java:88)
at com.dtolabs.rundeck.core.execution.workflow.BaseWorkflowExecutor.executeWorkflow(BaseWorkflowExecutor.java:317)
at com.dtolabs.rundeck.core.execution.WorkflowExecutionServiceThread.run(WorkflowExecutionServiceThread.java:55)
Exception: class com.dtolabs.rundeck.core.NodesetEmptyException: No matched nodes: NodeSet{includes={name=sample-node, dominant=false, }}
No matched nodes: NodeSet{includes={name=sample-node, dominant=false, }}

However, it seems that even though this execution fails, the nodes are loaded from the script source properly, and the second execution works as expected.

How to reproduce Behavior

• Install Rundeck
• Setup a project with a script Resource Model Source that defines some nodes
• Create a job that executes on one of the defined nodes
• Run the job

ref: https://rundeck.org/docs/administration/configuration/configuration-file-reference.html#session-timeout

rd issue: rundeck/rundeck#3929

Issue type: Bug report

Bug in documentaion (see attached image)
http://rundeck.org/docs/man5/job-xml.html

Schedule \ weekday \ day example

1-5 days "sun-sat"

must be replaced with

1-5 days "sun-thu"

http://rundeck.org/2.4.1/administration/gui-customization.html

Mentions:

rundeck.gui.startpage >>>> Change the default page shown after choosing a project. values: 'run', 'jobs' or 'history'. Default: 'jobs'.

The default is NOT jobs page but the Project Overview (home) page

When googling I found https://rundeck.lighthouseapp.com/projects/59277/tickets/466-add-ability-to-bind-4440-to-localhost-address and rundeck/rundeck@1067a66

However I adding this http.server.host=127.0.0.1 in either /etc/rundeck/profile or /etc/rundeck/rundeck-config.properties is not working.

e.g.

http://rundeck.org/3.0.x-SNAPSHOT/administration/configuration/storage/using-mysql-as-a-database-backend.html
http://rundeck.org/3.0.x-SNAPSHOT/administration/scaling/storage/mysql-setup-guide.html

these files are no longer generated from current docs source, however the website still has them.

old files should be removed from the s3 bucket when new site is deployed

It wasn't clear originally but the API for creating projects supports setting the description. Originally I thought I might be required to set it as a key/value but after testing it does appear that <description>foo</description> in the posted xml appropriately sets the description.

http://rundeck.org/docs/upgrading/index.html#upgrading-jaas-properties-file

it says "org.eclipse.jetty.plus.jaas.spi.PropertyFileLoginModule" it should be "org.eclipse.jetty.jaas.spi.PropertyFileLoginModule" (without the 'plus')

The HTML log filter gives the user the impression that it renders the html produced by the step, and this results in a lot of time wasted trying to figure out what's wrong with the html produced by the step, when really the log filter is "sanitizing" it in undocumented ways.

There needs to be clear documentation of what this (and the other) log filters actually do.

"Resource Model Source Plugins" is an invalid link.

example:

old: http://rundeck.org/docs/administration/configuration-file-reference.html#framework.properties
new: http://rundeck.org/docs/administration/configuration/configuration-file-reference.html#framework.properties

ref: rundeck/rundeck#3788

Issue type: Seek Information

I have encrypted the storage keys using jasypt

rundeck.storage.converter.1.type=jasypt-encryption
rundeck.storage.converter.1.path=keys
rundeck.storage.converter.1.config.encryptorType=custom
rundeck.storage.converter.1.config.passwordSysPropName=encwithaessha256128
rundeck.storage.converter.1.config.algorithm=PBEWITHSHA256AND128BITAES-CBC-BC
rundeck.storage.converter.1.config.provider=BC

I have a customized python script which is used as NodeExecutor (SSH plugin).

Questions

1) How can I access these keys in SSH plugin?

Is it like below:

Node level: ssh-key-storage-path attribute on the Node. Applies only to the target node.
Project level: project.ssh-key-storage-path property in project.properties. Applies to any project node by default.
Rundeck level: framework.ssh-key-storage-path property in framework.properties. Applies to all projects by default.

2) How can I decrypt these keys and use in SSH plugin

My Rundeck detail

Rundeck version: 2.8.1_1
install type: (rpm,deb,war,launcher?) rpm
OS Name/version: Linux
DB Type/version: mysql? postgres? h2?..

http://rundeck.org/3.0.x-SNAPSHOT/administration/install/ubuntudebian.html
OSS install section should point to "deb https://rundeck.bintray.com/rundeck-deb /", second line is not needed, third and fourth lines do the same action:

echo "deb https://rundeck.bintray.com/rundeck-deb /" | sudo tee -a /etc/apt/sources.list.d/rundeck.list
USE THIS OR THE ONE BELOW curl 'https://bintray.com/user/downloadSubjectPublicKey?username=bintray' | sudo apt-key add -
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 379CE192D401AB61
sudo apt-get update
sudo apt-get install rundeck

It's easy for images to capture Spanish or other languages from the OS. For example:

We'll just want to be sure to use an English-language system to capture the 3.x images; this ticket is to make that easy to remember and track.

http://rundeck.org/docs/administration/authenticating-users.html#multiple-authentication-modules
In the multiauth example, line 24 says "org.eclipse.jetty.plus.jaas.spi.PropertyFileLoginModule" it should be "org.eclipse.jetty.jaas.spi.PropertyFileLoginModule" (without the 'plus'), if not, realm users won't be able to login.

ref this rundeck issue: rundeck/rundeck#3817 (comment)

without updating rundeck-config, the /etc/rundeck/profile was not correct

On here:
https://rundeck.org/docs/manual/getting-started.html#project-setup

The link in this sentence is broken:
"The Project setup chapter in the Administrator guide will show you how to learn to add Nodes, automate the creation and maintenance of Rundeck projects."

This doesn't exist:
https://rundeck.org/docs/administration/configuration/project-setup.html

I'm not sure which real page it's supposed to point to.

per: https://github.com/rundeck/docs/wiki/Branches

the en/edam.conf file needs to be updated before publishing vx.y.z docs to point to the correct artifact

There are many broken links in the plugin development section. A few examples from Plugin Development:

• DescriptionBuilder.Collaborator
• NodeStepFailureReason
• Resource Model Document Formats

Ideas

• How to use Data Capture to pass variables in your workflow
• ...

(Please comment if you have ideas on more How To Guide ideas we should add!)

pages were removed from links via https://github.com/rundeck/docs/pull/80/files#diff-9de02b5a929f8740e461983240e5d7ae

http://rundeck.org/3.0.x-SNAPSHOT/administration/configuration/encryptable-config-properties-pro.html

This documentation is not correct

Issue type: Documentation

You can use the string ${DATE:format} as a job option vlaue, which will be converted when the job/command is executed.

${DATE:format} current date in format used by the Java SimpleDateFormatter

${DATE+2:format} two days from now

${DATE-2:format} two days ago

Bug report

My Rundeck detail

• Rundeck version: any
• install type: deb (rpm,deb,war,launcher)
• OS Name/version: Debian Jessie

Expected Behavior

rundeck releases deb Files to bintray (as its done with rpms):
https://bintray.com/rundeck/rundeck-deb
but the documentation never mentions the ability to use those repos.

Actual Behavior

Documentation does not reflect bintray rundeck-deb repos

How to reproduce Behavior

read documentation

Enhancement request

please update the docu or readme so i can tell the voxpupuli people to merge my PR for debian installation:-)
...

The page below does not mention that Rundeck Pro users need to use the Pro S3 Log storage plugin
https://rundeck.org/docs/pro/index.html

This is the correct plugin:
http://download.rundeck.com/plugins/pro-s3-log-storage.html

From this section http://rundeck.org/docs/administration/backup-and-recovery.html , looking at the instructions to backup and restore, I see that there are some configuration files missing:

• ACL Policies: $RDECK_BASE/etc (ref)
• Server config: $RDECK_BASE/server/config (ref)
• Key Storage: $RDECK_BASE/var/storage (ref)

Are you ok with referencing also these files in the backup documentation?

The documentation for different databases (SQL Server and Oracle) in this case are at odds with each other as to where to put the JDBC JAR file, and neither is correct if you are using the RPM (or DEB) installation method.

SQL Server page says to put it here: Place it under %RDECK_BASE%
Oracle page says to put it here: Copy the downloaded file ojdbc7.jar to the $RDECK_BASE/server/lib

There is no 'server/lib' directory anywhere. RDECK_BASE seems to end up as /var/lib/rundeck, which has no "server" subdirectory.

You can put the JAR in "/var/lib/rundeck/exp/webapp/WEB-INF/lib", or modify the rundeckd script and point to a more central location. What's the preferred method? I'm not a fan of either of them.. but at a minimum I think the docs should be consistent and correct.

There are no docs for using plugins with the 3 series.

https://rundeck.org/docs/

There are docs for 2 series https://rundeck.org/2.11.5/plugins-user-guide/index.html

Hello,
There is no anchor for context-variables. I need more informations about it

I created a job with a job reference inside. On the job reference i overridden the filter with another. The filter i entered returns an empty set of nodes. I added a simple error handler to catch the error and print the error reason. In the anvils demo the filter i entered is tags: www+db which returns an empty set. The error handler simply does echo ${result.reason}.

Expected result:

echo ${result.reason} output is NoMatchedNodes

Obtained result:

echo ${result.reason} output Unknown

Samples

No nodes matched for the filters: NodeSet{includes={tags=www+db, dominant=false, }}
Failed dispatching to node app1.anvils.com: com.dtolabs.rundeck.core.execution.workflow.steps.StepException: No nodes matched for the filters: NodeSet{includes={tags=www+db, dominant=false, }}
Unknown
Execution failed: 4: [Workflow result: , step failures: {1=Dispatch failed on 1 nodes: [app1.anvils.com: Unknown: com.dtolabs.rundeck.core.execution.workflow.steps.StepException: No nodes matched for the filters: NodeSet{includes={tags=www+db, dominant=false, }}]}, Node failures: {app1.anvils.com=[Unknown: com.dtolabs.rundeck.core.execution.workflow.steps.StepException: No nodes matched for the filters: NodeSet{includes={tags=www+db, dominant=false, }}]}, flow control: Continue, status: failed]

Countercheck

I did also a test to check if the my usage of ${result.reason} variable is correct. the error handler remained the same and inserted a correct filter on the called job. The called job executes an exit 1, so is an always failing job. In this case the value of ${result.reason} correctly becomes JobFailed.

Countercheck sample output:

Remote command failed with exit status 1
Failed: NonZeroResultCode: Remote command failed with exit status 1
Failed: JobFailed: Job [TEST/failing job] failed
JobFailed
Execution failed: 6: [Workflow result: , step failures: {1=Dispatch failed on 1 nodes: [app1.anvils.com: JobFailed: Job [TEST/failing job] failed]}, Node failures: {app1.anvils.com=[JobFailed: Job [TEST/failing job] failed]}, flow control: Continue, status: failed]

Sample jobs

These are the jobs i created on anvils-demo. You can import and run immediately to check the issue.

fc5429cb-5ec9-4f49-bd37-30a140be6a92.yaml.txt
896799cb-1990-42f2-b17c-fb762f4b1f0a.yaml.txt

ref rundeck/rundeck#3883

page: http://rundeck.org/docs/manual/job-plugins.html

Instructions appear to be for 2.0 Enterprise Edition only (jar format) and does not apply to 3.0 war format or open-source version.

Documentation Request

When installing a new feature on Rundeck, such as a new command-line tool (in this case, rbenv), it seems that a restart of rundeck is required in order to get that tool to be recognized when used in an ad-hoc command or locally executed job step. It should be documented that this is the case - I kinda went down a rabbit hole trying to figure out why it worked when I had an SSH session to the rundeck app server but not with an adhoc command.

My Rundeck detail

• Rundeck version: 2.6.7-1
• install type: rpm
• OS Name/version: RHEL-6.8

Expected Behavior

n/a

Actual Behavior

Need to restart rundeck to access newly installed command-line tools.

How to reproduce Behavior

Install a new tool (for example, rbenv) on the rundeck app server, and then try using this tool from the Rundeck app through an adhoc command executed locally on the rundeck app server. (It should fail with something like "command not found".)

Bug report

My Rundeck detail

• Rundeck version: 2.7.1
• install type: launcher (rpm,deb,war,launcher)
• OS Name/version: Solaris 11 sparc

I tried to upgrade from 2.6.3 and installing from scratch with the usual :
/usr/jdk/instances/jdk1.8.0/jre/bin/java -jar rundeck-launcher-2.7.1.jar

rundeck start but every http request stuck forever.
I run with "-Dorg.eclipse.jetty.LEVEL=DEBUG" and I see that the connection is accepted :

2017-01-14 23:41:39.595:DBUG:oeji.SelectorManager:qtp1888420238-270-acceptor-0-ServerConnector@2f4ba1ae{HTTP/1.1}{0.0.0.0:4440}: Queued change org.eclipse.jetty.io.SelectorManager$ManagedSelector$Accept@570ff27f

but it gets timed out as if the browser didn't send anything :

2017-01-14 23:41:39.660:DBUG:oeji.SelectorManager:qtp1888420238-37-selector-0: Selector loop waiting on select

[after a while]

2017-01-14 23:42:09.605:DBUG:oeji.IdleTimeout:Scheduler-71843125: SelectChannelEndPoint@72b3e839{/192.168.56.98:47407/192.168.56.98:4440,o=true,is=false,os=false,fi=FillInterest@47339d2e{false,null},wf=WriteFlusher@200b33cb{IDLE},it=30000}{HttpConnection@3903b3cd{INTERESTED},g=HttpGenerator{s=START},p=HttpParser{s=START,0 of 0}}{io=0,kio=0,kro=1} idle timeout check, elapsed: 29946 ms, remaining: 54 ms

Actual Behavior

How to reproduce Behavior

Enhancement request

(For enhancements: Please search the existing Issues and look at the Trello board for your idea before posting.)

...

includes mention of web.xml which is no longer usable

http://rundeck.org/docs/administration/security/authenticating-users.html

Issue type: Bug or Enhancement, not sure ...

My Rundeck detail

• Rundeck version: 2.8.2
• install type: deb
• OS Name/version: Debian GNU/Linux 7.11 (wheezy)
• DB Type/version: h2

Expected Behavior
Is it possible to use Cascading Remote Options using API call through Jenkins RunDeck Plugin

Actual Behavior
The parameter show the full url instead of the json answer...

Issue type: Bug report (documentation)

The Rundeck Storage Facility page lists 2 possible values: db or file:
http://rundeck.org/docs/administration/storage-facility.html#storage-backends

However the Project Setup page lists db or filesystem:
http://rundeck.org/docs/administration/project-setup.html

Which one is correct?

My Rundeck detail

• Rundeck version: 2.10.8

Issue type: Bug report/Enhancement Request

My Rundeck detail

• Rundeck version: 2.8.2-1
• install type: (rpm,deb,war,launcher?) deb
• OS Name/version: ubuntu xenial
• DB Type/version: mysql? postgres? h2?.. mysql

Expected Behavior
The documentation for configuring SSL only has detail about generating a self-signed certificate. I've burned countless hours trying to get it to be accepted as valid SSL by chrome using komodo certs.
I finally got it working by putting my private key in private.key, my cert and ca_bundle together in combined.pem, then exporting to pkcs12 format with
openssl pkcs12 -export -name rundeck.mydomain.com -in combined.pem  -inkey  private.key  -out keystore.p12
specify the key.password you want to use, then import to keystore with:
keytool -importkeystore -destkeystore keystore -srckeystore keystore.p12 -srcstoretype pkcs12 -alias rundeck.mydomain.com
and copy keystore to truststore, and put both in /etc/rundeck/ssl/ and edit ssl.properties in that directory with the appropriate key.password and keystore.password and matching truststore.password.

Now I have the green "Secure" badge in my Chrome browser, but I still have another issue which may be related, ec2 plugin is complaining about "com.amazonaws.AmazonClientException: Unable to execute HTTP request: peer not authenticated"

Actual Behavior

How to reproduce Behavior

After upgrade

in /etc/rundeck-configuation.properties:
org.quartz.threadPool.threadCount = 50

System Report page constantly displays:
"Quartz Scheduler thread usage is currently at 100%: 10/10 Threads in use.
Job and Ad-hoc executions will be queued until previous executions complete."

APIVERSION : 25
BASE : /var/lib/rundeck
BUILD : 3.0.0-20180727
BUILDGIT : v3.0.0-0-gb18732d
NODE : localhost
SERVERUUID :
VERSION : 3.0.0-20180727

76 Active Threads at the moment. The backlog is too high now. We are making some changes to job architecture to reduce this demand (fewer jobs waiting for input), but we'd like to have control.

Multiple reboots, no change.

This is on Fedora 27 with everything up to date.

Short of a fresh build on a clean platform, what should I try?

My PRs are not getting to "docs" they are in "3.0.x" path:
merge: d0700cc
docs for latest version: https://rundeck.org/docs/administration/configuration/database/oracle.html
my PR is in here: https://rundeck.org/3.0.x/administration/configuration/database/oracle.html

Need "Guides/howto" section:

Need "Capturing data for use in later workflow steps" guide, showing Data Capture plugin and usage.

Issue type: Bug report

My Rundeck detail

• Rundeck version: 2.5.0-1
• install type: war
• OS Name/version: Red Hat EL 6.6

Expected Behavior
JSON based job option definition allows it to define a default value, because default values are mandatory for referenced job execution, if the calling job does not define the option for the referenced job.

Actual Behavior
If a job with not defined options calls a referenced job with his own defined option, this works only, if the option has a default value. This works fine, if I define the default value manually in the option field.
But if the option value are read from a URL based JSON file, how can I define the default value in JSON syntax?
The following examples do not work:
[
{"name":"slave1-json-option", "value":"slave1-json-option", "defaultValue": true}
]
[
{"name":"slave1-json-option", "value":"slave1-json-option", "default": true}
]
[
{"name":"slave1-json-option", "value":"slave1-json-option", "selected": true}
]

I couldn't found any details for that topic in the Rundeck documentation, the examples above are based on issue 1189.

How to reproduce Behavior
Define a JSON based option and do not define the option field "Default Value"

I have installed rundeckpro-windows-3.0.6-20180917, installed service, but it fails to start.
Is there any place I can put the license as I can't get to the next step for UI?

2018-09-19 15:33:27.409  INFO --- [           main] rundeckapp.BootStrap                     : Rundeck startup finished in 1164ms
Grails application running at http://xyz:4440 in environment: production
2018-09-19 15:33:35.778 ERROR --- [pool-2-thread-1] rundeckpro.license.LicenseService        : RundeckPRO License: Not Installed

The security role section of the 3.0 documentation (Rundeck Documentation (3.0.0) | Administrator Guide | Security | Authenticating Users) still references "RPM/debian install path: /var/lib/rundeck/exp/webapp/WEB-INF/web.xml". However, after a fresh RPM install on RHEL7, the /var/lib/rundeck/exp/webapp is blank. Where do we set the default security role (especially for changing to LDAP authentication)?