This chapter describes how to install Geppetto Puppets part.

Even if Geppetto's puppet can run as any user (and it's totally unwise to run it as root, obviously), it's strongly suggested to created a dedicated user, puppet, for security purposes.

On linux machine, you can use following commands :

useradd -c "Geppetto's puppet user" -s /sbin/nologin --no-create-home -d /tmp --system puppet

and as this user will have to launch some cron

gpasswd -a puppet cron

Depending on your system's cron and security rules applied, you may have also to add puppet user in /etc/cron.allow ... to allow this user to launch its own task.

Geppetto's puppet is basically a script which has to be launched on regular basis to query the puppeteer about waiting tasks. 2 versions of this script is provided as bellow :

LUA is Geppetto's preferred puppet version as the time of writing for 2 main reasons :

• it's a lightweight language so it will not create side effects when the puppet will be launched in background
• It's something a bit difficult to maintain 2 versions of PHP on the same system : one for basic scripting, one full featured for a web server. LUA doesn't have this issue.

So you need LUA installed (I'm using version 5.1.4 as the time of writing) with both Socket and Soap extension installed.

The first version of Geppetto's puppet was in PHP. But, as my park is now mostly Gentoo based, it's heavy for me to maintain both small PHP CLI version for puppets and full featured version for my webserver.

To run PHP puppet, you need CLI version of PHP 5 (or more) installed with at least SOAP extension.

You have now to configure you Puppet to let it know how to contact its puppeteer.

The configuration has to be done in the file ${Geppetto_InstallDir}/.geppetto_lua where you have to configure following variables :

• puppetpassword : guess what is it
• rendez_vous : Replace chose.chez.moi:8000 with the URL of your own server.

The configuration has to be done in the file ${Geppetto_InstallDir}/.geppetto where you have to configure following variables :

• $puppetpassword : guess what is it
• $wsdl : URL of webservices WSDL definition.