... h2. Intro
This page talks about how to install a tool into LAMS. Usual procedure is to install the default tools as part of an installer - however if someone has developed a tool that you wish to try out, these steps on how to install from source may help.
These are general instructions for both Windows and Unix. It assumes that you're familiar or are able to get the required utilities (e.g. Java JDK, Ant) - this wiki may be expanded in future to make it more generalised.
h2. First - backup!
Check out this page [Revert to Other Backup]
h2. Get the source code
You'll need to check out the lams_build project from the LAMS cvs (see [lams:Building LAMS]). You'll also need the source code for the LAMS tool you want to install. For example, on Unix:
|
... h2. Configure build properties
This means the path to your jboss instance, and your database connection parameters. In lams_build/common.properties, change 'osPropertiesName to 'unix' or 'windows'. Also change db.name, db.username and db.password to the relevant values for your database (you can check which values are used by LAMS by opening /path/to/jboss/server/default/deploy/mysql-ds.xml).
In lams_build/unix.properties or lams_build/windows.properties (depending on your system), change jboss.home and jboss.server.instance to the path of your jboss instance. For example:
{noformat}
jboss.home=/usr/local/jboss-4.0.2/
jboss.server=${jboss.home}server/
jboss.server.instance=${jboss.server}default
{noformat}
h2. Build and deploy tool
Now things should be ready to deploy the tool. We'll use the tool deployer (included in lams_build) to run all the necessary tasks to install the tool. Make sure LAMS is stopped and backed up!
lams_build and your lams tool folder should be in the same directory, e.g.
{code}
shell> ls
lams_build lams_tool_pixlr
{code}
To deploy. do this
{code}
shell> cd lams_tool_pixlr
shell> ant deploy-tool
{code}
And that's it. The ant task will assume the location and properties of the lams instance from the properties configured earlier in lams_build. Then it will compile and build the tool, and install it into your jboss instance.
|