Menu:

Getting Started with aisCOAL

aisCOAL is currently pre-alpha, so there aren't any nice downloadable archives yet. If you want to play with the pre-alpha code in the trunk, you can get it via Subversion. To compile it, you'll naturally need some software that supplies CKPT. aisCOAL is currently tested against openais.


	1. Install software that implements the AIS CKPT specification.

	1a. For this example, we'll use openais. Make and install from the repository.

	[root@devbox src]# svn checkout http://svn.osdl.org/openais/tags/version_0.81/ openais_0.81
	[root@devbox src]# cd openais_0.81 && make && make install DESTDIR=/

	1b. Create the needed certificates (again, this is openais specific).
	[root@devbox openais_0.81]# /usr/sbin/ais-keygen

	1c. Start the openais executive.
	[root@devbox openais_0.81]# /usr/sbin/aisexec

	1d. Update the dynamic loader
	[root@devbox openais_0.81]# ldconfig /usr/lib/openais

	2. Get the source for aisCOAL from SourceForge

	Option 1: Use the subversion repository.
	[root@devbox src]# svn co https://aiscoal.svn.sourceforge.net/svnroot/aiscoal/trunk aiscoal

	Option 2: Download a source tarball from SourceForge. (N/A until the offical alpha release)
	Browse to the SF Project page
	Click the Download link in the menu for the latest stable tarball

	3. Compile and install aisCOAL
	[root@devbox src]# cd aiscoal && make && make install

	4. Run the unitTests.

	4a. aisCOAL uses CPPUnit for its unit tests.
	CPPUnit must be installed on your system in order to compile and use the unitTest suite.
	Follow the CPPUnit directions to install on your system.

	4b. Compile and run the unitTests
	[root@devbox aiscoal]# make unitTests

	...compilation happens here...

	-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
	 aisCOAL Unit Tests
	-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
	AisCOALTests::testContainerCreation. : OK
	AisCOALTests::testPersist. : OK
	AisCOALTests::testSize. : OK
	AisCOALTests::testWrapper. : OK
	AisCOALTests::testCommit. : OK
	AisCOALTests::testRemove. : OK
	AisCOALTests::testRetention. : OK

Congratulations! At this point, you have a working installation of aisCOAL! The online documentation has key information on how to use the container and object classes, as well as information about linking with the lib. You can also reference the Makefile for the test code in the aiscoal/tests directory for specifics on how to link with the library and start using aisCOAL in your own project!