OnlineGlom really isn't ready for deployment, but you can try it locally. Nevertheless, here are some deployment instructions so that it's documented as the development progresses.
And here is an OnlineGlom Installation log of the latest installation that Murray did on an Ubuntu Precise AWS instance.
We will install OnlineGlom in a Tomcat server. The instructions for installing tomcat are beyond the scope of this document. However, this might help on Ubuntu: https://help.ubuntu.com/11.10/serverguide/C/tomcat.html
On Ubuntu, you will need these packages on the server: tomcat, postgresql, openjdk6-jdk
TODO: Use openjdk6-jre instead of openjdk6-jdk when gwt-glom is packaged instead of needing to be built.
Also, the glom-utils package might be useful to deploy the Glom example files. You should not need the glom package. The latest versions of these are in a separate PPA for now, so you will need to add the PPA:
sudo apt-add-repository ppa:openismus-team/openismus-glom-unstable
.glom file and configuration
These instructions assume that you have a PostgreSQL setup on your server with your glom database already loaded.
- Choose a directory for your .glom files on the server, such as /home/ubuntu/onlineglom_files/
- Create an onlineglom.properties text file at /var/lib/tomcat7/shared/classes, based on the onlineglom.properties sample file. This should specify the directory containing the .glom files, and the database connection details..
- Copy your .glom files to the directory and somehow ensure that the PostgreSQL server contains the database and its data. This is simpler when deploying the Glom examples.
TODO: Package gwt-glom for Ubuntu.
You should now build gwt-glom, like so. These instructions assume that you are in the gwt-glom source directory.
mvn clean package
Copy the .war file to your server:
scp target/gwt-glom*.war servername.com:
ssh to the server and deploy the war file:
- Stop tomcat:
sudo service tomcat7 stop
or, on older distro versions:
sudo /etc/init.d/tomcat6 stop
- Copy the war file to the deployment directory:
sudo cp ~/gwt-glom-18.104.22.168.war /var/lib/tomcat7/webapps/OnlineGlom.war
- Start tomcat:
sudo service tomcat7 start
or, on older distro versions:
sudo /etc/init.d/tomcat6 start
You can test your deployment by viewing http://yourserver.com:8080/OnlineGlom in your browser.
Deploying Example Files
You can use the glom_create_from_example command-line utility to create a database, with data, on the server, and the .glom file that uses it. For instance;
glom_create_from_example --input=/home/ubuntu/onlineglom/glom/examples/example_music_collection.glom --output-path=/home/ubuntu/onlineglom_files/ --output-name="music_collection.glom" --server-hostname=localhost --server-port=5432 --server-username=onlineglom Using the PostgreSQL server with host: localhost Please enter the PostgreSQL server's password for the user onlineglom:
The web page will report some common configuration problems, such as an incorrect filepath for the .glom files's directory,
You can also check the log file, such as /var/log/tomcat7/onlineglom.log .