Author: neilt Date: 2005-10-10 07:01:54 -0500 (Mon, 10 Oct 2005) New Revision: 8044
Added: trunk/gnue-common/doc/install-mac-os-x.txt Log: Add Mac OS X short instructions. Added: trunk/gnue-common/doc/install-mac-os-x.txt =================================================================== --- trunk/gnue-common/doc/install-mac-os-x.txt 2005-10-10 11:13:21 UTC (rev 8043) +++ trunk/gnue-common/doc/install-mac-os-x.txt 2005-10-10 12:01:54 UTC (rev 8044) @@ -0,0 +1,153 @@ +These instructions are for installation GNUE on Mac OS X 10.4.2. They +do not assume any knowledge of the core technologies (fink, python, +postgresql etc.) You will install all GNU Enterprise tools and run a +sample form application. + +Do not let the length or apparent complexity fool you. Setting up GNUE +with Mac OS X is easy. + +These instructions use appserver (which is not required), fink, bbedit, +and PostgreSQL database. The path you use for the postgresql database +should be different. You may use vi instead of bbedit to edit text +files. + +For information about installing fink see http://fink.sourceforge.net/ + +These instructions assume you are using the command line terminal. +Lines starting with "#" are comments. + +Report any problems with these instructions to neilt<at>gnue.org + +# Install Prerequisites +# =========================== +fink install xorg +fink install xorg-dev +fink install wxgtk +fink install python24 +fink install wxpython-py24 +fink install wxpython-py24-dev +fink install postgresql80-unified +fink install postgresql80-unified-dev +fink install pyxml-py24 +fink install python-mx-py24 + +# Download psycopg 1.1.18 at http://initd.org/pub/software/psycopg/PSYCOPG-1-1/ + +# expand the download file + +# cd into the download source directory + +./configure --with-mxdatetime-includes=/sw/lib/python2.4/site-packages/mx/DateTime/mxDateTime +make MACOSX_DEPLOYMENT_TARGET=10.4 +sudo make install + +# Install GNUE +# ================== + +# get ready to edit the .cshrc file + +cd ~ +bbedit .cshrc + +# add the following to your ".cshrc" file. (assumes you are running c shell) +setenv DISPLAY localhost:0.0 + +# save the file and exit the editor + +# close and reopen terminal + +# start xDarwin.app (click on it) + +# for the following you will need to download fink info files from the gnue +# site. They are located in the folder <package name>/packaging/fink. +# psycopg-py24 is the folder for gnue-common. +# Download gnue-common example location: +# http://svn.gnuenterprise.org/gnue/trunk/gnue-common/packaging/fink/ + +fink install psycopg-py24 +fink install gnue-common +fink install gnue-appserver +fink install gnue-forms +fink install gnue-reports +fink install gnue-designer +fink install gnue-navigator + +# Quick Configuration +# =================== +# initialize postgresql database +# any writable path will work here, but be sure to use the same path in the +# following commands for postgresql. + +/sw/bin/initdb -D /Maui-Dev/gnue_mac_porting_notes/pg_data + +# start postgresql + +/sw/bin/pg_ctl -D /Maui-Dev/gnue_mac_porting_notes/pg_data -l /Maui-Dev/gnue_mac_porting_notes/pg_data/pg_logfile.txt start + +createlang plpgsql template1 + +sudo cp /sw/etc/sample.connections.conf /sw/etc/connections.conf + +# edit /sw/etc/connections.conf + +bbedit /sw/etc/connections.conf + +sudo cp /sw/etc/sample.gnue.conf /sw/etc/gnue.conf + +# edit /sw/etc/gnue.conf + +bbedit /sw/etc/gnue.conf + +# setup appserver database + +cd /sw/share/gnue/appserver +/sw/bin/gnue-setupdb --connection=gnue ./gnue.gsd + +# Quick Run Example +# ================= + +cd /sw/share/doc/gnue-appserver/examples + +gnue-readgcd --connection=gnue sample.gcd + +# (expect to see the following) +# Loading gcd files ... +# Updating schema ... +# Updating class repository ... +# Modules : 1 inserted, 0 updated, 0 unchanged. +# Classes : 2 inserted, 0 updated, 0 unchanged. +# Properties: 24 inserted, 0 updated, 0 unchanged. +# Procedures: 6 inserted, 0 updated, 0 unchanged. +# Parameters: 0 inserted, 0 updated, 0 unchanged. + +gnue-readgld --connection=gnue sample-*.gld + +# (expect to see the following) +# Loading GNUe language definitions +# Labels : 30 inserted, 0 updated, 0 unchanged. +# Messages: 4 inserted, 0 updated, 0 unchanged. + +gnue-schema --connection=gnue sample.gsd + +# (expect to see the following) +# You are about to change the database 'gnue'. Continue [y,N]: y +# Updating schema ... +# Updating data ... +# updating table 'address_country' ... +# Rows: 240 inserted, 0 updated, 0 unchanged. +# updating table 'address_person' ... +# Rows: 4 inserted, 0 updated, 0 unchanged. + +# start appserver + +/sw/bin/gnue-appserver -Z -u ntiffin + +# alternative start command if you need debug info +# /sw/bin/gnue-appserver -Z --debug-level 9 -u ntiffin + +#try sample application + +/sw/bin/gnue-forms -s sample.gfd + +# you should see a form in xWindows +# done with basic installation and testing _______________________________________________ Commit-gnue mailing list [email protected] http://lists.gnu.org/mailman/listinfo/commit-gnue
