Installare SugarCRM in Locale ver. 1.0, Aggiornato a SugarCRM 6.5.x First Issue 14.02.2015 Di seguito passo-passo cercheremo di creare una mini-guida per l installazione di SugarCRM in locale Per prima cosa dobbiamo disporre di un ambiente che ricrei le funzionalità di un Server remoto in locale, quindi che emuli Apache, MySql e le altre funzionalità di cui necessitiamo. Per far questo disponiamo di varie soluzioni tra cui EasyPHP oppure XAMPP che prediligeremo per i nostri scopi. In particolar modo scarichiamo XAMPP v1.8.2 da Sourceforge.net disponibile per Windows, Linux o Mac, su quest ultimo potreste trovare ottimo anche l utilizzo di MAMP pensato appositamente per ambiente Apple e disponibile in versione Free o Pro, la prima gratuita sarà sufficiente per le nostre necessità. Prenderemo in considerazione l installer Windows, gli altri non sono molto differenti ma potrebbero esserci alcune varianti ad esempio nella gestione dei permessi delle cartelle nella versione MAC. XAMPP v1.8.2 Windows Download
Ora Scarichiamo la piattaforma SugarCRM in versione Inglese dal repository ufficiale. SugarCRM Community Edition Andando nella cartella ufficiale trovate varie release di SugarCRM, scegliamo la versione 6.5.X cliccando sull omonima cartella all interno della quale troverete ulteriori folder che rappresentano varianti della versione come aggiornamenti ed altro, selezioniamo la cartella di nostro interesse che è SugarCommunityEdition-6.5.X ( facilmente identificabile anche dal numero di download effettuati ), quindi selezioniamo il file più recente della release, ad oggi la 6.5.20 : SugarCE-6.5.20.zip. A questo punto classico doppio click su XAMPP appena scaricato e facciamo partire l installazione, la cartella di default è la [root] C: si può variare il percorso ma XAMPP non può essere installato in una sotto cartella. Terminata l installazione di XAMPP scompattiamo il file di
SugarCRM scaricato (che attualmente e compresso). Se non disponete di un programma di unzip potete scaricare ed installare un ottimo open source quale 7zip che oltre a supportare i file.zip e.rar gestisce innumerevoli altri formati oltre il suo nativo.7z. Ora ci spostiamo sulla cartella htdocs contenuta all interno di XAMPP che (salvo variazioni in fase di installazione) sarà C:\XAMPP\htdocs all interno di questa cartella ne creiamo una nuova che rappresenterà il nome a dominio del nostro sito locale. Ad esempio potremmo chiamarla mysugarcrm avremo a questo punto all interno di htdocs anche mysugarcrm e l intero percorso sarà quindi : C:\XAMPP\htdocs\mysugarcrm attenzione a distinguere bene tra maiuscole e minuscole, per i nostri scopi sarà tutto in carattere minuscolo. Ora copiamo o spostiamo il contenuto della cartella scompattata di SugarCRM all interno di mysugarcrm in modo da avere i file all interno del nostro nome a dominio locale. Possiamo quindi lanciare XAMPP facendo doppio click sull icona arancione che troveremo sul desktop e/o tra i programmi installati (in alternativa il file eseguibile si trova su C:\XAMPP\xampp-control.exe e pigiamo sui primi due pulsanti Apache [START] e MySql [START]. Potremmo anche le due prime voci Services sempre relative ad Apache e MySql, in questo caso XAMPP verrebbe installato some servizio senza la necessità di essere avviato di volta in volta ma occuperebbe risorse e per i nostri scopi didattici non è necessario.
Apriamo il nostro Browser preferito e digitiamo sulla barra degli indirizzi localhost oppure il suo equivalente numerico 127.0.0.1, ci apparirà l interfaccia di XAMPP 1.8.2 sotto la voce Tools, in basso a sinistra, selezionate phpmyadmin. Attraverso phpmyadmin andremo a creare il Database basato su MySQL indispensabile per l utilizzo di un CMS e l utente relativo che avrà le autorizzazioni per gestirlo. Dal menù in alto selezioniamo la voce Privilegi quindi Aggiungi un nuovo utente e ci apparirà la seguente schermata : Scriviamo il nome dell utente che dovrà gestire il database, ad esempio : mysugarcrm Dove chiede Host : scriviamo localhost (indica che useremo il percorso locale per il DB) Indichiamo la password ad esso associata, ad esempio per semplicità : password
Spuntiamo la voce : Crea un database con lo stesso nome e concedi tutti i privilegi quindi su Privilegi globali -> seleziona tutti A questo punto è stato creato sia il DATABASE e l utente che lo gestirà, se avete seguito l esempio avranno entrambi nome mysugarcrm, altrimenti avranno il nome che avete deciso di dargli in fase di creazione. Note : Nome utente e password vanno scritti e ricordati per essere utilizzati in un secondo tempo e per future esigenze, quelli usati per scopi didattici non andranno utilizzati in un eventuale versione su web in quanto poco sicuri. E ovviamente possibile creare nome Database e nome utente differenti e poi associarli ma per i nostri scopi risulta superfluo. Ora possiamo lanciare l installazione del CRM digitando sul
nostro browser il percorso locale e cioè : http://localhost/mysugarcrm A questo punto ci apparirà immediatamente la schermata di installazione in lingua inglese : Cliccando su next passiamo alla fase successiva in cui ci chiedono se siamo pronti ad installare il prodotto e ci forniscono informazioni circa l ambiente necessario e il check del nostro sistema, clicchiamo nuovamente su next dove dovremmo accettare i termini e condizioni di licenza della software. Spuntiamo I Accept quindi nuovamente il pulsante next, il sistema effettuerà una verifica di compatibilità quindi dovremmo decidere se procedere con l installazione tipica o quella custom.
Procediamo confermando l installazione tipica Confermiamo la scelta di MySQL (mysqli extension) ed arriviamo al punto in cui ci vengono chieste le informazioni chiave per completare l installazione e cioè nome del DataBase, Utente e Password ad esso associata.
Se non è stato variato niente rispetto ai passi precedenti ( durante la scelta del nome utente e nome DB in PhpMyAdmin ) ci troveremo a dover inserire i seguenti valori : DataBase Name: mysugarcrm Host Name : localhost Databse Administrator Username : mysugarcrm Database Admin Password : : password Ci viene richiesto anche se vogliamo installare i Demo Data e cioè i Dati di Esempio, selezionate si se desiderate avere alcuni moduli già compilati per u riferimento sul funzionamento altrimenti no se desiderate avere un installazione pulita ( la scelta di avere i dati di esempio è ottima per chi si approccia per la prima volta al prodotto
così da avere un riferimento per la compilazione dei moduli e i link tra essi ). A questo punto dovremo scegliere username e password dell amministratore di SugarCRM ( da non confondersi con il nome del DataBase creato e l utente che lo gestisce, posso coincidere in questa fase per praticità ma mai nella realtà soprattutto per motivi di sicurezza ). Possiamo pure lasciare admin come username e immettere la password che preferiamo sempre rispettando dettami di sicurezza accettabili ( maiuscole, minuscole, numeri e caratteri speciali ). Dopo aver confermato ci viene proposto un ultimo riepilogo con alcune verifiche ed un paio di scritte di errore in rosso riguardo il modulo IMAP ( per la gestione della Mail ) e Upload File Size impostato ad una soglia molto bassa, sono situazioni che correggeremo una volta installato il software all interno dell area di amministrazione o lavorando nel file di sistema PHP.INI, ma in questa fase le possiamo tranquillamente tralasciare.
Ci viene proposta anche una nota che indica un percorso da copiare cd C:\xampp\htdocs\mysugarcrm.com php.exe -f cron.php da impostare in un file batch che verrà inserito nei task di windows più propriamente in fase di avvio, essendo in un ambiente locale possiamo ignorare anche questo passaggio per tornarci in un secondo tempo e dare avvio alla fase finale di installazione cliccando su Install in basso a destra. La durata dell installazione dipende dall elaboratore sottostante, purtroppo non essendo presente una barra di progresso non riusciamo a capire a che punto della fase di installazione ci troviamo ma non preoccupatevi dopo qualche tempo il setup sarà completo e ci verrà prontamente segnalato. Potete ignorare la successiva schermata relativa alla registrazione in quanto siamo in ambiente locale e finalmente ci troviamo di fronte alla nostra schermata di login dove potremmo finalmente collegarci al back-end del nostro sito, lo User Name ( se non modificato ) sarà admin mentre la password quella che avete scelto antecedentemente al momento della creazione dell utente amministratore.
Ora siamo pronti per imparare il nostro CRM ma necessiteremo come prima cosa di localizzare il nostro prodotto in Italiano, per far questo vi rimando ad un articolo scritto antecedentemente : Panoramica su SugarCRM sotto la sezione LOCALIZZAZIONE.