Glom - Recent changes [en]

OnlineGlom Installation log

2012-05-16T08:21:59Z

Simplify now that we don't need java-libglom.

← Older revision		Revision as of 08:21, 16 May 2012
Line 9:		Line 9:
	cd gwt-glom		cd gwt-glom
	mvn package		mvn package
-	scp target/gwt-glom-1.21.~~8.1~~.war -l murrayc ubuntu@ec2-107-22-102-29.compute-1.amazonaws.com:/home/ubuntu/	+	scp target/gwt-glom-1.21.9.war -l murrayc ubuntu@ec2-107-22-102-29.compute-1.amazonaws.com:/home/ubuntu/

	(I have installed my public ssh key on the server to make ssh/scp easier to use.)		(I have installed my public ssh key on the server to make ssh/scp easier to use.)
Line 15:		Line 15:
	== On the server ==		== On the server ==

-	=== Install ~~the dependencies~~ ===	+	=== Install Packages ===

-	~~sudo~~ sudo add-apt-repository ppa:openismus-team/ppa	+	sudo add-apt-repository ppa:openismus-team/ppa
	sudo apt-get update		sudo apt-get update
-	sudo apt-get install tomcat7 glom-utils glom-doc ~~libjava-glom-java apache2 libapache2-mod-jk~~	+	sudo apt-get install tomcat7 apache2 libapache2-mod-jk glom-utils glom-doc

-	(glom-doc has the example files that we will use.)	+	glom-utils and glom-doc are not really needed, but they will help us to create example Glom systems for testing. For instance, glom-doc has the example files that we will use. These are the only packages that need the openismus-team PPA.

	=== Setup PostgresSQL ===		=== Setup PostgresSQL ===
Line 58:		Line 58:
	==== Create the Glom examples files and databases ====		==== Create the Glom examples files and databases ====

		+	mkdir /home/ubuntu/onlineglom_files
	glom_create_from_example --input=/usr/share/doc/glom/examples/example_smallbusiness.glom --output-path=/home/ubuntu/onlineglom_files/ --output-name=example_smallbusiness.glom --server-hostname=localhost --server-port=5432 --server-username=onlineglom		glom_create_from_example --input=/usr/share/doc/glom/examples/example_smallbusiness.glom --output-path=/home/ubuntu/onlineglom_files/ --output-name=example_smallbusiness.glom --server-hostname=localhost --server-port=5432 --server-username=onlineglom
	Using the PostgreSQL server with host: localhost		Using the PostgreSQL server with host: localhost
Line 72:		Line 73:

	sudo nano /var/lib/tomcat7/shared/classes/onlineglom.properties		sudo nano /var/lib/tomcat7/shared/classes/onlineglom.properties
