ISTRUZIONI INSTALLAZIONE PMANGO Software necessario: PMango richiede un Web server funzionante con PHP e MySQL e un Web browser. Web server: Apache almeno alla versione 2.0.52 (www.apache.org) PHP: consigliata la versione 5.2 o superiore (www.php.net). PHP ha bisogno della libreria GD per consentire la visualizzazione dei diagrammi di Gantt, che dalla versione 4.2 è abilitata di default). JpGraph (jpgraph.net). La versione 3.0.7 è redistribuita con PMango ed è utilizzata da funzioni grafiche php che la estendono. ADOdb (adodb.sourceforge.net). La versione 4.65 è redistribuita con PMango. PHP ha bisogno che anche la funzionalità XML sia abilitata. In caso contrario XML mostrerà come mancanti le funzioni utf8_encode e utf8_decode. Utilizzando la funzione phpinfo() sul proprio sistema si può vedere se queste librerie sono installate. (come si abilita GD? come si trova e si installa?). (come si abilita etc. XML?). MySQL: almeno la versione 4.1.7 o superiore (www.mysql.com) È utile anche di un client di amministrazione di MySQL. Consigliato il MySQL GUI Tools (www.???, comprendente MySQL Administrator, MySQL Query Browser, MySQL System Tray Monitor e MySQL Migration Toolkit) oppure phpmyadmin (www.???). Si raccomanda di installare un pacchetto comprendente PHP / Apache / MySQL. Questo elimina la necessità di installare ogni componente separatamente, ed è consigliato per i principianti. XAMPP è un ottimo pacchetto. Si consiglia la versione 1.7.1 o superiore.
Installazione: Passo 1: installare le corrette versioni di Apache, MySQL e PHP. Su MySQL definire un utente (es. pmango) con password e diritti di creazione di database, oppure creare un nuovo database (es. pmangodb) vuoto e dare all'utente i diritti sul database creato. Passo 2: scompattare l archivio di distribuzione di PMango nella cartella corrispondente alla radice html del server Web, per esempio /var/www oppure, se si usa XAMPP, \xampp\htdocs. Viene creata una cartella con il nome della versione (es. PMango-2.6-beta.1), se si intende usare un indirizzo diverso rinominarla (es. PMango). Passo 3: immettere nel proprio browser l URL, per esempio se l indirizzo è stato rinominato in PMango http://localhost/pmango/index.php per accedere alla procedura di installazione di PMango. Apparirà una pagina come in Figura 1.1
Figura 1.1: PMango Installation: Check for Requirements Passo 4: Cliccare su 'Start Installation'. Passo 5: a questo punto sarà visibile la pagina delle impostazioni del database come in Figura 1.2. Il tipo di server database deve essere MySQL perché solo questo è supportato. Bisogna immettere il nome del proprio host database, questo è spesso lo stesso host del Web server, in questo caso può essere inserito il nome localhost. Inserire il nome del database che verrà creato o di quello vuoto già creato al passo x.x. Inserire il nome e la password dell utente che ha i diritti di creazione o i diritti di accesso al database vuoto già creato. Ora si può selezionare il pulsante db & write cfg, se tutto è andato bene apparirà la schermata che segnala la corretta installazione di PMango. Il problema più comune in questa fase è l inserimento di dati non corretti nei campi password e utente del database. In questo caso si deve tornare alla pagina precedente e inserire i dati correttamente.
È anche possibile scegliere il nome di un database già esistente di cui si hanno i diritti di accesso, per esempio il database di un installazione di una versione precedente di PMango. Si possono mantenere i dati oppure cancellarli e utilizzare solo il nome del db, in questo caso va selezionata la checkbox Drop Existing Database. In questa fase è anche possibile importare dati SQL scaricati da un ammistratore di PMango con con la funzione backup (All groups, Table structure and data). I dati scaricati per i singoli gruppi potranno essere ripristinati tramite un client di amministrazione per MySQL. Figura 1.2: PMango Installation: Database Settings Passo 6: Se si desidera ripetere il processo di installazione, è necessario prima eliminare il file config.php situato in /pmango/include/config.php. Le directory: /Pmango/modules/report/pdf/
/Pmango/modules/report/img/ sono usate per creare file temporanei di immagini e pdf, il server web deve essere abilitato a scriverci (per esempio si puo creare u gruppo pmango, rendere le directoriy interessate scrivibili al gruppo (con il bit s abilitato e assegnare tale gruppo all utente con cui è eseguito il server.