Install Pebble

To see what you can do with an integrated application in TeamForge, start by installing Pebble, a blogging application that you can configure to work as part of your TeamForge site.

  1. Get the Pebble installer package from open.collab.net and unzip it.
  2. Modify these values in the installer/install.conf file to suit your installation environment.
    Option Description
    pebble.base.dir Path where you want Pebble to be installed on this host.
    ctf.baseurl Absolute URL of the TeamForge site that you want to associate to, such as https://my.ctf.instance/
    tomcat.port Pebble runs on Tomcat. This token indicates which port you want Tomcat to be running on. Make sure there are no other services running on that port.
    domain The base url to be used for Pebble, such as my.ctf.instance. (You don't need http: or https: here.)
    timezone The time zone Pebble will use to timestamp blog entries.
    java_home Path to a JDK 1.6.x instance.
    protocol http if SSL is not being used; https if SSL is being used.
    data.dir Path in the file system where Pebble blogs will be stored.
  3. Run the installer.
    • sudo python install.py -i -r
  4. Set up the initial blog data.
    • sudo python bootstrap-data.py
    This is known as "bootstrapping" the application.
    Tip: You can bootstrap again if you want to start from scratch, but any existing blogs will be deleted if you do.
  5. Restart the Pebble application.
    • service pebbled stop
    • service pebbled start
    You should now have a working Pebble instance ready to work with TeamForge. The installer has created two configuration files: installer/conf/pebble-app.xml and installer/conf/pebble-dep.xml. See Integrate Pebble into your TeamForge site for how to use them.
If you have installed Pebble with SSL, restart the TeamForge server before integrating Pebble with TeamForge. You can restart the TeamForge server using teamforge restart