Building on Windows

Software to install

Boost library binaries installer can be obtained from http://code.google.com/p/exodusdb/downloads or boost.org.

1. PostgresSQL 8.3
2. TortoiseSVN 1.6.10 (but any version should do)
3. Boost C++ libraries 1.38.0
4. MSVC2005 or MSVS C++ Express Edition 2005 or 2008
5. Windows Platform SDK (only if using Express 2005).

or

1. PostgresSQL 9.0
2. TortoiseSVN 1.6
3. Boost C++ libraries 1.43.0
4. MSVC 2010 Express

Installation Locations

If installing off the C: drive, keep everything on the same drive and in the standard directory tree otherwise you will have to modify the project settings to point to the right include and lib folders.

D:\Program Files\boost\boost_1_38_0
D:\Program Files\PostgreSQL\8.3
D:\Documents and settings\steve\Desktop\exodus

Installing Postgres

Installing Tortoise Subversion

Installing Boost

Installing Visual Studio Express C++

Getting Project Exodus onto your Computer:

Using the command console

1. Get a command console
2. c:
3. cd \
4. either: svn checkout http://exodusdb.googlecode.com/svn/trunk/ exodusdb
5. or: svn checkout https://exodusdb.googlecode.com/svn/trunk/ exodusdb --username neosys.com@gmail.com

Using Windows

1. Go to your C: (or other drive) root folder desktop, and create a new folder.
2. Right click on the folder, and click TortoiseSVN, checkout.
3. In the URL field put http://exodusdb.googlecode.com/svn/trunk and click Ok.
4. Another window will pop up, and start listing the files you are importing onto your pc.
5. Click Ok, once loading is finished.

For help on how to use: http://devwiki.neosys.com/index.php/Installing_and_Using_Tortoise_Subversion

Building and installing pgexodus

pgexodus is a shared library providing basic functions that allow postgres so see fields and therefore perform sorting, selecting and indexing on fields.

Downloading and installing prebuilt binary for Windows

If you are updating exodus pgexodus.dll after using it then stop and restart the postgres service to remove it from memory otherwise you will not be able to download and update it.

download and extract pgexodus.dll from File:Pgexodus.zip into \program files\postgresql\8.3\lib

Building Exodus - All

1. Open the exodus_all.sln file in the new folder that you created.
2. In the solution view, right click "Solution exodus_all" and select "Build"

Possible Problems During Building

error: "errcode redefinition ... " in elog.h

Error	1	error C2365: 'errcode' : redefinition; previous definition was 'typedef'	d:\program files\postgresql\8.3\include\server\utils\elog.h	105

then double click the error to open the offending file and comment out the offending line as follows:

//extern int	errcode(int sqlerrcode);

error: Cannot open include file: 'libintl.h'

Compiling...
pgexodus.c
c:\program files\postgresql\8.3\include\server\c.h(96) : fatal error C1083: Cannot open include file: 'libintl.h': No such file or directory

just make an empty file called libintl.h as follows:

\Program Files\PostgreSQL\8.3\include\server\port\win32\libintl.h

LINK : fatal error LNK1104: cannot open file 'libboost_date_time-vc90-mt-gd-1_38.lib'
LINK : fatal error LNK1104: cannot open file 'libboost_thread-vc90-mt-gd-1_38.lib'
LINK : fatal error LNK1104: cannot open file 'libboost_regex-vc90-mt-gd-1_38.lib'
LINK : fatal error LNK1104: cannot open file 'libboost_filesystem-vc90-mt-gd-1_38.lib'
LINK : fatal error LNK1104: cannot open file 'libboost_system-vc90-mt-gd-1_38.lib'

Make sure that you have installed the right boost libraries

• Compiler: Visual C++ 9.0 (Visual Studio 2008)
• Variants: Multithread and Multithread Debug
• Components: (1)Date and Time (2)Filesystem (3)Regex (4)System (5)Thread

Declaring the dll in Postgres

After copying the pgexodus.dll to the postgres library folder you can run configexodus to configure postgres automatically, or perform the following procedure.

You must login as a postgres superuser to do the following since the C language is not trusted.

In pgadmin or some other tool, select the "POSTGRES" database

Run the following as an sql command to create the necessary special functions that exodus requires to perform dictionary extractions for sort/select etc.

For more info, see Dynamic loading at http://www.postgresql.org/docs/current/static/xfunc-c.html

