Search:  
Gentoo Wiki

Project-open

This article is still a Stub. You can help Gentoo-Wiki by expanding it.

Contents

Introduction

This HOWTO describes how to install project-open, a Web-based ERP/Project Management software, on a Gentoo system. As ]po[ isn't in the portage tree, and depends on older versions of software, installation by following the ]po[ documentation can be confusing for first-timers. In this HOWTO it is assumed the reader has a fully-functional Gentoo system.

Notice: comments and constructive criticism are welcome on the discussion and bugs page!

Warning: This is a work in progress, if it breaks your system, please don't blame me! The goal was to use all portage packages, but AOLServer from portage won't work, if someone wants to investigate, test this, and write up for the AOLServer on portage that would be great.

Installation

The first step in installing [project-open] is downloading the compressed archive from SourceForge. Select the plus mark to expand the 3.1 branch downloads and download the file ProjectOpen-3.1.2.0.LinuxInstaller.tgz to your home folder.

Required Dependencies

]project-open[ requires the following packages, it is recommended to install these first. The requirements are taken from the ]po[ installation guide for 3.1, if installing 3.2 see its respective list.

For ]po[ 3.x

Installing Dependencies for 3.1

PostgreSQL

As of the time this document was written the latest version of PostgreSQL on portage was 8.0.9-r1, which isn't compatible with ]po[ 3.1, instead of using the standard emerge command, the version must be specified.

Code: Let's specify version 7.4.14 for compiling
# emerge =postgresql-7.4.14
# emerge --config =postgresql-7.4.14 

Now we should change the password for postgre, the username (that should have been) created by portage for working with postgreSQL.

Code: Let's setup the postgre user
# passwd postgres //Choose the password for the user postgre

If you get the error:

passwd: Authentication token manipulation error

You need to add a line of code to /etc/shadow.

Code: Let's edit /etc/shadow
# nano -w /etc/shadow

At the bottom add the following line of code

postgres::::::::

Now try setting the password again, it should work. If you have more things that you want to do with PostgreSQL check out HOWTO Configure Postgresql. It will go into more depth on configuring PostgreSQL, as this article only covers what's needed to get ]po[ working.

CVS

Installing CVS is easy, as the latest on portage is 1.12.12-r2 which fulfills the dependency version requirement.

Code: Let's install CVS
# emerge cvs
AOLServer

For AOLServer there is a choice, either use the binaries provided, or grab it from portage. This section will focus on the included binary, the next section covers installing AOLServer from portage. Choose the included binary if testing and debugging isn't an option.

Remember where that project-open.3-1-2-0-0.tgz tarball was saved? Now the files contained in this file need to be extracted.

Code: Let's extract project-open.3-1-2-0-0.tgz's contents
# tar xzf project-open.3-1-2-0-0.tgz

After this completes, there should be two more tarballs and a installation file

Since you are reading this guide, there is no need for INSTALL, project-open.3-1-2-0-0.tgz is the tarball containing all of the core files for ]po[, aolserver3.3oacs.tgz contains the AOLServer binaries that are distributed with ]po[. For these binaries to work they need to be in /usr/local. Remember for this example the user name that is doing the work is johnh, your user name may be different and should be replaced accordingly.

Code: Let's copy aolserver3.3oacs.tgz to /usr/local and extract
# cp /home/johnh/aolserver3.3oacs.tgz /usr/local
# tar xzf aolserver3.3oacs.tgz

Now that the binaries are now extracted, they should be tested to see if they work

Code: Let's test if AOLServer works
# /usr/local/aolserver3.3oacs/bin/nsd -h

If a help menu is displayed then the binaries work.

AOLServer (from portage)
Warning: The gentoo ebuild for AOLServer may not work, and is has been orphaned on portage, use it at your own risk!

AOLServer is needed for it's TCL interpretation, which means the tcl USE flag must be used otherwise ]po[ won't work. The TCL language needs the threads USE flag as well. If these aren't in your make.conf, or you don't want them there, then lets add them to package.use.

Code: Let's edit package.use
# nano -w /etc/portage/package.use

Now add the following line to package.use and save the file

dev-lang/tcl threads
www-servers/aolserver tcl

A quick check of portage reveals that AOLserver is masked as unstable so an block work around must be made in /etc/portage/package.keywords

Code: Let's edit package.keywords
# nano -w /etc/portage/package.keywords

Now add the following line to package.keywords and save the file

~www-servers/aolserver-4.0.10

After completing the above, AOLServer should merge correctly using emerge.

Code: Let's install AOLServer
# emerge aolserver
Misc.

Now that everything is emerged it should be started and added to the default runlevel. CVS isn't crutial to the opperation of ]po[ and thus is left out of the step, but may be included if desired.

Code: Let's start and add the dependencies to the default runlevel
# /etc/init.d/postgresql start
# rc-update add postgresql default
# /etc/init.d/aolserver start
# rc-update add aolserver default

If any error occur when starting a process make sure that the second emerge command for postgreSQL was run othewise it won't have a database (or configuration files) to load.

Installing Dependencies for 3.2

See instructions of 3.1 for 3.2betas

Installing [project-open]

Warning: This section is not complete, don't follow it's instructions yet unless you are willing to debug the process

The first step in installing [project-open] is downloading the compressed archive from SourceForge. Select the plus mark to expand the 3.1 branch downloads and download the file ProjectOpen-3.1.2.0.LinuxInstaller.tgz to your home folder.

Configuring Database

With the files in place let's switch into the postgre user and check if postgreSQL is running or not.

Code: Let's start and add the dependencies to the default runlevel
# su postgre
# psql --help

You should be greeted with the following (the first line of many)

This is psql 7.4.14, the PostgreSQL interactive terminal.

If so, then postgreSQL was installed. Now we can setup the user, database, and language for ]po[.

Code: Let's setup the user, database, and language for ]po[
# createuser -a -d projop
# createdb --owner=projop projop
# createlang plpgsql projop
# exit

Note that the last line switches the user back to the root, or what ever user you were previously.

Loading Sample Data (Recomended but Optional)

]project-open[ comes with two demo databases, ]projoect-consulting[ and ]project-translation[.

Note: If you are interested in the other two project types ]project-lifecycle[ or ]project-agency[ choose the ]project-consulting[ demo as the three are very simmilar.

After selecting one of the two project databases to load switch to the projop user and load the files into the database.

Code: Let's load a demo into the ]po[ database
# su projop
# cd /var/www/ns-localhost/projop/packages/intranet-core/preconf
//do only one of the following
# psql projop -f pc.preconf.sql //for ]project-consulting[
# psql projop -f pt.preconf.sql //for ]project-translation[

Now to check if the process was sucessfull we are going to do a SQL quere.

Code: Let's check if the demo was properly loaded
# psql projop
=# select count(*) from users;

For either demo the result should be 192. You can exit by typing \q

Custom Login

If you loaded a demo database, you will need to complete this step. Each project has its own login, and should have it's respective login loaded.

Code: Let's choose a custom login
//do these if you are using ]project-consulting[
# cp -f pc.index.tcl /var/www/ns-loacalhost/projop/www/index.tcl
# cp -f pc.index.adp /var/www/ns-loacalhost/projop/www/index.adp
//do these if you are using ]project-translation[
# cp -f pt.index.tcl /var/www/ns-loacalhost/projop/www/index.tcl
# cp -f pt.index.adp /var/www/ns-loacalhost/projop/www/index.adp

The -f was used to force the overwriting of the file, do this with caution.

Retrieved from "http://www.gentoo-wiki.info/Project-open"

Last modified: Tue, 30 Sep 2008 22:21:00 +0000 Hits: 6,893