How can I install puppetexplorer by hand?

[Bret Wortman]

I've got an existing server running Puppet, PuppetDB, puppetboard and a handful of other apache-based services. As this is our lone Puppet server, I'm hesitant to use puppet to configure itself as that just seems problematic should I ever completely hose something up.

Anyway, all our apache files are hand-setup so I'm heistant to use the spotify-puppetexplorer module since it relies on puppet-apache to set things up. Can anyone give some guidance about what is meant, on the github page for the project, by this: "Then proxy /api to port 8080 of your PuppetDB instance (except the /commands endpoint)."? I've added this file to my apache config and while the proxying appears to work, it's giving me a "Testing 123" apache page:

<VirtualHost *:80>

    ServerName pe.internal.net

    ProxyPass /api http://127.0.0.1:8080/

</VirtualHost>

I installed puppetexplorer-2.0.0 from rpm. At present, I don't appear to have anything listening on port 8080 according to netstat, but lsof gives this:

# lsof -i:8080

COMMAND    PID     USER   FD   TYPE   DEVICE SIZE/OFF NODE NAME

java    26581  puppetdb   18u  IPv6 14596869      0t0  TCP localhost:webcache (LISTEN)

httpd   27652    apache   13u  IPv4 15705226      0t0  TCP localhost:33704->localhost:webcache (CLOSE_WAIT)

httpd   27662    apache   13u  IPv4 15700933      0t0  TCP localhost:33687->localhost:webcache (CLOSE_WAIT)

What am I missing to get this working? I can see that everything installed under /usr/share/puppetexplorer -- am I right in thinking my VirtualHost entry needs to specify that in a  <Directory>?

Or should I just back up everything under /etc/httpd and give the installation module a go? It looks like it was going to wreak holy havoc with our httpd.conf file....

[Bret Wortman]

Adding this here for the next guy who forgets the simple things:

# puppet agent -t --tags puppetexplorer

Worked like a champ. I checked my current /etc/httpd config into a git repo, ran the above, examined all the diffs, and recycled httpd when I was happy. It's now working great.

[Olivier Contant]

Thanks for the missing command to install puppetexplorer apache profile.  The https://forge.puppet.com/spotify/puppetexplorer/readme forgot to put this critical step.