Technical Administration JBoss is listening only on localhost. How do I configure the binding address(es) ?

Symptoms:

  • You can only reach Silverpeas using localhost or 127.0.0.1.
  1. Stop Silverpeas.
  2. Edit the file silverpeas_start_jboss.sh orsilverpeas_start_jboss.cmd and on the last line append -b 0.0.0.0 before the -c.
  3. Restart Silverpeas

Jboss should be listening on every IP address.

How do I configure the default SSL port for JBoss ?
  1. Stop Silverpeas.
  2. Edit your specific properties configuration file (i.e. CustomerSettings.xml, see below) and append ${JBOSS_SSL_LISTEN_PORT} ]]> as a silverpeas-settings tag child.
  3. Configure JBOSS_SSL_LISTEN_PORT in $SILVERPEAS_HOME/setup/settings/config.properties. For example : JBOSS_SSL_LISTEN_PORT=8443
  4. Launch SilverpeasSettings script (.bat or .sh)
  5. Restart Silverpeas

Warning : this is not enabling a SSL connector. For this purpose, you still need to uncomment the SSL connector in JBoss server.xml

How do I install JBoss as a Windows service ?
  1. Stop Silverpeas.
  2. Edit $JBOSS_HOME/bin/run.conf.bat. Add an empty ADDITIONAL_JAVA_OPTS variable, initialize PROFILE variable and add the -server option at the first JAVA_OPTS line : rem # these variables will be set by SilverpeasSettings script set ADDITIONAL_JAVA_OPTS= set PROFILE=default rem # JVM memory allocation pool parameters - modify as appropriate. Memory params will be set by SilverpeasSettings script set "JAVA_OPTS=-server -Xmx2048m -Xms2048m -XX:MaxPermSize=512m"
  3. You can customize service name, display name and description by editing SVCNAME, SVCDISP and SVCDESC in $JBOSS_HOME/bin/service.bat. For example : if "x%SVCNAME%" == "x" ( set "SVCNAME=Silverpeas" ) set SVCDISP=Silverpeas X.X set SVCDESC=Silverpeas X.X on a JBoss Application Server 6.1.0
  4. Edit your specific properties configuration file (i.e. CustomerSettings.xml, see below) so that the SilverpeasSettings script update some parameters (Java options and JBoss profile) in the same way as start/debug commands. Append : -Xms${RAM_MIN}m -Xmx${RAM_MAX}m -XX:MaxPermSize=${PERMSIZE_MAX}m PROFILE=${JBOSS_SERVER_PROFILE} ADDITIONAL_JAVA_OPTS=${JAVA_OPTS} ]]> as a silverpeas-settings tag child.
  5. Launch SilverpeasSettings script (.bat or .sh)
  6. Install service : cd /d %JBOSS_HOME%\bin service.bat install
  7. Silverpeas can now be launched as a service
On my Mac OS X I can't access a local Silverpeas installation.

Symptoms:

  • My Mac doesn't resolve localhost or 127.0.0.1 when offline.
  1. Stop Silverpeas.
  2. Execute the foloowing command: sudo ifconfig en0 alias 127.0.0.1.
  3. Restart Silverpeas

You should be able to resolve localhost on your Mac now.

Thanks to Galder ZamarreƱo for the answer (InetAddress.getLocalHost() resolution on OSX Lion when offline)

JBoss Hornet Q won't start with AIO library ?

Symptoms:

  • Silverpeas doesn't start.
  • You have something like this in the boot.log
ERROR [AbstractKernelController] Error installing to Start: name=JMSServerManager state=Create: HornetQException[errorCode=205 message=Can't open file] at org.hornetq.core.asyncio.impl.AsynchronousFileImpl.init(Native Method) [:6.0.0.20100911-M5] at org.hornetq.core.asyncio.impl.AsynchronousFileImpl.open(AsynchronousFileImpl.java:206) [:6.0.0.20100911-M5]
  1. Stop Silverpeas.
  2. Edit the file hornetq-configuration.xml adding just before the closing tag "configuration" : NIO]]>
  3. Restart Silverpeas
  4. Check the logs for verifying that the fix is done.

Jboss should be ok.

How to fix a corrupted JCR ?

Symptoms:

  • Silverpeas doesn't start.
  • You have something like this in the traces.txt
