OSGeo - User contributions [en]

Paris Code Sprint 2016 : PostGIS Agenda

2016-01-26T20:51:57Z

Wiki-Mwtoews: there are several open pull requests on GitHub waiting that should be discussed

Discussion and group review topics for the [[Paris Code Sprint 2016]].

== Discussion ==

* Clustering functions: Aggregate or Window?
** What naming convention
** What to do with the existing aggregate functions
* [http://www.postgresql.org/message-id/20178.1423598435@sss.pgh.pa.us Expanded object headers], introduction and testing
** How they work
** Potential advantages, disadvantages
** Discussion on clean implementation possibilities
** Testing and benchmarks, is it worth it?
* Alternate storage formats, beyond GSERIALIZED
** Reasoning
** How to add (version flags?)
** Multiple co-existing formats?
* Breaking raster out as postgis_raster extension
** Implications / difficulties
* GEOS improvements that would help PostGIS
* Using FDW with PostGIS
** Functions pushdown
** Current limitations
* PostgreSQL improvements that would help PostGIS
** Parallel query, review experiments, plan and execute more
** Feed back parallel query results to pgsql-hackers
* [https://github.com/postgis/postgis/pulls Open pull requests from GitHub]
** Merge, modify, or reject

== Tasks ==

* Benchmarking of expanded object headers test branch
* Benchmarking of parallel query and parallel aggregate work from pgsql-hackers

* BRIN indexes implementation for PostGIS geometries

== Possible PostGIS function improvement and addition ==

* improvement
** st_pointN -> make a negative input count backward
** st_setPoint -> make a negative input count backward
** st_asText -> optionnal arg to limit digit number
** st_centroid -> work on circular string (simply dump points, then classical centroid)
** st_exteriorRing -> make it work on multipolygon, returns a collection
** st_makeline -> make it work on multipoints
** st_scale -> optionnal argument to define the center of scaling (allows to scale "in place")
** st_split -> allow splitting (multi)line by (multi)point
* slight addition
** st_angle(P1,P2,P3)
** st_MakeRing((multi) linestrings and/or points
** st_DumpLines -> dump everything to line (rings in poly, lines in multilines, etc. )
** st_DumpSegments -> dump segments (in the mathematical sense), that is every consecutive pairs of points in lines
* big addition
** generate grid (regular and hex)
** st_snapToLine -> st_snap = snap vertex to vertex. This one = snap vertex to vertex or edge.
** st_splitLineByPoint(line,point,tolerance) -> using curv absc, the only current way to not be sensible to precision issue (st_split doesnt work)
** st_VariableBuffer(geomM) -> buffer on geometry, the radius is given by M of each vertex, linear transition between. A lots of uses
** St_FindCurve(geom,radius_range,min_number_of_support_points,tolerance) -> in a classical geometry, find the point describing arcs
** St_MakeArc(P1,P2,centre) and St_MakeArc(P1,P2,radius) -> create arcs (_not_ using 3 points on arc!)
** St_OrientedBBox(geom) -> returns the oriented bbox of the geom (returns a geom and an angle)

OSGeo Binary Distribution

2010-06-03T15:09:36Z

Wiki-Mwtoews: copyedit headers -- make hrule headers more obvious

This provides the status of current and historical binary packaging of OSGeo software, with the ultimate goal of OSGeo "branded and certified" binary distributions of open source geospatial software for Windows, Linux and possibly MacOS X and Solaris.

== Objectives ==

* Offer a painless user experience installing and getting started with OSGeo products.
* Support major operating systems. In order of precedence that likely means Windows, Linux (Intel32), MacOS X and Solaris (Sparc).
* Ensure that all components are inter-compatible avoiding version incompatibility hell.
* Allow progressive installation, with packages pulled over the internet as requested. So the person can install a few packages without having to download everything, and so they can go back and add more packages later.
* Provide an easy to use GUI installer.
* Be relatively distribution/version agnostic - on linux we hope the same binaries will work on Debian, Fedora Core, Suse, Ubuntu, etc. On windows and MacOS X we hope the binaries would work across a variety of relatively recent OS versions.
* Include at least all the OSGeo project software as packages, and dependencies of those packages.
* Suitable for desktop and web service folks.
* Provide a level of quality control
* Simplify the process for projects to update and maintain the various distributions
* Open channels of communication between packagers and application developers.

== Microsoft Windows ==
=== OSGeo4W ===
[http://trac.osgeo.org/osgeo4w/ OSGeo4W] is a windows based stack of GeoFOSS which is based upon cygwin.

'''Goal''': Ease of installation of the whole GeoFOSS stack in windows.

'''Status''': Aug '08: Actively maintained by community, Works well

* Pros:
** Has already packaged many of the key GeoFOSS applications.
** Likely to release first major release at FOSS4G 2008, 29 Sep 2008.
** Has strong developer community.

* Cons:
** Needs installation
** Needs internet connection for installation

=== PortableGIS ===
[http://www.archaeogeek.com/blog/portable-gis/ PortableGIS] is a collection of GeoFOSS applications that run from a USB stick.

'''Goal''': Have the most important applications always with you.

'''Status''': Actively maintained by one person, (Jo Cook)

* Pro
** No installation required, just run the applications

* Con
** Doesn't work right from CD at the moment
** Applications need clean-up (Eg. Java is bundled more than once)
** Only one maintainer
** Project development infrastructure not set up yet.
** Would benefit by alignment with similar projects.
** PortableGIS currently needs to be run from a writable medium (like and USB stick), it won't work on a read-only medium like a CD.

== Linux ==

Unlike the Debian-GIS SIG, which already has mailing list / code repository infrastructure, the RPM-using community does not have such infrastructure and would benefit from hosting by OSGeo.

=== GIS Virtual Machine ===
http://gisvm.com/

* Has a stable Virtual Machine, packaged in November 2008, based upon Ubuntu 8.10.
* A new version is being developed for FOSS4G in October 2009.

=== Live CD\DVD ===
See the [[Live GIS Disc]]

=== Debian ===
* [http://pkg-grass.alioth.debian.org/cgi-bin/wiki.pl DebianGIS] is about improving Debian to make it the best distribution for Geographical Information Systems applications and users. A good deal of GIS related softwares and libraries (e.g. GRASS) are already present in Debian. We have currently an up-to-date GRASS package in main and many other packages.

=== Ubuntu ===
* [https://wiki.ubuntu.com/UbuntuGIS Ubuntu GIS]

=== GeoLivre ===
* [http://www.geolivre.org.br/modules/mydownloads/ Geolivre Linux]

=== Gentoo ===
* [http://gentoo-gis.sourceforge.net/ Gentoo]

=== Mandriva ===
* [http://club.mandriva.com/xwiki/bin/view/rpms/Category/Sciences/Geosciences Mandriva] (not really a team but all relevant RPMs there and maintained)
* [http://wiki.osgeo.org/index.php/FOSS4G_Toolkit_for_Mandriva_2008 Mandriva 2008 RPM] (Osaka City University)
* [http://wgrass.media.osaka-cu.ac.jp/foss4g/ Mandriva CD ISO Image] -- maintained by Osaka City University FOSS4G Team

RPM-based distributions, such as Fedora Linux and SuSE Linux, do not have a dedicated GIS teams, but there are several parties maintaining independent RPM archives that could be persuaded to band their efforts together under the aegis of the foundation:
=== Fedora ===
* Fedora Extra 6 ([http://download.fedora.redhat.com/pub/fedora/linux/extras/6/SRPMS source RPMS] and [http://download.fedora.redhat.com/pub/fedora/linux/extras/6/i386 i386 binaries RPMS]) contains a few GIS packages like GDAL, geos and proj
* Fedora 7 ([http://download.fedora.redhat.com/pub/fedora/linux/releases/7/Everything/source/SRPMS source RPMs] and [http://download.fedora.redhat.com/pub/fedora/linux/releases/7/Everything/i386/os/Fedora i386 binaries RPMs]) contains a few GIS packages like GDAL, geos, proj and mapserver
* [http://mappinghacks.com/rpm/ Mapping Hacks Fedora RPMs] -- maintained by SchuylerErle
* [ftp://intevation.de/freegis/fedora/ intevation.de Fedora RPMs]
* [http://postgis.refractions.net/rpms/ PostGIS RPMs for Fedora] from [http://www.refractions.net/ Refractions Research]
* [http://www.gdf-hannover.de/software Mandriva and SuSe RPMs] -- maintained by GDF Hannover

=== RHEL/CentOS/Scientific ===
See [[Enterprise Linux GIS]]

== Old Technical Notes ==
* I think building on the existing [[http://www.maptools.org/fgs/index.phtml?page=home.html FGS]] infrastructure Linux (and possibly other Unix platforms) is attractive. See [[FGSDevNotes]].
* I think the existing MS4W package could potentially be a base for windows distribution.
* William Kyngesburye has done a great deal of work producing MacOS X framework-style packages of GDAL, MapServer, GRASS etc for MacOS X ( http://www.kyngchaos.com/ ).
* GDF Hannover has build RPMs for various Linux distros: http://www.gdf-hannover.de/software This could be a starting point
* Osaka City University has built RPMs for Mandriva Linux distros: http://wgrass.media.osaka-cu.ac.jp/foss4g/downloads This could be a starting point too
* Stephan Holl/GDF has written a GUI installer for QGIS0.8 with winGRASS-native integrated (MS-Windows).

== References ==
* [[Binary Package Listing]] - an attempt to make a single page pointing to all the currently available binary (and source) packages for each project
* [[Binary Stack Platforms]] - a list of a few platforms where stacks are already (or could) be built upon

[[Category: Software Stack]]
[[Category: Live-demo]]

Building MapGuide on Ubuntu 8.04

2008-10-26T19:40:29Z

Wiki-Mwtoews: CXX

Below are instructions that will aid a user with installing FDO 3.3.1 and MapGuide Open Source 2.0.1 from SVN on Ubuntu 8.04 (Hardy Heron). It is based on previous instructions, lots of credit to their authors!

==NOTES==

The default directory used in these instructions is called /home/''administrator''. This assumes that you create your primary user account with the name "''administrator''". If you do not, mentally adjust where necessary.

You may want to consider using a client like PuTTY to access your server's terminal via openssh-server from a different computer. This really helps with copying and pasting. If so, either ensure that you install the OpenSSH server during your basic install, or add "openssh-server" to the list of packages below.

Any time that you run a task and pipe its output to a logfile, make sure that you look at the end of the logfile when you're done to make sure that it completed successfully. If it didn't then you have the logfile to post an error report from... Here's an example of how to do this:

tail -n 30 mylogfile.log

Compiled successfully on 32 bit machine. When compiled on my 64 bit machine, got error 'CPU you selected does not support x86-64 instruction set'

==BASIC SETUP==

Install a basic Ubuntu 8.04 (Hardy Heron). Once this is complete, you will have to add some extra packages to compile MapGuide. Make sure that you get all of these packages; the line is really long:

sudo apt-get install build-essential bison flex automake1.7 automake1.9 libtool doxygen subversion libjpeg62-dev libpng12-dev libfreetype6-dev libexpat1-dev libxalan110-dev libxslt1-dev expat libcurl4-openssl-dev libasound2-Dev python2.5-dev sun-java6-jdk gcc-4.1 g++-4.1

If Java fails to install, you may need to edit /etc/apt/sources.list to uncomment the multiverse repository lines and then try installing it again.

To avoid "bad fd number" errors, type the following in the terminal:

sudo dpkg-reconfigure dash

and choose No at the prompt. Be aware that this changes your default /bin/sh from dash back to bash.

Set the SUN Java to be the default Java installation:

sudo update-java-alternatives -s java-1.6.0-sun

Edit /etc/jvm, moving "/usr/lib/jvm/java-1.6.0-sun" to the top of the list

sudo nano /etc/jvm

Edit /etc/environment so that services will know where to look for Java

sudo nano /etc/environment

''(Add the following line)''

JAVA_HOME="/usr/lib/jvm/java-1.6.0-sun"

then either log off and back on again, or alternatively:
source /etc/environment

The best way to compile MapGuide is using GCC 4.1 (this is older than the "current" version). To enable this, type the following commands into each build environment:
CC=gcc-4.1
export CC
CXX=g++-4.1
export CXX

==FDO INSTALL==

In terminal type the following:

''(be prepared to wait a long time for this command to complete, the test data takes a while to download)
svn checkout http://svn.osgeo.org/fdo/tags/3.3.1/ fdo-3.3.1

''(type in your password after the following command if prompted. Note that this fdo-3.3.0, not fdo-3.3.1)''
sudo mkdir /usr/local/fdo-3.3.0

''(if you are not logged in as ''administrator'', you change the userid below!)''
sudo chown ''administrator'' /usr/local/fdo-3.3.0

''(when compile, I got error "occi.h: No such file or directory". This is for provider KingOracle. Since I don't need it anyway, I just remove folder /home/''administrator''/fdo-3.3.1/Providers/KingOracle)

cd fdo-3.3.1

source ./setenvironment.sh

In terminal, type the following to run the builds. Note, there will be no output from either command until completion as it is all being spooled to nohup.out. You can log into another terminal session and tail this file if you start getting antsy :-)

nohup ./build_thirdparty.sh 2>&1 | tee build_thirdparty.log

nohup ./build_linux.sh 2>&1 | tee build_linux.log

==APACHE / PHP INSTALL==

In Terminal type the following:

cd ~

''(you should now be in /home/''administrator'', or whatever your $HOME is)''

svn checkout http://svn.osgeo.org/mapguide/tags/MAPGUIDE2.0.1/ mapguide-2.0.1

sudo mkdir /usr/local/mapguideopensource

''(replace ''administrator'' with your userid if necessary)''

sudo chown ''administrator'' /usr/local/mapguideopensource

cd mapguide-2.0.1/Oem/LinuxApt

''(careful when copying and pasting this line, the - got changed into . for me)''

find . -name "*.gz" -exec tar xzf {} \;

nohup ./build_apt.sh 2>&1 | tee ../../build_apt.log

==BUILD OEM==

Perform the following:

cd ~/mapguide-2.0.1/

nohup ./build_oem.sh 2>&1 | tee build_oem.log

==BUILD MAPGUIDE==

Go for the Heron:

aclocal
libtoolize --force
automake --add-missing --copy
autoconf

./configure --enable-optimized

''(If you get error "missing liblib_json.so", then apply patch from http://trac.osgeo.org/mapguide/ticket/347)

nohup make 2>&1 | tee make_mapguide.log

nohup make install 2>&1 | tee install_mapguide.log

If you want to use webstudio, copy the files to the webserverextension folder:

cp -fpR /home/''administrator''/mapguide-2.0.1/Web/src/webstudio /usr/local/mapguideopensource/webserverextensions/www/webstudio

== STARTUP OPTIONS ==

While you're testing, it can be convenient to run services interactively, but eventually you'll want them to shut down / restart when you the computer is rebooted. This section gives you both options.

=== START SERVICES MANUALLY ===

Start Apache

sudo /usr/local/mapguideopensource/webserverextensions/apache2/bin/apachectl restart

Stop Apache

sudo /usr/local/mapguideopensource/webserverextensions/apache2/bin/apachectl stop

Start MapGuide

sudo /usr/local/mapguideopensource/server/bin/mgserverd.sh

Stop MapGuide

sudo pkill -f -u root "mgserver daemon"

Building MapGuide on Ubuntu 8.04

2008-10-26T01:57:06Z

Wiki-Mwtoews: edit method to use GCC 4.1

Below are instructions that will aid a user with installing FDO 3.3.1 and MapGuide Open Source 2.0.1 from SVN on Ubuntu 8.04 (Hardy Heron). It is based on previous instructions, lots of credit to their authors!

==NOTES==

The default directory used in these instructions is called /home/''administrator''. This assumes that you create your primary user account with the name "''administrator''". If you do not, mentally adjust where necessary.

You may want to consider using a client like PuTTY to access your server's terminal via openssh-server from a different computer. This really helps with copying and pasting. If so, either ensure that you install the OpenSSH server during your basic install, or add "openssh-server" to the list of packages below.

Any time that you run a task and pipe its output to a logfile, make sure that you look at the end of the logfile when you're done to make sure that it completed successfully. If it didn't then you have the logfile to post an error report from... Here's an example of how to do this:

tail -n 30 mylogfile.log

Compiled successfully on 32 bit machine. When compiled on my 64 bit machine, got error 'CPU you selected does not support x86-64 instruction set'

==BASIC SETUP==

Install a basic Ubuntu 8.04 (Hardy Heron). Once this is complete, you will have to add some extra packages to compile MapGuide. Make sure that you get all of these packages; the line is really long:

sudo apt-get install build-essential bison flex automake1.7 automake1.9 libtool doxygen subversion libjpeg62-dev libpng12-dev libfreetype6-dev libexpat1-dev libxalan110-dev libxslt1-dev expat libcurl4-openssl-dev libasound2-Dev python2.5-dev sun-java6-jdk gcc-4.1 g++-4.1

If Java fails to install, you may need to edit /etc/apt/sources.list to uncomment the multiverse repository lines and then try installing it again.

To avoid "bad fd number" errors, type the following in the terminal:

sudo dpkg-reconfigure dash

and choose No at the prompt. Be aware that this changes your default /bin/sh from dash back to bash.

Set the SUN Java to be the default Java installation:

sudo update-java-alternatives -s java-1.6.0-sun

Edit /etc/jvm, moving "/usr/lib/jvm/java-1.6.0-sun" to the top of the list

sudo nano /etc/jvm

Edit /etc/environment so that services will know where to look for Java

sudo nano /etc/environment

''(Add the following line)''

JAVA_HOME="/usr/lib/jvm/java-1.6.0-sun"

then either log off and back on again, or alternatively:
source /etc/environment

The best way to compile MapGuide is using GCC 4.1 (this is older than the "current" version). To enable this, type the following commands into each build environment:
CC=gcc-4.1
export CC

==FDO INSTALL==

In terminal type the following:

''(be prepared to wait a long time for this command to complete, the test data takes a while to download)
svn checkout http://svn.osgeo.org/fdo/tags/3.3.1/ fdo-3.3.1

''(type in your password after the following command if prompted. Note that this fdo-3.3.0, not fdo-3.3.1)''
sudo mkdir /usr/local/fdo-3.3.0

''(if you are not logged in as ''administrator'', you change the userid below!)''
sudo chown ''administrator'' /usr/local/fdo-3.3.0

''(when compile, I got error "occi.h: No such file or directory". This is for provider KingOracle. Since I don't need it anyway, I just remove folder /home/''administrator''/fdo-3.3.1/Providers/KingOracle)

cd fdo-3.3.1

source ./setenvironment.sh

In terminal, type the following to run the builds. Note, there will be no output from either command until completion as it is all being spooled to nohup.out. You can log into another terminal session and tail this file if you start getting antsy :-)

nohup ./build_thirdparty.sh 2>&1 | tee build_thirdparty.log

nohup ./build_linux.sh 2>&1 | tee build_linux.log

==APACHE / PHP INSTALL==

In Terminal type the following:

cd ~

''(you should now be in /home/''administrator'', or whatever your $HOME is)''

svn checkout http://svn.osgeo.org/mapguide/tags/MAPGUIDE2.0.1/ mapguide-2.0.1

sudo mkdir /usr/local/mapguideopensource

''(replace ''administrator'' with your userid if necessary)''

sudo chown ''administrator'' /usr/local/mapguideopensource

cd mapguide-2.0.1/Oem/LinuxApt

''(careful when copying and pasting this line, the - got changed into . for me)''

find . -name "*.gz" -exec tar xzf {} \;

nohup ./build_apt.sh 2>&1 | tee ../../build_apt.log

==BUILD OEM==

Perform the following:

cd ~/mapguide-2.0.1/

nohup ./build_oem.sh 2>&1 | tee build_oem.log

==BUILD MAPGUIDE==

Go for the Heron:

aclocal
libtoolize --force
automake --add-missing --copy
autoconf

./configure --enable-optimized

''(If you get error "missing liblib_json.so", then apply patch from http://trac.osgeo.org/mapguide/ticket/347)

nohup make 2>&1 | tee make_mapguide.log

nohup make install 2>&1 | tee install_mapguide.log

If you want to use webstudio, copy the files to the webserverextension folder:

cp -fpR /home/''administrator''/mapguide-2.0.1/Web/src/webstudio /usr/local/mapguideopensource/webserverextensions/www/webstudio

== STARTUP OPTIONS ==

While you're testing, it can be convenient to run services interactively, but eventually you'll want them to shut down / restart when you the computer is rebooted. This section gives you both options.

=== START SERVICES MANUALLY ===

Start Apache

sudo /usr/local/mapguideopensource/webserverextensions/apache2/bin/apachectl restart

Stop Apache

sudo /usr/local/mapguideopensource/webserverextensions/apache2/bin/apachectl stop

Start MapGuide

sudo /usr/local/mapguideopensource/server/bin/mgserverd.sh

Stop MapGuide

sudo pkill -f -u root "mgserver daemon"

Building MapGuide on CentOS 5

2008-10-15T22:35:34Z

Wiki-Mwtoews: more dependancies

==Prerequisite==
===User account===
If you have just installed the OS, be sure to create a user account for yourself from root:
adduser ''<username>''
passwd ''<username>''
Add yourself to the sudoer list from root:
visudo
Add your entry after root <code>"''<username>'' ALL=(ALL) ALL"</code>, at about line 77. The program uses commands from <code>vi</code> or <code>vim</code>, so you need to insert text using <code>i</code>, then after inserting text, you need to hit the ESC key, then<code>:wq</code> (write, quit).
Logout of root, and log in as yourself.

===System development tools and libraries===
Install system development tools (as root via su):
yum install gcc*
yum install expat* libtool* automake* bison* flex doxygen libjpeg-devel libpng libpng-devel alsa-lib-devel swig gd-*

===Sun Java===
A Sun Java Development Kit is required. The plain package is fine, no need for NetBeans or Java EE. You can download the JDK from http://java.sun.com/javase/downloads/index.jsp. Detailed installation instructions can be found at http://wiki.centos.org/HowTos/JavaOnCentOS (follow the instructions for "Sun JDK 1.6").

Check "<code>java -version</code>" and you should see "Java(TM)" somewhere in the output.

===Optional: PostgreSQL and PostGIS===
Current versions of PostgreSQL are maintained at http://yum.pgsqlrpms.org/. An overview for beginners can be found here: http://www.postgresonline.com/journal/index.php?/archives/45-An-Almost-Idiots-Guide-to-PostgreSQL-YUM.html

To use the repository, first block all others by editing the repos file. As root, edit the file (e.g.):
vim /etc/yum.repos.d/CentOS-Base.repo</code>
add to the bottom of the file:
exclude=postgresql*

Choose a version of PostgreSQL from http://yum.pgsqlrpms.org/reporpms/repoview/pgdg-centos.html, the current version 8.3.x is recommended

==Download source==
Download the source code for FDO-3.3.1 and MapGuide-2.0.2:
svn checkout http://svn.osgeo.org/fdo/tags/3.3.1/ fdo-3.3.1

svn checkout http://svn.osgeo.org/mapguide/tags/MAPGUIDE2.0.2/ mapguide-2.0.2

==Build and Install==
===FDO===
Through su or as root:
mkdir /usr/local/fdo-3.3.0
cd fdo-3.3.1
source ./setenvironment.sh

nohup ./build_thirdparty.sh 2>&1 | tee build_thirdparty.log

nohup ./build_linux.sh 2>&1 | tee build_linux.log

===Apache / PHP ===
Through su or as root:
mkdir /usr/local/mapguideopensource
cd mapguide-2.0.2/Oem/LinuxApt
find . -name "*.gz" -exec tar xzf {} \;

nohup ./build_apt.sh 2>&1 | tee ../../build_apt.log

===OEM===
Through su or as root:
cd mapguide-2.0.2/
nohup ./build_oem.sh 2>&1 | tee build_oem.log

===MapGuide===
Through su or as root:
aclocal
libtoolize --force
automake --add-missing --copy
autoconf
./configure --enable-optimized

nohup make 2>&1 | tee make_mapguide.log

nohup make install 2>&1 | tee install_mapguide.log

Building MapGuide on CentOS 5

2008-10-14T20:16:43Z

Wiki-Mwtoews: expand

==Prerequisite==
===User account===
If you have just installed the OS, be sure to create a user account for yourself from root:
adduser ''<username>''
passwd ''<username>''
Add yourself to the sudoer list from root:
visudo
Add your entry after root <code>"''<username>'' ALL=(ALL) ALL"</code>, at about line 77. The program uses commands from <code>vi</code> or <code>vim</code>, so you need to insert text using <code>i</code>, then after inserting text, you need to hit the ESC key, then<code>:wq</code> (write, quit).
Logout of root, and log in as yourself.

===System development tools and libraries===
Install system development tools (as root via su):
yum install gcc*
yum install subversion* expat* libtool* automake* bison* flex doxygen libjpeg-devel libpng libpng-devel alsa-lib-devel

===Sun Java===
A Sun Java Development Kit is required. The plain package is fine, no need for NetBeans or Java EE. You can download the JDK from http://java.sun.com/javase/downloads/index.jsp. Detailed installation instructions can be found at http://wiki.centos.org/HowTos/JavaOnCentOS (follow the instructions for "Sun JDK 1.6").

Check "<code>java -version</code>" and you should see "Java(TM)" somewhere in the output.

===Optional: PostgreSQL and PostGIS===
Current versions of PostgreSQL are maintained at http://yum.pgsqlrpms.org/. An overview for beginners can be found here: http://www.postgresonline.com/journal/index.php?/archives/45-An-Almost-Idiots-Guide-to-PostgreSQL-YUM.html

To use the repository, first block all others by editing the repos file. As root, edit the file (e.g.):
vim /etc/yum.repos.d/CentOS-Base.repo</code>
add to the bottom of the file:
exclude=postgresql*

Choose a version of PostgreSQL from http://yum.pgsqlrpms.org/reporpms/repoview/pgdg-centos.html, the current version 8.3.x is recommended

==Download source==
Download the source code for FDO-3.3.1 and MapGuide-2.0.2:
svn checkout http://svn.osgeo.org/fdo/tags/3.3.1/ fdo-3.3.1

svn checkout http://svn.osgeo.org/mapguide/tags/MAPGUIDE2.0.2/ mapguide-2.0.2

==Build and Install==
===FDO===
Through su or as root:
mkdir /usr/local/fdo-3.3.0
cd fdo-3.3.1
source ./setenvironment.sh

nohup ./build_thirdparty.sh 2>&1 | tee build_thirdparty.log

nohup ./build_linux.sh 2>&1 | tee build_linux.log

===Apache / PHP ===
Through su or as root:
mkdir /usr/local/mapguideopensource
cd mapguide-2.0.2/Oem/LinuxApt
find . -name "*.gz" -exec tar xzf {} \;

nohup ./build_apt.sh 2>&1 | tee ../../build_apt.log

===OEM===
Through su or as root:
cd mapguide-2.0.2/
nohup ./build_oem.sh 2>&1 | tee build_oem.log

===MapGuide===
Through su or as root:
aclocal
libtoolize --force
automake --add-missing --copy
autoconf
./configure --enable-optimized

nohup make 2>&1 | tee make_mapguide.log

nohup make install 2>&1 | tee install_mapguide.log

Building MapGuide on CentOS 5

2008-10-07T01:14:38Z

Wiki-Mwtoews: ... still in progress ...

==Prerequisite==
===User account===
If you have just installed the OS, be sure to create a user account for yourself from root:
adduser ''<username>''
passwd ''<username>''
Add yourself to the sudoer list from root:
visudo
Add your entry after root <code>"''<username>'' ALL=(ALL) ALL"</code>, at about line 77. The program uses commands from <code>vi</code> or <code>vim</code>, so you need to insert text using <code>i</code>, then after inserting text, you need to hit the ESC key, then<code>:wq</code> (write, quit).
Logout of root, and log in as yourself.

===System development tools and libraries===
Install system development tools (as root via su):
yum install gcc*
yum install subversion* expat* libtool* automake* bison* flex doxygen libjpeg-devel libpng libpng-devel

===Sun Java===
A Sun Java Development Kit is required. The plain package is fine, no need for NetBeans or Java EE. You can download the JDK from http://java.sun.com/javase/downloads/index.jsp. Detailed installation instructions can be found at http://wiki.centos.org/HowTos/JavaOnCentOS (follow the instructions for "Sun JDK 1.6").

Check <code>java -version<code> and should see "Java(TM)" somewhere in the output.

===Optional: PostgreSQL and PostGIS===
Current versions of PostgreSQL are maintained at http://yum.pgsqlrpms.org/. An overview for beginners can be found here: http://www.postgresonline.com/journal/index.php?/archives/45-An-Almost-Idiots-Guide-to-PostgreSQL-YUM.html

To use the repository, first block all others by editing the repos file. As root, edit the file (e.g.):
vim /etc/yum.repos.d/CentOS-Base.repo</code>
add to the bottom of the file:
exclude=postgresql*

Choose a version of PostgreSQL from http://yum.pgsqlrpms.org/reporpms/repoview/pgdg-centos.html, the current version 8.3.x is recommended

==Download source==
Download the source code for FDO-3.3.1 and MapGuide-2.0.2:
svn checkout http://svn.osgeo.org/fdo/tags/3.3.1/ fdo-3.3.1
svn checkout http://svn.osgeo.org/mapguide/tags/MAPGUIDE2.0.2/ mapguide-2.0.2

Building MapGuide on CentOS 5

2008-10-06T22:38:17Z

Wiki-Mwtoews: start instructions for CentOS5

==Prerequisite==
===User account===
If you have just installed the OS, be sure to create a user account for yourself from root:
adduser <username>
passwd <username>
Add yourself to the sudoer list from root:
visudo # (add your entry after root "<username> ALL=(ALL) ALL", at about line 77)
Logout of root, and log in as yourself.

===System development tools and libraries==
Install system development tools (as root via su):
yum install gcc*
yum install subversion* expat* libtool* automake* bison* flex doxygen libjpeg-devel libpng libpng-devel

===Sun Java===
A Sun Java Development Kit is required. The plain package is fine, no need for NetBeans or Java EE. You can download the JDK from http://java.sun.com/javase/downloads/index.jsp. Detailed installation instructions are found at http://wiki.centos.org/HowTos/JavaOnCentOS (follow the instructions for "Sun JDK 1.6").

==Download source==
Download the source code for FDO-3.3.1 and MapGuide-2.0.2:
svn checkout http://svn.osgeo.org/fdo/tags/3.3.1/ fdo-3.3.1
svn checkout http://svn.osgeo.org/mapguide/tags/MAPGUIDE2.0.2/ mapguide-2.0.2

Building MapGuide on Ubuntu 8.04

2008-10-06T20:41:37Z

Wiki-Mwtoews: italicize administrator

Below are instructions that will aid a user with installing FDO 3.3.1 and MapGuide Open Source 2.0.1 from SVN on Ubuntu 8.04 (Hardy Heron). It is based on previous instructions, lots of credit to their authors!

==NOTES==

The default directory used in these instructions is called /home/''administrator''. This assumes that you create your primary user account with the name "''administrator''". If you do not, mentally adjust where necessary.

You may want to consider using a client like PuTTY to access your server's terminal via openssh-server from a different computer. This really helps with copying and pasting. If so, either ensure that you install the OpenSSH server during your basic install, or add "openssh-server" to the list of packages below.

Any time that you run a task and pipe its output to a logfile, make sure that you look at the end of the logfile when you're done to make sure that it completed successfully. If it didn't then you have the logfile to post an error report from... Here's an example of how to do this:

tail -n 30 mylogfile.log

Compiled successfully on 32 bit machine. When compiled on my 64 bit machine, got error 'CPU you selected does not support x86-64 instruction set'

==BASIC SETUP==

Install a basic Ubuntu 8.04 (Hardy Heron). Once this is complete, you will have to add some extra packages to compile MapGuide. Make sure that you get all of these packages; the line is really long:

sudo apt-get install build-essential bison flex automake1.7 automake1.9 libtool doxygen subversion libjpeg62-dev libpng12-dev libfreetype6-dev libexpat1-dev libxalan110-dev libxslt1-dev expat libcurl4-openssl-dev libasound2-Dev python2.5-dev sun-java6-jdk gcc-4.1 g++-4.1

If Java fails to install, you may need to edit /etc/apt/sources.list to uncomment the multiverse repository lines and then try installing it again.

To avoid "bad fd number" errors, type the following in the terminal:

sudo dpkg-reconfigure dash

and choose No at the prompt. Be aware that this changes your default /bin/sh from dash back to bash.

Set the SUN Java to be the default Java installation:

sudo update-java-alternatives -s java-1.6.0-sun

Edit /etc/jvm, moving "/usr/lib/jvm/java-1.6.0-sun" to the top of the list

sudo nano /etc/jvm

Edit /etc/environment so that services will know where to look for Java

sudo nano /etc/environment

''(Add the following line)''

JAVA_HOME="/usr/lib/jvm/java-1.6.0-sun"

Note: I have problem compile with gcc-4.2 and g++-4.2. What I do is replace link /usr/bin/gcc and /usr/bin/g++ to version 4.1.

Log off and then log back on so that these settings take effect. Alternatively, export JAVA_HOME in your current session.

==FDO INSTALL==

In terminal type the following:

''(be prepared to wait a long time for this command to complete, the test data takes a while to download)
svn checkout http://svn.osgeo.org/fdo/tags/3.3.1/ fdo-3.3.1

''(type in your password after the following command if prompted. Note that this fdo-3.3.0, not fdo-3.3.1)''
sudo mkdir /usr/local/fdo-3.3.0

''(if you are not logged in as ''administrator'', you change the userid below!)''
sudo chown ''administrator'' /usr/local/fdo-3.3.0

''(when compile, I got error "occi.h: No such file or directory". This is for provider KingOracle. Since I don't need it anyway, I just remove folder /home/''administrator''/fdo-3.3.1/Providers/KingOracle)

cd fdo-3.3.1

source ./setenvironment.sh

In terminal, type the following to run the builds. Note, there will be no output from either command until completion as it is all being spooled to nohup.out. You can log into another terminal session and tail this file if you start getting antsy :-)

nohup ./build_thirdparty.sh 2>&1 | tee build_thirdparty.log

nohup ./build_linux.sh 2>&1 | tee build_linux.log

==APACHE / PHP INSTALL==

In Terminal type the following:

cd ~

''(you should now be in /home/''administrator'', or whatever your $HOME is)''

svn checkout http://svn.osgeo.org/mapguide/tags/MAPGUIDE2.0.1/ mapguide-2.0.1

sudo mkdir /usr/local/mapguideopensource

''(replace ''administrator'' with your userid if necessary)''

sudo chown ''administrator'' /usr/local/mapguideopensource

cd mapguide-2.0.1/Oem/LinuxApt

''(careful when copying and pasting this line, the - got changed into . for me)''

find . -name "*.gz" -exec tar xzf {} \;

nohup ./build_apt.sh 2>&1 | tee ../../build_apt.log

==BUILD OEM==

Perform the following:

cd ~/mapguide-2.0.1/

nohup ./build_oem.sh 2>&1 | tee build_oem.log

==BUILD MAPGUIDE==

Go for the Heron:

aclocal
libtoolize --force
automake --add-missing --copy
autoconf

./configure --enable-optimized

''(If you get error "missing liblib_json.so", then apply patch from http://trac.osgeo.org/mapguide/ticket/347)

nohup make 2>&1 | tee make_mapguide.log

nohup make install 2>&1 | tee install_mapguide.log

If you want to use webstudio, copy the files to the webserverextension folder:

cp -fpR /home/''administrator''/mapguide-2.0.1/Web/src/webstudio /usr/local/mapguideopensource/webserverextensions/www/webstudio

== STARTUP OPTIONS ==

While you're testing, it can be convenient to run services interactively, but eventually you'll want them to shut down / restart when you the computer is rebooted. This section gives you both options.

=== START SERVICES MANUALLY ===

Start Apache

sudo /usr/local/mapguideopensource/webserverextensions/apache2/bin/apachectl restart

Stop Apache

sudo /usr/local/mapguideopensource/webserverextensions/apache2/bin/apachectl stop

Start MapGuide

sudo /usr/local/mapguideopensource/server/bin/mgserverd.sh

Stop MapGuide

sudo pkill -f -u root "mgserver daemon"

Building Mapguide on Ubuntu 7.10 Server

2008-10-06T20:40:28Z

Wiki-Mwtoews: italicize administrator

Below are instructions that will aid a user with installing FDO 3.3 and MapGuide Open Source 2.0 from SVN trunk on Ubuntu 7.10 (Gutsy Gibbon) Server. It is based on previous instructions, lots of credit to their authors!

==NOTES==

By the time you read this, FDO 3.3 and MapGuide 2.0 may have their own branches in SVN. If so, just swap out references to /trunk/ with the appropriate /branch/* where necessary.

The default directory used in these instructions is called /home/''administrator''. This assumes that you create your primary user account with the name "''administrator''". If you do not, mentally adjust where necessary.

You may want to consider using a client like PuTTY to access your server's terminal via openssh-server from a different computer. This really helps with copying and pasting. If so, either ensure that you install the OpenSSH server during your basic install, or add "openssh-server" to the list of packages below.

Any time that you run a task and pipe its output to a logfile, make sure that you look at the end of the logfile when you're done to make sure that it completed successfully. If it didn't then you have the logfile to post an error report from... Here's an example of how to do this:

tail -n 30 mylogfile.log

==BASIC SETUP==

Install a basic Ubuntu Server 7.10 (Gutsy Gibbon). Once this is complete, you will have to add some extra packages to compile MapGuide. Make sure that you get all of these packages; the line is really long:

sudo apt-get install build-essential bison flex automake1.7 automake1.9 libtool doxygen subversion libjpeg62-dev libpng12-dev libfreetype6-dev libexpat1-dev libxalan110-dev libxslt1-dev expat libcurl4-openssl-dev libasound2-Dev python2.5-dev sun-java5-jdk

If Java fails to install, you may need to edit /etc/apt/sources.list to uncomment the multiverse repository lines and then try installing it again.

To avoid "bad fd number" errors, type the following in the terminal:

sudo dpkg-reconfigure dash

and choose No at the prompt. Be aware that this changes your default /bin/sh from dash back to bash.

Prepare your SVN profile to use the appropriate options for FDO and MapGuide. Type the following at the Terminal.

''(this just sets up your initial .subversion settings folder)''
svn info http://svn.osgeo.org/fdo

''(edit ~/.subversion/config)
nano .subversion/config

You can enable options by removing the comments (# ) in front of them, or just add new lines to the appropriate locations.

In the Miscellany section, enable:

use-commit-times = yes
enable-auto-props = yes

In the Auto-Props section, add:

*.*=svn:eol-style=native
*.sh=svn:executable

Save and close the config file.

Set the SUN Java to be the default Java installation:

sudo update-java-alternatives -s java-1.5.0-sun

Edit /etc/jvm, moving "/usr/lib/jvm/java-1.5.0-sun" to the top of the list

sudo nano /etc/jvm

Edit /etc/environment so that services will know where to look for Java

sudo nano /etc/environment

''(Add the following line)''

JAVA_HOME="/usr/lib/jvm/java-1.5.0-sun"

Log off and then log back on so that these settings take effect. Alternatively, export JAVA_HOME in your current session.

==FDO INSTALL==

In terminal type the following:

mkdir fdosvn

''(be prepared to wait a long time for this command to complete, the test data takes a while to download)
svn checkout http://svn.osgeo.org/fdo/trunk fdosvn

''(type in your password after the following command if prompted)''
sudo mkdir /usr/local/fdo-3.3.0

''(if you are not logged in as ''administrator'', you change the userid below!)''
sudo chown ''administrator'' /usr/local/fdo-3.3.0

cd fdosvn

source ./setenvironment.sh

In terminal, type the following to run the builds. Note, there will be no output from either command until completion as it is all being spooled to nohup.out. You can log into another terminal session and tail this file if you start getting antsy :-)

nohup ./build_thirdparty.sh > build_thirdparty.log

nohup ./build_linux.sh > build_linux.log

==APACHE / PHP INSTALL==

In Terminal type the following:

cd ~

''(you should now be in /home/''administrator'', or whatever your $HOME is)''

mkdir mgsvn

svn checkout http://svn.osgeo.org/mapguide/trunk/MgDev/ mgsvn

sudo mkdir /usr/local/mapguideopensource

''(replace ''administrator'' with your userid if necessary)''

sudo chown ''administrator'' /usr/local/mapguideopensource

cd mgsvn/Oem/LinuxApt

''(careful when copying and pasting this line, the - got changed into . for me)''

find . -name "*.gz" -exec tar xzf {} \;

nohup ./build_apt.sh > ../../build_apt.log

==BUILD OEM==

Perform the following:

cd ~/mgsvn/

nohup ./build_oem.sh > build_oem.log

==BUILD MAPGUIDE==

Go for the gusto:

aclocal
libtoolize --force
automake --add-missing --copy
autoconf

./configure --enable-optimized

nohup make > make_mapguide.log

nohup make install > install_mapguide.log



== STARTUP OPTIONS ==

While you're testing, it can be convenient to run services interactively, but eventually you'll want them to shut down / restart when you the computer is rebooted. This section gives you both options.

=== START SERVICES MANUALLY ===

Start Apache

sudo /usr/local/mapguideopensource/webserverextensions/apache2/bin/apachectl restart

Stop Apache

sudo /usr/local/mapguideopensource/webserverextensions/apache2/bin/apachectl stop

Start MapGuide

sudo /usr/local/mapguideopensource/server/bin/mgserverd.sh

Stop MapGuide

sudo pkill -f -u root "mgserver daemon"

=== SET SERVICES TO AUTO-START ===

'''!!! Warning, this is not working. See [http://trac.osgeo.org/mapguide/ticket/309 Ticket #309] !!!'''

Add Apache's control script into the system init structure:

sudo ln -s /usr/local/mapguideopensource/webserverextensions/apache2/bin/apachectl /etc/init.d/apache-mapguide

Set up some default run level actions for Apache (basically, start on interactive, stop on shutdown/restart)

sudo update-rc.d apache-mapguide defaults 30 70

Create a startup script for Mapguide server:

touch /usr/local/mapguideopensource/mapguidectl
chmod u=rwx,go=r /usr/local/mapguideopensource/mapguidectl
nano /usr/local/mapguideopensource/mapguidectl

Add the following contents:

#!/bin/sh
# MapGuide init script
. /lib/lsb/init-functions
case "$1" in
start)
log_daemon_msg "Starting MapGuide Server 2.0.0..."
export GDAL_DATA=/usr/local/mapguideopensource/server/bin/data
export PROJ_LIB=/usr/local/mapguideopensource/server/bin/nad
export LD_LIBRARY_PATH=/usr/local/fdo-3.3.0/lib:"$LD_LIBRARY_PATH"
pushd /usr/local/mapguideopensource/server/bin > /dev/null
./mgserver daemon > /dev/null
popd > /dev/null
log_end_msg 0
;;
stop)
log_daemon_msg "Stopping MapGuide Server 2.0.0..."
MGPROCESS=`/usr/bin/pgrep -f -u root "mgserver daemon"`
if [ "$MGPROCESS" != "" ]
then
/bin/kill $MGPROCESS
fi
log_end_msg 0
;;
*)
echo "Usage: $0 {start|stop}"
exit 1
;;
esac
exit 0

Add MapGuide's control script into the system init structure:

sudo ln -s /usr/local/mapguideopensource/mapguidectl /etc/init.d/mapguide

Set up some default run level actions for MapGuide (basically, start on interactive, stop on shutdown/restart)

sudo update-rc.d mapguide defaults 35 65

Restart and see if it works!

Building MapGuide on Ubuntu 8.04

2008-09-04T23:50:30Z

Wiki-Mwtoews: /* BUILD MAPGUIDE */ missing tee/Heron

Below are instructions that will aid a user with installing FDO 3.3.1 and MapGuide Open Source 2.0.1 from SVN on Ubuntu 8.04 (Hardy Heron). It is based on previous instructions, lots of credit to their authors!

==NOTES==

The default directory used in these instructions is called /home/administrator. This assumes that you create your primary user account with the name "administrator". If you do not, mentally adjust where necessary.

You may want to consider using a client like PuTTY to access your server's terminal via openssh-server from a different computer. This really helps with copying and pasting. If so, either ensure that you install the OpenSSH server during your basic install, or add "openssh-server" to the list of packages below.

Any time that you run a task and pipe its output to a logfile, make sure that you look at the end of the logfile when you're done to make sure that it completed successfully. If it didn't then you have the logfile to post an error report from... Here's an example of how to do this:

tail -n 30 mylogfile.log

Compiled successfully on 32 bit machine. When compiled on my 64 bit machine, got error 'CPU you selected does not support x86-64 instruction set'

==BASIC SETUP==

Install a basic Ubuntu 8.04 (Hardy Heron). Once this is complete, you will have to add some extra packages to compile MapGuide. Make sure that you get all of these packages; the line is really long:

sudo apt-get install build-essential bison flex automake1.7 automake1.9 libtool doxygen subversion libjpeg62-dev libpng12-dev libfreetype6-dev libexpat1-dev libxalan110-dev libxslt1-dev expat libcurl4-openssl-dev libasound2-Dev python2.5-dev sun-java6-jdk gcc-4.1 g++-4.1

If Java fails to install, you may need to edit /etc/apt/sources.list to uncomment the multiverse repository lines and then try installing it again.

To avoid "bad fd number" errors, type the following in the terminal:

sudo dpkg-reconfigure dash

and choose No at the prompt. Be aware that this changes your default /bin/sh from dash back to bash.

Set the SUN Java to be the default Java installation:

sudo update-java-alternatives -s java-1.6.0-sun

Edit /etc/jvm, moving "/usr/lib/jvm/java-1.6.0-sun" to the top of the list

sudo nano /etc/jvm

Edit /etc/environment so that services will know where to look for Java

sudo nano /etc/environment

''(Add the following line)''

JAVA_HOME="/usr/lib/jvm/java-1.6.0-sun"

Note: I have problem compile with gcc-4.2 and g++-4.2. What I do is replace link /usr/bin/gcc and /usr/bin/g++ to version 4.1.

Log off and then log back on so that these settings take effect. Alternatively, export JAVA_HOME in your current session.

==FDO INSTALL==

In terminal type the following:

''(be prepared to wait a long time for this command to complete, the test data takes a while to download)
svn checkout http://svn.osgeo.org/fdo/tags/3.3.1/ fdo-3.3.1

''(type in your password after the following command if prompted. Note that this fdo-3.3.0, not fdo-3.3.1)''
sudo mkdir /usr/local/fdo-3.3.0

''(if you are not logged in as administrator, you change the userid below!)''
sudo chown administrator /usr/local/fdo-3.3.0

''(when compile, I got error "occi.h: No such file or directory". This is for provider KingOracle. Since I don't need it anyway, I just remove folder /home/administrator/fdo-3.3.1/Providers/KingOracle)

cd fdo-3.3.1

source ./setenvironment.sh

In terminal, type the following to run the builds. Note, there will be no output from either command until completion as it is all being spooled to nohup.out. You can log into another terminal session and tail this file if you start getting antsy :-)

nohup ./build_thirdparty.sh 2>&1 | tee build_thirdparty.log

nohup ./build_linux.sh 2>&1 | tee build_linux.log

==APACHE / PHP INSTALL==

In Terminal type the following:

cd ~

''(you should now be in /home/administrator, or whatever your $HOME is)''

svn checkout http://svn.osgeo.org/mapguide/tags/MAPGUIDE2.0.1/ mapguide-2.0.1

sudo mkdir /usr/local/mapguideopensource

''(replace administrator with your userid if necessary)''

sudo chown administrator /usr/local/mapguideopensource

cd mapguide-2.0.1/Oem/LinuxApt

''(careful when copying and pasting this line, the - got changed into . for me)''

find . -name "*.gz" -exec tar xzf {} \;

nohup ./build_apt.sh 2>&1 | tee ../../build_apt.log

==BUILD OEM==

Perform the following:

cd ~/mapguide-2.0.1/

nohup ./build_oem.sh 2>&1 | tee build_oem.log

==BUILD MAPGUIDE==

Go for the Heron:

aclocal
libtoolize --force
automake --add-missing --copy
autoconf

./configure --enable-optimized

''(If you get error "missing liblib_json.so", then apply patch from http://trac.osgeo.org/mapguide/ticket/347)

nohup make 2>&1 | tee make_mapguide.log

nohup make install 2>&1 | tee install_mapguide.log

If you want to use webstudio, copy the files to the webserverextension folder:

cp -fpR /home/administrator/mapguide-2.0.1/Web/src/webstudio /usr/local/mapguideopensource/webserverextensions/www/webstudio

== STARTUP OPTIONS ==

While you're testing, it can be convenient to run services interactively, but eventually you'll want them to shut down / restart when you the computer is rebooted. This section gives you both options.

=== START SERVICES MANUALLY ===

Start Apache

sudo /usr/local/mapguideopensource/webserverextensions/apache2/bin/apachectl restart

Stop Apache

sudo /usr/local/mapguideopensource/webserverextensions/apache2/bin/apachectl stop

Start MapGuide

sudo /usr/local/mapguideopensource/server/bin/mgserverd.sh

Stop MapGuide

sudo pkill -f -u root "mgserver daemon"

Building Mapguide on Ubuntu 7.10 Server

2008-09-03T00:46:25Z

Wiki-Mwtoews: update to exact apperance in file

Below are instructions that will aid a user with installing FDO 3.3 and MapGuide Open Source 2.0 from SVN trunk on Ubuntu 7.10 (Gutsy Gibbon) Server. It is based on previous instructions, lots of credit to their authors!

==NOTES==

By the time you read this, FDO 3.3 and MapGuide 2.0 may have their own branches in SVN. If so, just swap out references to /trunk/ with the appropriate /branch/* where necessary.

The default directory used in these instructions is called /home/administrator. This assumes that you create your primary user account with the name "administrator". If you do not, mentally adjust where necessary.

You may want to consider using a client like PuTTY to access your server's terminal via openssh-server from a different computer. This really helps with copying and pasting. If so, either ensure that you install the OpenSSH server during your basic install, or add "openssh-server" to the list of packages below.

Any time that you run a task and pipe its output to a logfile, make sure that you look at the end of the logfile when you're done to make sure that it completed successfully. If it didn't then you have the logfile to post an error report from... Here's an example of how to do this:

tail -n 30 mylogfile.log

==BASIC SETUP==

Install a basic Ubuntu Server 7.10 (Gutsy Gibbon). Once this is complete, you will have to add some extra packages to compile MapGuide. Make sure that you get all of these packages; the line is really long:

sudo apt-get install build-essential bison flex automake1.7 automake1.9 libtool doxygen subversion libjpeg62-dev libpng12-dev libfreetype6-dev libexpat1-dev libxalan110-dev libxslt1-dev expat libcurl4-openssl-dev libasound2-Dev python2.5-dev sun-java5-jdk

If Java fails to install, you may need to edit /etc/apt/sources.list to uncomment the multiverse repository lines and then try installing it again.

To avoid "bad fd number" errors, type the following in the terminal:

sudo dpkg-reconfigure dash

and choose No at the prompt. Be aware that this changes your default /bin/sh from dash back to bash.

Prepare your SVN profile to use the appropriate options for FDO and MapGuide. Type the following at the Terminal.

''(this just sets up your initial .subversion settings folder)''
svn info http://svn.osgeo.org/fdo

''(edit ~/.subversion/config)
nano .subversion/config

You can enable options by removing the comments (# ) in front of them, or just add new lines to the appropriate locations.

In the Miscellany section, enable:

use-commit-times = yes
enable-auto-props = yes

In the Auto-Props section, add:

*.*=svn:eol-style=native
*.sh=svn:executable

Save and close the config file.

Set the SUN Java to be the default Java installation:

sudo update-java-alternatives -s java-1.5.0-sun

Edit /etc/jvm, moving "/usr/lib/jvm/java-1.5.0-sun" to the top of the list

sudo nano /etc/jvm

Edit /etc/environment so that services will know where to look for Java

sudo nano /etc/environment

''(Add the following line)''

JAVA_HOME="/usr/lib/jvm/java-1.5.0-sun"

Log off and then log back on so that these settings take effect. Alternatively, export JAVA_HOME in your current session.

==FDO INSTALL==

In terminal type the following:

mkdir fdosvn

''(be prepared to wait a long time for this command to complete, the test data takes a while to download)
svn checkout http://svn.osgeo.org/fdo/trunk fdosvn

''(type in your password after the following command if prompted)''
sudo mkdir /usr/local/fdo-3.3.0

''(if you are not logged in as administrator, you change the userid below!)''
sudo chown administrator /usr/local/fdo-3.3.0

cd fdosvn

source ./setenvironment.sh

In terminal, type the following to run the builds. Note, there will be no output from either command until completion as it is all being spooled to nohup.out. You can log into another terminal session and tail this file if you start getting antsy :-)

nohup ./build_thirdparty.sh > build_thirdparty.log

nohup ./build_linux.sh > build_linux.log

==APACHE / PHP INSTALL==

In Terminal type the following:

cd ~

''(you should now be in /home/administrator, or whatever your $HOME is)''

mkdir mgsvn

svn checkout http://svn.osgeo.org/mapguide/trunk/MgDev/ mgsvn

sudo mkdir /usr/local/mapguideopensource

''(replace administrator with your userid if necessary)''

sudo chown administrator /usr/local/mapguideopensource

cd mgsvn/Oem/LinuxApt

''(careful when copying and pasting this line, the - got changed into . for me)''

find . -name "*.gz" -exec tar xzf {} \;

nohup ./build_apt.sh > ../../build_apt.log

==BUILD OEM==

Perform the following:

cd ~/mgsvn/

nohup ./build_oem.sh > build_oem.log

==BUILD MAPGUIDE==

Go for the gusto:

aclocal
libtoolize --force
automake --add-missing --copy
autoconf

./configure --enable-optimized

nohup make > make_mapguide.log

nohup make install > install_mapguide.log



== STARTUP OPTIONS ==

While you're testing, it can be convenient to run services interactively, but eventually you'll want them to shut down / restart when you the computer is rebooted. This section gives you both options.

=== START SERVICES MANUALLY ===

Start Apache

sudo /usr/local/mapguideopensource/webserverextensions/apache2/bin/apachectl restart

Stop Apache

sudo /usr/local/mapguideopensource/webserverextensions/apache2/bin/apachectl stop

Start MapGuide

sudo /usr/local/mapguideopensource/server/bin/mgserverd.sh

Stop MapGuide

sudo pkill -f -u root "mgserver daemon"

=== SET SERVICES TO AUTO-START ===

'''!!! Warning, this is not working. See [http://trac.osgeo.org/mapguide/ticket/309 Ticket #309] !!!'''

Add Apache's control script into the system init structure:

sudo ln -s /usr/local/mapguideopensource/webserverextensions/apache2/bin/apachectl /etc/init.d/apache-mapguide

Set up some default run level actions for Apache (basically, start on interactive, stop on shutdown/restart)

sudo update-rc.d apache-mapguide defaults 30 70

Create a startup script for Mapguide server:

touch /usr/local/mapguideopensource/mapguidectl
chmod u=rwx,go=r /usr/local/mapguideopensource/mapguidectl
nano /usr/local/mapguideopensource/mapguidectl

Add the following contents:

#!/bin/sh
# MapGuide init script
. /lib/lsb/init-functions
case "$1" in
start)
log_daemon_msg "Starting MapGuide Server 2.0.0..."
export GDAL_DATA=/usr/local/mapguideopensource/server/bin/data
export PROJ_LIB=/usr/local/mapguideopensource/server/bin/nad
export LD_LIBRARY_PATH=/usr/local/fdo-3.3.0/lib:"$LD_LIBRARY_PATH"
pushd /usr/local/mapguideopensource/server/bin > /dev/null
./mgserver daemon > /dev/null
popd > /dev/null
log_end_msg 0
;;
stop)
log_daemon_msg "Stopping MapGuide Server 2.0.0..."
MGPROCESS=`/usr/bin/pgrep -f -u root "mgserver daemon"`
if [ "$MGPROCESS" != "" ]
then
/bin/kill $MGPROCESS
fi
log_end_msg 0
;;
*)
echo "Usage: $0 {start|stop}"
exit 1
;;
esac
exit 0

Add MapGuide's control script into the system init structure:

sudo ln -s /usr/local/mapguideopensource/mapguidectl /etc/init.d/mapguide

Set up some default run level actions for MapGuide (basically, start on interactive, stop on shutdown/restart)

sudo update-rc.d mapguide defaults 35 65

Restart and see if it works!