 documentation home | 2. Installation | |
|---|---|---|
 | Chapter 3. Generic installation |  |
documentation home | 2. Installation | |
|---|---|---|
| | Chapter 3. Generic installation | |
Download the latest version on the PMB website [http://www.sigb.net].
You may choose between the two archives formats, zip (for Windows) or tar.gz (for Linux). Both contain the same files. Extract the archive into the directory of your web server where you wish to install PMB (For the tar.gz archive, copy it into the install directory and enter tar xzf PMB.tar.gz.). For the remaining pages of this guide we will use as example an extraction into the sub-directory PMB in the root directory of your Web server on the workstation "myserver".
From the place where you have extracted the archive, call the page tables/install.php (in our example, call the URL http://myserver/pmb/tables/install.php). This page will allow you to create the database on the MySQL server, fill it up with the required minimum to make PMB work, and create the administrator account in PMB. Two areas need to be filled in.
Next choose the language in which you wish to install PMB : this relates directly to the database interface language. The interface language may be changed at any time from the User's preferences.
Caution : IF YOU ARE NOT USING THIS PROCEDURE, THINK ABOUT DELETING THE FILES INSTALL.PHP and INSTALL.REP.PHP. FURTHERMORE : THINK ABOUT CHANGING THE ROOT PASSWORD ON MySQL. IT IS EMPTY BY DEFAULT, THIS CONSTITUTES A POTENTIAL SECURITY RISK.
These are the MySQL server parameters which will be used to create the database. It is imperative that the MySQL user has administrative rights on the server to be able to create the PMB database as well as the MySQL user for this database. The field Server allows to indicate the name of the machine hosting the MySQL server (it can of course be different from the one hosting the Web server).
They are the parameters that the script will use to create the PMB database and the corresponding MySQL user :
PMB User/Password : MySQL user that will be created to access PMB database
PMB database : the name given to the database to be created
Filling up the tables with the set of examples : if you tick this check-box, the database will be loaded with a set of records and authorities files that will enable you to test the application
Once the parameters have been entered, click on the button Create database.
Once the database has been created, check the connection configuration files of PMB with the database. Edit the file db_param.inc.php in the sub-folder includes in the install directory.
Verify the line :
define('LOCATION','nom_de_votre_base');
(nom_de_votre_base [name_of_your_database] is the name entered in the field PMB Database on the install page. If you have left the default parameters as they are : bibli).
Check whether the parameters of the section name_of_your_database correspond to those of the connection :
nom_de_votre_base: // values for local
access
define('SQL_SERVER', 'chemin_du_serveur');
//server name
define('USER_NAME', 'utilisateur_pmb'); //
username
define('USER_PASS', 'mot_de_passe');
//password
define('DATA_BASE', 'nom_de_votre_base');
//name_of_database
break;
Proceed with the same verification with the file opac_db_param.incp.php in opac_css/includes.
Once you have completed all of the foregoing procedures, you may test the connection to PMB. Enter the address of your installation in your browser http://myserver/pmb
On the connection page, login as :
Username : admin
Password : admin
If all went well, you should have on screen the first page of PMB, with 5 tabs on the top section with Circulation already active. In the centre of the page there should be a text box to enter a borrower's barcode or name.
Note : When the database is created, only one user having full administrative privileges is created along with it. This user's name is Super User, his login admin, his password admin.
Caution : THINK ABOUT CHANGING THE PASSWORD OF THE USER ADMIN OF PMB, SET BY DEFAULT AS "ADMIN". THIS DEFAULT VALUE IS KNOWN TO ALL PMB USERS.
In order to keep the database up-to-date, after each new installation or upgrade :
Click on the 'Administration' tab
Go to the side menu on the left on the Administration page, click on Tools, then on Database update from among the links displayed in the top section
Click on the link 'click here to start update'
Click on continue until a message 'Your database is up-to-date in version v. xxx !' appears on screen
| |  | |
| Chapter 3. Generic installation |  | 3. Changing the administrator's password |
