Java 6

Silverpeas needs a Java SE Development Kit (JDK) at least of version 6, which can be downloaded from Sun here.
Don't forget to set-up the environment variable JAVA_HOME.

Apache Maven

Apache Maven 2.2.x is used in Silverpeas for the building of components and the assembly. It must be installed on the target platform.
To install Maven, follw these steps:

1. Download Maven 2.2.x from the Apache web site or one of its mirrors.
2. Uncompress the downloaded archive in a directory
3. Define the environment variable M2_HOME to the resulting directory.
4. Add %M2_HOME%\bin to your %PATH% variable.

For a complete installation description, see Maven - The Definitive Guide

For more information about Apache Maven, please see the their website or download the ebook

If you are behind a proxy don't forget to configure it correctly for Maven:

• Edit or create the file ~/.m2/settings.xml.
• Add the follwing instructions according to your proxy configuration
  

  <settings>
    .
    .
    <proxies>
     <proxy>
        <active>true</active>
        <protocol>http</protocol>
        <host>proxy.somewhere.com</host>
        <port>8080</port>
        <username>proxyuser</username>
        <password>somepassword</password>
        <nonProxyHosts>www.google.com|*.somewhere.com</nonProxyHosts>
      </proxy>
    </proxies>
    .
    .
  </settings>

For a complete configuration description, see this Maven documentation page.

Postgresql

Silverpeas can use any JDBC compliant RDBMS, however the Open source solution is pre-configured to run on PostgreSQL 8.x. which can be downloaded from here.

You will have to create a database SilverpeasV5 with a user postgres/postgres with administrative rights. You may use the tool pgAdmin which provides a GUI to manage Postgresql.

Postgresql on Linux

For Linux users, here are the commands to run from a xTerm console to configure such a database :

silverpeas@sd-7358:~$ sudo apt-get install postgresql
silverpeas@sd-7358:~$  sudo -i
root@sd-7358:~$  su – postgres
postgres@sd-7358:~$ psql -d template1 -c "ALTER USER postgres WITH PASSWORD '*******'"
    # createdb -E UTF-8 SilverpeasV5
    # exit

Installing JBoss

Currently we provide a packaged and pre-configured version of JBoss 4.0.3 for Windows.
Please download it from :

• here for Windows
• here for Linux.

You have to set-up the environment variable JBOSS_HOME for the directory in which you have unzipped the jboss403.zip

Preparing Silverpeas

We currently provide a packaged and pre-configured version that will build Silverpeas and its database. Please download

1. Unzip/decompress the contents into a silverpeas directory,

2. Define an environment variable SILVERPEAS_HOME that points to this directory.

For example:
Unzip the silverpeas-5.2.2.zip file into C:\Java.
The %SILVERPEAS_HOME% should be located at C:\Java\silverpeas-5.2.2.

Configuration

Silverpeas configuration is defined in the directory %SILVERPEAS_HOME%\setup\settings\. There you should find three files :

• config.xml: where you can configure the database connection and other Silverpeas parameters such as the JVM parameters for the application.
• JBossSettings.xml: this is used for configuraing JBoss, you should not have to edit it.
• SilverpeasSettings.xml: this is a default configuration for Silverpeas. If you want your own specific configuration, you can copy and paste this file to CustomerSettings.xml where you can define your own configuration. Creating the CustomerSettings.xml file will avoid editing the configuration files for each upgrade of Silverpeas.

Deploying Silverpeas

This is a 4 steps operation which are to be executed inside the directory %SILVERPEAS_HOME%\bin:

1. mvn clean install
2. appBuilder.bat
3. SilverpeasSettings.bat
4. dbBuilder.bat

Launching Silverpeas

In %SILVERPEAS_HOME%\bin you can launch Silverpeas with silverpeas_start_jboss.cmd.

In %SILVERPEAS_HOME%\bin you can stop Silverpeas with silverpeas_stop_jboss.cmd.

You can now access Silverpeas through the following url: http://localhost:8000/silverpeas and using the account: SilverAdmin/SilverAdmin.