Installing XSM

5 - Configuration

There is a demo configuration in CVS now, named xsm_demo_config.zip, extract that into /etc by default to get you going! You need to make sure that your servlet container has permissions to write into the xsm directory created.

If you are not using a unix system, or have no access to /etc put the configuration somewhere else, but be sure to change the "xsm.data.dir" to the preffered location in xsm.properties (in the source tree or xsm.war if using the binary release).

The main directory should contain

  • config.xml
  • xsm_local.properties
  • log4j.properties
  • id_rsa (if you intend to use the SSH backend) (not included in the demo, you must create this file using ssh_keygen)

log4j.properties is optional, but useful for debugging! any standard logging configuration should work.

config.xml defines the XSM configuration, curently try:

   <xsmconfig>
    <admins>admin@demo</admins>
  </xsmconfig>

xsm_local.properties contains values that override the defaults for xsm. An important line to include is:

xsm.url=http://mysite.com:8080/xsm

this should inform XSM at what URL it is installed. This may be "localhost" for a development site, but when publising it is advised to use a web-visible address. More information on xsm_local.properties can be found on the next page

id_rsa is a standard private key for ssh connections - make sure it is only readable by the servlet container.

 

Next is the basic configuration of each site, one sub directory for each site. (This manual configuration step will be automated soon!)



PreviousContentsNext