Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Warning

This article is in process of being moved over from my Google Sites wiki

Install Required Libraries

In order to render thumbnails ect... you need certain x-windows libraries. Refer to the list from the Confluence install instructions and make sure to use the list matching your version of Confluence.

Tip

Because the list changes between each release, I recommend documenting what you installed. Then when upgrading, remove all the required libraries from the previous Confluence release and then installing the required libraries for the new Confluence release.

PostgreSQL

Confluence comes with its own embedded database called hsqldb. However, for real production use you should use a full fledged database.

Install PostgreSQL on Ubuntu

Install PostgreSQL6.0 PostgreSQL on Ubuntu.

Install Confluence

Core Package

Download the tar.gz install package and decompress it,

...

Code Block
langhtml
su - bhitch # log in as a staff user that can run sudo
cd /opt
# make a symbolic link which scripts and commands can run against
sudo ln -s ./confluence-3.2-std ./confluence

Manually Setup JRE

I use a manual Java setup with an instance of Java specifically for the application.

...

Code Block
langhtml
cd /home/serveradmin
sudo mv ./jre1.6.0_16/ /opt/confluence/java

Configure Confluence to Use JRE

The downloaded Confluence package is powered by Tomcat. You can specify Tomcat use a specific java directory by creating a setenv file as described at Running Tomcat with a specific JRE version.

Warning

Take from Tomcat 6 instructions, but pull out into separate page.

Configure Data Directory

Also we need to create the home directory,

...

Panel

# confluence.home=c:/confluence/data
confluence.home=/opt/confluence-data/

Configure PostgreSQL

These are abridged instructions from Confluences wiki on setting up an external database.

...

First log into the PostgreSQL prompt as explain in PostgreSQL on Ubuntu\.

Create the confluence database admin account,CREATE ROLE confluencedbuser LOGIN ENCRYPTED PASSWORD 'putYourPasswordHere'
NOINHERIT
VALID UNTIL 'infinity';
COMMENT ON ROLE confluencedbuser IS 'Account used by the Confluence application.';
Create the database.
CREATE DATABASE confluencedb
WITH ENCODING='UTF8'
OWNER=confluencedbuser
CONNECTION LIMIT=-1;

...

First delete the jdbc3 driver,rm /opt/confluence/confluence/WEB-INF/lib/postgresql-8.4-701.jdbc3.jar
Then, place the JDBC Driver postgresql-8.4-701.jdbc4.jar into the <confluence-install-path>/confluence/WEB-INF/lib folder.

Starting the Confluence Service

We will now start Confluence for the first time to initialize everything.

...

  1. Choose custom
  2. Makes sure PostgreSQL is selected (it should be by default) click External Database.
  3. Direct JDBC
  4. Fill out the form,
    1. Database URL: Change the default line, jdbc:postgresql://localhost:5432/confluence to jdbc:postgresql://localhost:5432/confluencedb
    2. User: confluencedbuser
    3. Pass: the pasword you used earlier to create the user
  5. The intial user will be called "Server Admin" with user name serveradmin

Optimize Confluence

There are some basic tasks we should do before getting other people on board.

...

  1. disable automatic backup
  2. setup the mail

Connect Apache to Confluence using Mod_JK

To connect Apache to Confluence see my article ...

Stoping the Service

There appears to be a problem with shutting down the server. Read up on this. What I currently do is check to see if the service is running,

...