-	(Based on http://gitorious.org/online-glom/gwt-glom/blobs/master/src/main/resources/onlineglom.properties.sample , with the PostgreSQL username and password.)	+	(Based on http://gitorious.org/online-glom/gwt-glom/blobs/master/src/main/resources/onlineglom.properties.sample , with the correct directory path and PostgreSQL username and password.)
-		+
-	~~===== Change Tomcat's java.library.path =====~~	+
-		+
-	~~Note that this doesn't seem to be necessary on Ubuntu Precise:~~	+
-		+
-	~~sudo nano /etc/default/tomcat7~~	+
-	~~and change this line~~	+
-	~~JAVA_OPTS="-Djava.awt.headless=true -Xmx128m -XX:+UseConcMarkSweepGC"~~	+
-	~~to this:~~	+
-	~~JAVA_OPTS="-Djava.awt.headless=true -Xmx128m -XX:+UseConcMarkSweepGC -Djava.library.path=/usr/lib/jni:/usr/lib"~~	+
-		+
-	~~===== Install the java-libglom .jar in Tomcat =====~~	+
-		+
-	~~sudo cp /usr/share/java/java-libglom-1.21.4.jar /usr/share/tomcat7/lib/~~	+

	===== Install the .war in Tomcat =====		===== Install the .war in Tomcat =====

-	sudo cp ~/gwt-glom-1.21.8.1.war /var/lib/tomcat7/webapps/OnlineGlom.war	+	sudo cp ~/gwt-glom-1.21.9.1.war /var/lib/tomcat7/webapps/OnlineGlom.war
	sudo service tomcat7 start		sudo service tomcat7 start

Line 105:		Line 92:
	==== Make Tomcat provide an AJP connection ====		==== Make Tomcat provide an AJP connection ====

-	~~sudo~~ sudo nano /etc/tomcat7/server.xml	+	sudo nano /etc/tomcat7/server.xml

	Uncomment this line:		Uncomment this line:
Line 127:		Line 114:
	==== Test Apache in your browser ====		==== Test Apache in your browser ====

		+	sudo service tomcat7 restart
	sudo service apache2 restart		sudo service apache2 restart

Development/OnlineGlom/Deployment

2012-05-16T07:21:09Z

Remove mentions of libglom and jhbuild now that gwt-glom is all Java.

← Older revision		Revision as of 07:21, 16 May 2012
(One intermediate revision not shown)
Line 12:		Line 12:
	== Dependencies ==		== Dependencies ==

-	On Ubuntu, you will need these packages on the server: tomcat, postgresql, openjdk6-jdk~~, libjava-libglom-java.~~	+	On Ubuntu, you will need these packages on the server: tomcat, postgresql, openjdk6-jdk

-	~~libjava~~-~~libglom~~-~~java and some~~ of ~~its dependencies~~ are in a separate PPA for now, so you will need to add the PPA:	+	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 [[Development/OnlineGlom/Deployment#Deploying_Example_Files\|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:

	<pre>sudo apt-add-repository ppa:openismus-team/openismus-glom-unstable</pre>		<pre>sudo apt-add-repository ppa:openismus-team/openismus-glom-unstable</pre>
-
-	~~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 [[Development/OnlineGlom/Deployment#Deploying_Example_Files\|deploy the Glom example files]]. You should not need the glom package.~~

	== .glom file and configuration ==		== .glom file and configuration ==
Line 31:		Line 29:

	== Configuring Tomcat ==		== Configuring Tomcat ==
-
-	~~=== java.library.path ===~~
-
-	~~Note: This does not seem to be necessary on Ubuntu Precise.~~
-
-	* Tomcat needs to be able to "see" the .so from java-libglom. Therefore, unless you are using a java-libglom package, which places the .so file in /usr/lib, you may need to edit /etc/default/tomcat7 and add the absolute path to the directory that has the java-libglom .so. This is apparently necessary even if you installed the libjava-libglom-java Ubuntu package, which puts the .so file in /usr/lib/jni/, or if you installed the .so file to /usr/local/lib.
-
-	~~Look for 'java.library.path' and add '/usr/lib/jni' (for instance) to the first entry of that setting. Here's how that setting might look on an example server:~~
-	~~<pre>~~
-	JAVA_OPTS="${JAVA_OPTS} -XX:+UseConcMarkSweepGC -Djava.library.path=/home/ben/gnome/install/lib64:/usr/lib/jvm/java-6-openjdk/jre/lib/amd64/server:/usr/lib/jvm/java-6-openjdk/jre/lib/amd64:/usr/lib/jvm/java-6-openjdk/jre/../lib/amd64:/usr/java/packages/lib/amd64:/usr/lib/jni:/lib:/usr/lib"
-	~~</pre>~~
-
-	~~=== Installing the java-libglom jar ===~~
-
-	Once tomcat is configured, copy the java-libglom jar to the tomcat lib directory. Since java-libglom uses JNI it can only be loaded once and must not be included in the gwt-glom .war file. The proper place for it is $CATALINA_HOME/lib which is defined as /usr/share/tomcat6/lib/ on Ubuntu 10.04. More information about this issue can be found in the [[http://tomcat.apache.org/tomcat-6.0-doc/RELEASE-NOTES.txt\|Tomcat release notes] in the "JNI Based Applications" section:
-
-	~~For instance, this command copies the jar in into the correct directory:~~
-	~~<pre>~~
-	~~sudo cp /usr/share/java/java-libglom*.jar /usr/share/tomcat7/lib/~~
-	~~</pre>~~

	== Deploying gwt-glom ==		== Deploying gwt-glom ==
Line 102:		Line 80:
	== Investigating Problems ==		== Investigating Problems ==

-	The web page will report some configuration problems, such as an incorrect filepath for the .glom files's directory, ~~or a problem loading the java-libglom .so file.~~	+	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 .		You can also check the log file, such as /var/log/tomcat7/onlineglom.log .

Development/OnlineGlom

2012-05-16T07:10:10Z

Remove mentions of libglom and jhbuild now that gwt-glom is all Java.

← Older revision		Revision as of 07:10, 16 May 2012
Line 3:		Line 3:
	== Overview ==		== Overview ==

-	OnlineGlom is an experimental UI for ~~libglom~~ which is in the initial stages of development.	+	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:		We are currently working on view-only functionality, hoping to add editing later. These screenshots show the current unfinished state:
Line 15:		Line 15:

	Source tarball releases are here: http://ftp.gnome.org/pub/GNOME/sources/gwt-glom/		Source tarball releases are here: http://ftp.gnome.org/pub/GNOME/sources/gwt-glom/
-
-	~~It uses java-libglom (Java bindings to libglom), found here: http://git.gnome.org/browse/java-libglom (source tarballs are here: http://ftp.gnome.org/pub/GNOME/sources/java-libglom/)~~

	== Demos ==		== Demos ==
Line 36:		Line 34:
	=== Dependencies ===		=== Dependencies ===

-	~~For Ubuntu Oneiric, all~~ the ~~necessary dependencies are packaged int the [[Download\|Openismus PPA]]. You just~~ need ~~to install these packages:~~	+	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.
-	* libjava-libglom-java (this is a package of java-libglom.)	+
-	* maven2 (this provides the mvn build tool.)	+

-	~~For now, if you are using a different distro, or if you need to work with the latest code, you can [[/Building java-libglom\|build java-libglom from source]].~~

	=== Building gwt-glom ===		=== Building gwt-glom ===

	Now it's time to build the actual OnlineGlom which is in the gwt-glom git repository.		Now it's time to build the actual OnlineGlom which is in the gwt-glom git repository.
-
-	~~If you are using jhbuild, remember to enter the jhbuild environment if you are not still in it, like so:~~
-
-	~~<pre>~~
-	~~jhbuild shell~~
-	~~</pre>~~

	==== Getting gwt-glom ====		==== Getting gwt-glom ====
Line 97:		Line 86:
	==== Running gwt-glom ====		==== Running gwt-glom ====

-	Once you have things configured, run this command to compile and run OnlineGlom ~~in your jhbuild environment~~:	+	Once you have things configured, run this command to compile and run OnlineGlom:

	<pre>		<pre>
Line 111:		Line 100:
	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.		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. If you used jhbuild to build gwt-glom and java-libglom then you will need to run Eclipse in your jhbuild environment so the java-libglom native library will be picked up by the Eclipse launchers. This command should work:	+	When you have everything working, you can import gwt-glom as an existing project into your Eclipse environment.
-		+
-	~~<pre>~~	+
-	~~jhbuild run path/to/eclipse/eclipse~~	+
-	~~</pre>~~	+
-		+
-	If you need to change anything in the java-libglom module, you will need to ensure that the new native library is installed and you will need to update the jar file in your local maven repository. Your work flow would go something like this:	+
-		+
-	* Edit the Swig interface file or files to wrap a new class.	+
-	* Run this command to build and install java-libglom:	+
-	~~<pre>~~	+
-	~~jhbuild buildone java-libglom~~	+
-	~~</pre>~~	+