1()                                                                          ()
2
3
4

NAME

6        -
7
8       vim: softtabstop=4 shiftwidth=4 expandtab
9
10
11

SYNOPSIS

13       Use the Puppet RAL to directly interact with the system.
14
15
16

USAGE

18       ralsh  [-h|--help]  [-d|--debug]  [-v|--verbose] [-e|--edit] [-H|--host
19       <host>]
20              [-p|--param <param>] [-t|--types] type <name>
21
22
23
24

DESCRIPTION

26       This command provides simple facilities for converting  current  system
27       state into Puppet code, along with some ability to use Puppet to affect
28       the current state.
29
30       By default, you must at least provide a type to list, which case  ralsh
31       will tell you everything it knows about all instances of that type. You
32       can optionally specify an instance name, and ralsh will  only  describe
33       that single instance.
34
35       You can also add +--edit+ as an argument, and ralsh will write its out‐
36       put to a file, open that file in an editor, and then apply the file  as
37       a  Puppet  transaction.  You  can easily use this to use Puppet to make
38       simple changes to a system.
39
40
41

OPTIONS

43       Note that any configuration parameter that´s valid in the configuration
44       file  is  also  a valid long argument. For example, ´ssldir´ is a valid
45       configuration parameter, so you can specify ´--ssldir  <directory>´  as
46       an argument.
47
48       See   the   configuration   file   documentation  at  http://reductive‐
49       labs.com/projects/puppet/reference/configref.html for the full list  of
50       acceptable  parameters.  A  commented list of all configuration options
51       can also be generated by running puppet with ´--genconfig´.
52
53       debug: Enable full debugging.
54
55       edit:
56
57
58       Write the results of the query to a file, open the file in  an  editor,
59       and read the file back in as an executable Puppet manifest.
60
61
62       host:
63
64
65       When  specified,  connect  to the resource server on the named host and
66       retrieve the list of resouces of the type specified.
67
68
69       help:
70
71
72       Print this help message.
73
74
75       param:
76
77
78       Add more parameters to be outputted from queries.
79
80
81       types:
82
83
84       List all available types.
85
86
87       verbose: Print extra information.
88
89
90

EXAMPLE

92       This example uses ralsh
93        to return Puppet configuration for the user
94
95       luke :
96
97
98       $ ralsh user luke
99
100
101
102       user { ´luke´:
103              home => ´/home/luke´, uid => ´100´, ensure => ´present´, comment
104              => ´Luke Kanies,,,´, gid => ´1000´, shell => ´/bin/bash´, groups
105              => [´sysadmin´,´audio´,´video´,´puppet´]
106
107

system-message

109       System Message: WARNING/2 (./ralsh.rst:, line 87) Definition list  ends
110       without a blank line; unexpected unindent.
111
112
113       }
114
115
116
117

AUTHOR

119       Luke Kanies
120
121
122

124       Copyright (c) 2005-2007 Reductive Labs, LLC Licensed under the GNU Pub‐
125       lic License
126
127
128
129
130
131                                                                            ()
Impressum