ERROR : failed to read bundle: b623a49a-d944-4f33-9412-efca41c7a75f: java.lang.IllegalArgumentException: Invalid namespace index: 11 ERROR : Node /attachments/kmelia76/Attachment/Images/4825 (ac61b0c4-1b92-429d-b695-f62950e73627) has missing child 'Cahier de gestion de l Education juin 2010.xls' (b623a49a-d944-4f33-9412-efca41c7a75f) ERROR : Failed to initialize workspace 'jackrabbit' javax.jcr.RepositoryException: Error indexing workspace: Error indexing workspace: Error indexing workspace
  1. Stop Silverpeas.
  2. Edit the file repository.xml adding into the section "PersistenceManager" : ]]>
  3. Comment the section "SearchIndex"
  4. Restart Silverpeas
  5. Check the traces for verifying that the fix is done.
  6. Stop Silverpeas and put the file repository.xml into its previous state.

The JCR should be ok.

How do I upgrade my Silverpeas installation ?

Edit the file $SILVERPEAS_HOME/bin/pom.xml and change the version value (fort example, use 5.3.).
In order to know the last available version got to http://www.silverpeas.org/redmine/projects/silverpeas/roadmap?completed=1&with_subprojects=0&with_subprojects=1.

How do I configure the maximum size for an uploaded file ?

The maximum size for an uploaded file is configured in the file ${SILVERPEAS_HOME}/properties/org/silverpeas/util/uploads/uploadSettings. You have to change the value for the key MaximumFileSize with a size expressed in bytes.
For example to limit the size of an uploaded file to 15 Mo, the value should be (15 x 1024 x 1024) : MaximumFileSize=15728640

How do I restore files sent into a workflow ?

The files are stored in the directory ${SILVERPEAS_DATA_HOME}/data/workspaces/Attachment

How to configure Silverpeas to use rolling log files?

The file traces.txt can grow significally. You can use a rolling file for the logs.
This can be achieved by configuring the Silvertrace.
Edit the file ${SILVERPEAS_HOME}/silvertrace/rootModule.properties and configure like this :
appender0.enabled=true appender0.type=APPENDER_ROLLING_FILE appender0.module=root appender0.layout=LAYOUT_DETAILED appender0.fileName=@ErrorDir@/traces.txt appender0.rollingMode=ROLLING_MODE_WEEK

Thus the file traces.txt will be renammed each week.

How do I keep my specific properties configuration ?

You must pay attention not to manually change properties because you will lose them when you will upgrade Silverpeas.
Silverpeas provides an XML file called "CustomerSettings.xml" which is dedicated to that.
this file located in $SILVERPEAS_HOME/setup/settings contains all the specific settings.
In the extract of this file below you will see how to change a simple properties file such as an XML configuration file.
360 180 kmeliaXXX ${SILVERPEAS_DATA_HOME}/path/to/target.txt ]]> Be careful that all the paths are case sensitive (XPath and file Path).

Configuration What is the format of the CSV file for importing users in Silverpeas ?

The format is :

LastName;FirstName;Login;Email;Profile(Ex: Admin, AdminPdc, AdminDomain, User, Guest);Password
How do I unactivate the display of the importance of a publication (the stars) in Theme Tracker ?

This can be done by editing the value of showImportance in the file $SILVERPEAS_HOME/properties/org/silverpeas/kmelia/settings/kmeliaSettings.properties. The accepted values are :

  • yes : activated
  • no : desactivated

How do I put all of Silverpeas in English ?

There are two kinds of languages in Silverpeas : one for content and one for displaying the portal.
Thus you have two files to edit : showImportance in the file $SILVERPEAS_HOME/properties/org/silverpeas/kmelia/settings/kmeliaSettings.properties. The accepted values are :

  • org.silverpeas.personalizationPeas.settings.personalizationPeasSettings.properties : the key DefaultLanguage defines the default language for new users.
  • org.silverpeas.util.i18n.properties : the key languages defines the languages of the content.

How to put accessible some applications in Silverpeas by anyone without requiring an authentication?

First, the applications having to be accessed by anyone must have their parameter public access at true.

Then, in order to access anonymously to Silverpeas, the following steps have to be done:

  • Create a guest user with guest as both login and password and keep in mind the internal identifier of the newly created user;
  • Update the configuration file $SILVERPEAS_HOME/properties/org/silverpeas/lookAndFeel/generalLook.properties as follow:
    • Set the value of the parameter loginPage with the value loginAuto.jsp;
    • Set the value of the parameter anonymousId with the internal identifier of the guest user.
  • restart Silverpeas