Installing GSAC on FreeBSD

This site no longer maintained and here for archival purposes.

Created and contributed by

• Xanthos Papanikolaou and Demitris Anastasiou, National Technical Univeristy of Athens
• Dionysos Satellite Observatory, Higher Geodesy Laboratory

GSAC Software has been sucessefully installed on a FreeBSD 9.2-RELEASE (amd64) server. To install the software the following are needed:

Java JDK 1.6 or 1.7
You can install JDK using the either the ports collection or using the pkg utility,
e.g.
cd /usr/ports/java/openjdk7
make install clean
or
pkg install openjdk7
If you choose to instal openjdk7, you may have to patch it, using the diff file
http://people.freebsd.org/~lwhsu/patch/openjdk7-PortConfig.diff. Check the 
revision logs for more details http://svnweb.freebsd.org/ports/head/java/openjdk7/Makefile?view=log.
For more information visit http://www.freebsd.org/java/.

You will need a web server for GSAC web pages. The tested Apache version is
Apache/2.4.6 (FreeBSD), but previous versions should also work. More information
on installing and configuring are provided at: https://www.freebsd.org/doc/handbook/network-apache.html.

To build the Java source-code, Apache-Ant (Java- and XML-based build tool) is needed.
This can be installed when installing Apache, or else provided by the the ports collection:
e.g.
cd /usr/ports/devel/apache-ant
make install clean
The tested version is Apache Ant(TM) version 1.9.3.

To clone and update the GSAC SW repository svn (subversion) is needed. Installation and
basic guidelines can be found here: https://www.freebsd.org/doc/handbook/svn.html
The tested version is svn, version 1.8.1 (r1503906), but both previous and latter versions
should work fine.

Last, a database and SQL software is needed (see GSAC Installation: Database for GSAC. We have encountered no problems using
MySql Ver 14.14 Distrib 5.6.13, for FreeBSD9.2 (amd64).

Troubleshooting

Using openjdk7 and ant, there may be problems when building to create a new code area and new
Java files for your GSAC installation (see README Part1, Installing the GSAC Web Services SoftwarePackage for a Data Repository).
When building (via the command "ant -propertyfile template/mymacros.properties makerepository")
an error message appears, stating: "Unable to create javax script engine for javascript".
This may mean that the Java installed does not contain a JavaScript engine. To overcome the problem,
either install rhino (https://developer.mozilla.org/en-US/docs/Rhino)
e.g.
/usr/ports/lang/rhino
make install
checking thereby library dependancies, or
manually edit the build.xml file to replace the javascript block with xml script. Comment out the javascript block at or near line 15

      <!-- <script language="javascript">
          var before = project.getProperty("target.package");
          var dir = before.replaceAll("\\.", "/");
          project.setProperty("target_dir", dir);
          var dots = dir.replaceAll("[^/]+", "..")+"/..";
          project.setProperty("target_dots", dots);
      </script> -->

and manualy edit the next four lines with the appropriate text. E.g. when wanting to build
${HOME}/gsac/gsac-code/src/gr/ntua/gsac/, change the target dir and dots to :

    <property name="target.dir" value="gr/ntua/gsac"/>
    <property name="target.dots" value="../../../.."/>
    <echo message="dir = gr/ntua/gsac"/>
    <echo message="dots = ../../../.."/>

The values entered here must correspond to the ones entered in the properties file used to build the Java files
(template/mymacros.properties).

If you encounter problems when building the database tables (see README Part2, section Automatic Code Generation for Java reading from the Database),
of type: "java.lang.InternalError: sun.net.PortConfig: unknown OS" with jdk7, then patch java using the fix http://people.freebsd.org/~lwhsu/patch/openjdk7-PortConfig.diff.

Contact

Last updated: 17-Feb-2014
National Technical Univeristy of Athens
Report any problems at:
Xanthos Papanikolaou 
Demitris Anastasiou 

For GSAC user support, email gsacunavco.org.

Last modified: 2019-12-24  02:29:46  America/Denver