-- cut and paste the following SQL to register the functions into postgres --

CREATE OR REPLACE FUNCTION exodus_call(bytea, bytea, bytea, bytea, bytea, int4, int4) RETURNS bytea AS 'pgexodus', 'exodus_call' LANGUAGE C IMMUTABLE;

CREATE OR REPLACE FUNCTION exodus_extract_bytea(bytea, int4, int4, int4) RETURNS bytea AS 'pgexodus', 'exodus_extract_bytea' LANGUAGE C IMMUTABLE;

CREATE OR REPLACE FUNCTION exodus_extract_text(bytea, int4, int4, int4) RETURNS text AS 'pgexodus', 'exodus_extract_text' LANGUAGE C IMMUTABLE;

CREATE OR REPLACE FUNCTION exodus_extract_sort(bytea, int4, int4, int4) RETURNS text AS 'pgexodus', 'exodus_extract_sort' LANGUAGE C IMMUTABLE;

-- Remaining functions are STRICT therefore never get called with NULLS -- also return NULL if passed zero length strings

CREATE OR REPLACE FUNCTION exodus_extract_text2(bytea, int4, int4, int4) RETURNS text AS 'pgexodus', 'exodus_extract_text2' LANGUAGE C IMMUTABLE STRICT;

CREATE OR REPLACE FUNCTION exodus_extract_date(bytea, int4, int4, int4) RETURNS date AS 'pgexodus', 'exodus_extract_date' LANGUAGE C IMMUTABLE STRICT;

CREATE OR REPLACE FUNCTION exodus_extract_time(bytea, int4, int4, int4) RETURNS time AS 'pgexodus', 'exodus_extract_time' LANGUAGE C IMMUTABLE STRICT;

CREATE OR REPLACE FUNCTION exodus_extract_datetime(bytea, int4, int4, int4) RETURNS timestamp AS 'pgexodus', 'exodus_extract_datetime' LANGUAGE C IMMUTABLE STRICT;

Granting Exodus access to Postgres

Use pgadmin to create a user role with whichever role privileges you wish and a database.

Any roles that you do not grant exodus will have to be performed using pgadmin or other postgres management tools.

CREATE ROLE exodus LOGIN
 PASSWORD 'somesillysecret'
 CREATEDB CREATEROLE;

CREATE DATABASE exodus
 WITH ENCODING='UTF8'
      OWNER=exodus;

Running Exodus

1. In the solution explorer view, right click "exodus_cli"
2. Set as startup project.
3. Run Exodus CLI from the menu ... Debug, Start Debugging.

Possible Problems During Execution

libpq.dll

1. Check whether libpq.dll is in C:\Program Files\PostgreSQL\8.3\lib\????, if not there then change project properties to reflect version on location in where you installed postgreSQL.
2. Right click on My computer, properties, advanced, environment variables, system variables, scroll down and find Path, double click it. variable value, go to the end of the path and type a semi-colon, then copy and paste the following path after the semi-colon:
   C:\Program Files\PostgreSQL\8.3\lib\ms and close Visual Studio C++ Express Edition, and then open again.

ssleay32.dll

There are dozens of versions of this open source secure sockets library which are widely used by many vendors some of whom very wrongly install them in the windows\system32 folder which has precedence after the local folder but before the path is searched. postgres requires them and will use the wrong version.

The simplest solution is often to delete them.

del c:\Windows\system32\ssleay32.dll del c:\Windows\system32\libeay32.dll

If you cannot delete them then try rebooting. If that doesnt work then find out which program has them open using some dll search facility like sysinternals procexplorer.

Another solution is simply to upgrade them to the latest version of the files that you can find on your computer or on the web or from the postgres bin folder. See properties not the file date.

INITIAL VERSION BY GREG BUSH 19/10/2007

Helpful Websites

1. For help on Microsoft Visual Studio C++ Express Edition go to http://msdn2.microsoft.com/en-gb/express/aa700755.aspx
2. For help on Boost go to http://www.boost.org
3. For help on PostgeSQL go to http://www.postgresql.org/
4. For help on WinRAR go to http://www.win-rar.com/winrarsupport.html
5. For help on TortoiseSVN go to http://tortoisesvn.tigris.org/
6. For how to use tortoiseSVN go to Installing_and_Using_Tortoise_Subversion