Maarch PeopleBox/Installation and configuration guide

De Maarch // Wiki.

Sommaire 1 Installation & configuration 1.1 Required Configurations 1.1.1 PHP5 Configuration 1.1.1.1 Error Handling 1.1.1.2 Data Handling 1.1.1.3 Session 1.1.1.4 Short open tag 1.1.1.5 Magic quotes 1.1.2 Apache server configuration 1.1.2.1 Choose the net directory by default 1.1.3 Mysql server configuration 1.1.3.1 Required 1.2 Installation 1.2.1 DocServer creation 1.2.2 Creation and configuration of the database server 1.2.2.1 Database creation 1.2.2.2 Database configuration 1.2.3 PHP files installation 1.2.4 Config.xml file modification 1.2.5 Maarch PeopleBox Launch 2 MaarchPeopleBox Administration 2.1 Groups adminisration 2.1.1 Groups list 2.1.2 Add / Modify diploma speciality 2.2 Contract type administration 2.2.1 Contract types list 2.2.2 Add / Modify copntract type 2.3 Architecture administration 2.3.1 Structures administration 2.3.1.1 Structures list 2.3.1.2 Addr / Modify structure 2.3.2 Sub-folders administration 2.3.2.1 Sub-folders list 2.3.2.2 Add / Modify sub-folder 2.3.3 Document type administration 2.3.3.1 Document type list 2.3.3.2 Add / Modify document type 2.4 Baskets administration 2.4.1 Baskets List 2.4.2 Add/ Modify basket 2.5 Maarch PeopleBox History

Installation & configuration

Required Configurations

PHP5 Configuration

MaarchPeopleBox needs at least PHP5. The PHP configuration file you must modify is php.ini.

Error Handling

error_reporting = E_ALL & ~E_NOTICE
display_errors = on

PHP will whow you all errors but the notices. Once you are in production, change displays_errors to off.

Data Handling

register_globals = Off

For security matters, you should leaveit to Off.

Session

session.save_path = "T:\TEMP\SessionsPHP"
session.auto_start = 0

Write here the PHP session storage directory (file mode by default). auto_start is at false (0), you should leave it that way.

Short open tag

short_open_tag = On

This allows the <? tag. If this parameter is Off, the application will not start.

Magic quotes

magic_quotes_gpc = On
magic_quotes_runtime = Off
magic_quotes_sybase = Off


Apache server configuration

MaarchPeopleBox needs at leat Apache 2.2. The configuration file you need to modify is httpd.conf.

Choose the net directory by default

Doc_root = “c:\directory”

This directory will contains the php files which will be executed by the server.

Mysql server configuration

Required

MaarchPeopleBox is compatible with MySQL 4.x and more. The ODBC connector is mandatory on the server which hosts the auto import module.

Installation

DocServer creation

The Docserver is the directory where are stored the indexed files. It must be accessible in reading and writing by the Apache server. It is best if the owner of this directory is the Apache user. In network, you must share it.

Creation and configuration of the database server

Database creation

You must create a maarch_peoplebox database and load it with the database.sql file. This file contains the tables structure and minimum data (users, groups, document types). This could be done in command lines or with PHPMyadmin.

Database configuration

You need to modify the docserver path in the database. Put your docserver directory in the field PATH_TEMPLATE of 'mydocserver' in the docservers table.

NB : You must end your path with a / or a \ (Depending of your OS).

PHP files installation

Put the maarch_peoplebox directory in your Apache DocRoot. This directory contains the PHP files and the configuration files.

Config.xml file modification

You need to modify the configuration file maarch_peoplebox/xml/config.xml.

databaseserver : Database server name or IP
databasetype : Database type (MYSQL or SQLSERVER)
databasename : Maarch PeopleBox database name
databaseuser : User of this database
databasepassword : Password for this user
nblinetoshow : Number of lines showed in lists (search, admin)
limitcharsearch : Minimal number of characters in search
lang : Dafault language in Maarch PeopleBox
adminmail : Administrator mail
adminname : Administrator name
enabledadvsearch : Enable advanced search
enabledquicksearch : Enable quick search (not used in Maarch PeopleBox)
enabledindexfile : Enable indexation
enabledvideo : Enable Post Indexing (not used in Maarch PeopleBox)
enableddir : Enable browse by folder (not used in Maarch PeopleBox)
shortcut : Enable shortcut in the quick search (not used in Maarch PeopleBox)
xmlpath : Configuration directory
debug : Show the debub variables
applicationname : Application name
css : Default css file
css_ie : Explorer css file
css_ie7 : Explorer 7 css file
img : Images directory
UNIXserver : Indicates if the net server is unix type or not
DefaultPage : Default page

TABLENAME : Database tables names

RESOURCES : Resources table name, if you do modifications here, do not forget to modify the access rights in the group administration.(NB : For now Maarch PeopleBox has only one resources table)

WORKBATCH : Work batch (used in post indexing) (Not used in Maarch PeopleBox)

HISTORY : Event history

Maarch PeopleBox Launch

To test the proper installation of Maarch PeopleBox, type the corresponding URL address in your browser, you must have this page :

MaarchPeopleBox Administration

To access Maarch PeopleBox administration, click on the Administration link in the menu, then "Summary".

Groups adminisration

Groups list

You have two ways to acces this page :

• Click on the "Manage groups" link in the menu




Add / Modify diploma speciality






Contract type administration

Contract types list






Add / Modify copntract type






Architecture administration



Structures administration

Structures list



Addr / Modify structure






Sub-folders administration

Sub-folders list






Add / Modify sub-folder






Document type administration

Document type list






Add / Modify document type






Baskets administration

Baskets List






Add/ Modify basket












Maarch PeopleBox History