OSSuite Enterprise Software

[ElgertS]

PROJECT DESCRIPTION

OSSuite 1.0.2 [http://www.ossuite.org/] is an Enterprise Software project being developed in open source. It currently comprises an e-Commerce shopping cart coupled with a complete ERP back end system. The two modules are tied together to compromise a total business solution to handle the requirements of all departments within an organization. A third CRM module is under development and will be integrated with the whole on a later date. The system does not currently handle services billing, but groundwork has been laid for its later incorporation.

The project is built in PHP and is designed to work with PHP 4.2.3. WIth very slight modifications to their code I was able to get the project to run correctly on PHP 4.3.2. Many of the additional required support software comes installed on Mac OS X Server 10.2 including Apache, MySQL, OpenSSL, and curl. Further software packages will need to be installed to fully utilize this extensive project.

[ElgertS]

Step 1: Installation of support packages.

OSSuite 1.0.2 requires installation of the following support software packages. I have separated the first three from the rest of the crowd. OpenSSL and curl come already installed on OS X Server. GD comes as a standard library within PHP 4.3.2. The remaining libraries must be installed individually on OS X Server 10.2.

Open_SSL 0.9.6g http://www.openssl.org
Curl 7.10 http://curl.haxx.se
GD 1.8.4 http://www.boutell.com/gd

Pdflib 4.0.3 http://www.pdflib.com
Mcrypt 2.6.3 http://mcrypt.hellug.gr
Mhash 0.8.17 http://mhash.sourceforge.net
Libmcrypt 2.5.3 http://mcrypt.hellug.gr/#_libmcrypt
Libpng 1.2.5 http://www.libpng.org/pub/png/libpng.html
JPegsrc 6b http://www.optix.org/~dxy/solaris/jpegsrc
Tiff v3.5.7 http://www.libtiff.org
Zlib 1.1.4 http://www.gzip.org/zlib

Notes: most of these libraries will install with little or no problem with just a few exceptions. Libmcrypt must be installed prior to installation of Mcrypt. Pdflib comes in either a light open source version or a full commercial release. To use the open source version, download both PDFliblite and the full PDFllib demo. The full PDFlib contains a binary extension for PHP that must be placed in the PHP extensions directory located at /Library/PHP4/lib. The PHP.ini file, located in the same directory, must be altered by adding the following two lines of instructions:

[PDFLib]
extension = libpdf_php.so

At this point you can compile the source for PDFliblite which will then include support for PHP.

[ElgertS]

Step 2: Verify register_globals is turned on within PHP.

Notes: by default PHP 4.3.2 ships with register_globals turned off for heightened security. While it is far more attractive to leave this feature off, OSSuite and many other PHP applications have not been updated to support the new register_globals off configuration.

Within the PHP.ini file (located within /Library/PHP4/lib) do a search for register_globals and change it to “On”.

[ElgertS]

Step 3: Install OSSuite

Download the source for installation:

http://sourceforge.net/project/showfiles.php?group_id=65144&release_id=167102

If Stuffit has not already done the job for you, decompress the archive:

tar -zvxf ossuitev101.tar.gz

This will create a folder called ossuite with many files and subdirectories. Move the entire ossuite folder to the virtual host directory from which you want to host the application.

[ElgertS]

Step 4: Permissions and Links

Now that the application is installed, we must verify permission settings and symbolic links required for full functionality.

Within the terminal change your location to the virtual host directory and make the following permission changes:

chmod -R 755 ossuite
chmod -R 777 ossuite/images
chmod -R 777 ossuite/logs
chown -R root ossuite

There should be several symbolic links configured already, but you need to verify these are all in place. I found some folders and links missing during my installation and had to create them. For me these were the “images” and the “logs” folders. Since these folders were missing I had to create several of the symbolic links while other links were already in place.

cd /ossuite/oserp
ln -s ../images images
ln -s ../uploads images

cd /ossuite/oscatalog
ln -s ../images images

cd /ossuite/osadmin
ln -s ../images images

[ElgertS]

Step 5: Configure MySQL database

A database must be configured within MySQL for OSSuite to utilize. This can be done through a variety of means, perhaps the easiest of which is through PHPMyAdmin.

To install the database via PHPMyAdmin, simply create a new database named “ossuitedb” from the main screen of PHPMyAdmin. Select the database and then click on the SQL query window. Within the ossuite directory you copied to your virtual host directory earlier, you will find a file named “ossuitedb.sql”. Copy the entirety of this file and paste it within your query window in PHPMyAdmin and apply the action. The database tables will now be loaded and ready for use by OSSuite.

[ElgertS]

Step 6: Modify OSSuite configuration file

Within TextEdit open the “application_config.php” file located in the ossuite directory. Modify the file with your specific values for the following sections:

setup database configuration
// define our database connection
define(‘DB_SERVER’, ‘localhost’);
define(‘DB_SERVER_USERNAME’, ‘userid’);
define(‘DB_SERVER_PASSWORD’, ‘password’);
define(‘DB_DATABASE’, ‘ossuitedb’);

setup http server configuration
define(‘HTTP_SERVER’, ‘http://www.my.com’);
define(‘HTTP_SERVER_CATALOG’, ‘http://www.my.com/oscatalog’);

setup https server configuration
define(‘HTTPS_SERVER’, ‘https://www.my.com’);
define(‘ENABLE_SSL’, 0); // ssl server enable(1)/disable(0)

[ElgertS]

Step 7: PHP 4.3.2 compatibility modification

This final step is only necessary if you are running the latest version of PHP.

In TextEdit open the “english.php” file located within “ossuite/languages/osadmin/

Modify line 12 as follows:
change to :
setlocale(LC_TIME,”fr_FR”);
instead of :
setlocale(“LC_TIME”,”fr_FR”);

[ElgertS]

Step 8: Verify functionality

OSSuite is now installed and can be accessed via the default user account:

user: admin
password: password

The following URLs will get you into the primary areas of the system:

http://www.my.com/oserp/ [for OSSuite ERP]
http://www.my.com/oscatalog/ [for OSSuite Catalog ]
http://www.my.com/osadmin/login.php [for OSSuite Admin]

[Author]

Posts