Difference between revisions of "Development/OnlineGlom"
(Add hint about removing the gwt.codesvr=127.0.0.1:9997 URL parameter to make it work.)
|Line 19:||Line 19:|
== Contact ==
== Contact ==
Latest revision as of 03:51, 22 February 2016
OnlineGlom is an experimental web-based UI for Glom systems which is in the initial stages of development.
We are currently working on view-only functionality, hoping to add editing later. These screenshots show the current unfinished state:
The source code for gwt-glom (the GWT UI) is in git here: https://github.com/murraycu/gwt-glom .
You can try the latest demo code here, with the examples provided with Glom:
(Sorry. That's offline currently to save money.)
You may discuss OnlineGlom on the regular Glom mailing list. See the Contact page.
Building and Running
These instructions will help you get OnlineGlom built and running locally on your computer.
To build gwt-glom from the source code you will need maven, which provides the mvn build tool. On Ubuntu, for instance, this is in the maven2 package.
Now it's time to build the actual OnlineGlom which is in the gwt-glom git repository.
Now you can run this command to clone the gwt-glom module:
git clone git://gitorious.org/online-glom/gwt-glom.git
And change into the directory that you just cloned:
Before you can use OnlineGlom, you'll need to create the configuration file, to specify the directory where you keep your .glom files. Even if you just have one glom file, you'll still need to set the directory where it is located. There is a sample configuration file that you can use as a starting point.
You can edit the configuration file with any text editor but we're going to use gedit here for simplicity. Run this command to open the configuration file:
cp src/main/resources/onlineglom.properties.sample src/main/resources/onlineglom.properties gedit src/main/resources/onlineglom.properties
To configure the directory where you have your glom files, change '/home/someuser/glomfiles' in the following configuration line:
glom.document.directory = /home/someuser/glomfiles
If you don't want to be prompted for the username and password of the underlying PostgreSQL database, you can set these two lines with the appropriate credentials:
glom.document.username = someuser
glom.document.password = ChangeMe
You can also set the password and username separately for each glom document by following the instructions in comments of the onlineglom.properties file.
Once you have things configured, run this command to compile and run OnlineGlom:
An application will start which lets you launch OnlineGlom in your browser. Click on the
Launch Default Browser button when you're ready to start playing and you should see OnlineGlom pop up in a new tab of your browser. If you don't already have the GWT Firefox plugin, you'll be prompted to download and install it. It's normal for the browser to become unresponsive while OnlineGlom is getting setup so don't worry too much if this happens.
However, you might be taken to this URL:
which will appear as a blank page. It should work if you instead manually go to just this URL:
You may instead deploy OnlineGlom to a real server.
To hack on the gwt-glom module with Eclipse, you should first follow the instructions above to build everything. The project files for Eclipse 3.7 have been committed to the gwt-glom repository. You should use Eclipse 3.7 to avoid the time consuming project configuration required to setup things for a different version of Eclipse.
When you have everything working, you can import gwt-glom as an existing project into your Eclipse environment.