Procedura di installazione rrunnweb Preparazione dell ambiente RRUNNWEB può girare su qualsiasi piattaforma che fornisca i seguenti servizi: - un server web locale (ad esempio: Apache ver.2.2 o successive, IIS ver 6 o successive) - il database MySQL (ver. 5.0.51 o successive) - il linguaggio PHP (ver. 5.2 o successive) Al momento risulta installato su Windows (XP SP3, Win 7, Win 8, Win 8.1, Win 10), Linux (OpenSuse), Mac. Per facilitare l installazione sulle piattaforme Windows, che sono le più diffuse, si consiglia di utilizzare i pacchetti che consentono rapidamente di costruire l ambiente sopra descritto. Nel seguito viene descritto dettagliatamente come installare WAMP, ma anche XAMPP (un altro pacchetto che contiene più o meno le stesse cose) è stato già provato. WAMP è un insieme di programmi che racchiudono, principalmente: - il server web Apache, nella versione 2.4.9 - il database MySQL, nella versione 5.6.17 - il linguaggio PHP, nella versione 5.5.12 WAMP esiste sia per Windows 32 bit che per 64 bit. Tuttavia, NON è utilizzabile sui più vecchi XP. Pur essendo possibile installare RRUNNWEB anche su sistemi di questo genere, la preparazione dell ambiente di base va fatta installando i singoli applicativi individualmente, il che è piuttosto laborioso e non consigliato a chi non abbia sufficienti competenze informatiche. In questo documento non viene descritta l installazione di XAMPP, per la quale suggeriamo di fare riferimento alla documentazione del pacchetto. Prima di installare WAMP, occorre avere sul sistema le librerie Microsoft Visual C a 32 e/o 64 bit. VC32 (nome del programma: vcredist_x86.exe) è la libreria Microsoft Visual C++ 2012 a 32 bit, versione 11.0.61030. E richiesta sia per i sistemi Windows a 32 che a 64 bit. VC64 (nome del programma: vcredist_x64.exe) è la libreria Microsoft Visual C++ 2012 a 64 bit, versione 11.0.61030. Serve SOLO sui sistemi a 64 bit. Queste due librerie sono utilizzate da molti software, per cui potrebbero essere già presenti sul computer di interesse. Tuttavia non ci sono inconvenienti noti ad una loro reinstallazione. Tutti i software sopra elencati sono disponibili sul sito http://attivita.fihp.org nell area riservata ai Segretari di Giuria. Sono tutti software che non richiedono licenza e sono quindi a costo nullo. Dopo aver installato WAMP (o XAMPP) e verificato che i servizi siano funzionanti, si può procedere ad installare RRUNNWEB, come appresso descritto. RRUNNWEB viene eseguito all interno di un browser web, cioè con lo stesso software con il quale si naviga su Internet. Al momento è consigliato l utilizzo di Firefox o Safari, che sono i più stabili tra i vari browser. Alcune sottili differenze nell uso di Chrome sono state risolte e quindi anche questo browser può essere usato. Per quanto riguarda Internet Explorer (o Edge su Win 10), invece, del quale sono note molte differenze rispetto agli altri browser e anche tra una versione e l altra dello stesso applicativo, lo sconsigliamo.
Procedura di installazione di WAMP (su Windows dalla versione 7 in poi) Le schermate riportate nel seguito sono riferite ai sistemi a 32 bit. Quelli a 64 sono strettamente analoghe. 1. installare il software VC32. Questo passaggio riguarda sia i sistemi a 32 che a 64 bit. Un eventuale messaggio di errore (che chiede se si voglia riparare una installazione già esistente) compare quando questo pacchetto è già presente nel sistema. 2. Per chi possiede un sistema a 64 bit, occorre installare il software VC64. Un messaggio di errore del tipo setup failed indica che il sistema è a 32 bit. 5. per chi ha W32, installare WAMP32. Nota che è sufficiente accettare le impostazioni proposte, l unica selezione da fare è quella della seconda schermata, in cui si dice I accept the agreement. Nella quarta schermata è opportuno mettere i segni di spunta su create Desktop icon e create a Quick launch icon
3. per chi ha W64, installare WAMP64. Le modalità sono praticamente identiche a quanto descritto per WAMP32. 4. RIAVVIARE IL SISTEMA. All avvio può essere necessario chiedere l avvio di WAMP (icona viola a forma di W sul desktop). Esiste la possibilità di mettere in esecuzione automatica i servizi di interesse (Apache e MySQL), ma non viene descritta in questa documentazione perché richiede di intervenire sui servizi di Windows e questo va fatto solo quando si sa cosa fare. 5. La schermata qui presentata mostra un Windows 7 a 32 bit con WAMP funzionante. Tra le icone in basso a destra appare una W verde.
6. Aprire un browser qualsiasi e chiamare la pagina http://localhost. Deve risultare la pagina di risposta presentata nell immagine. 7. Sempre in un qualsiasi browser, chiamare la pagina http://localhost/phpmyadmin. Questa pagina garantisce che tutti i servizi necessari (Apache, MySQL, PHP) siano correttamente installati.
Procedura di installazione iniziale di RRUNNWEB 1. Scaricare ed eseguire rrunnweb_setup.exe Può succedere in qualche caso che l eseguibile rrunnweb_setup.exe non sia stato accettato dal computer di destinazione. Questo può accadere per varie ragioni (limitazioni aziendali, intervento di antivirus, ecc.). A questo scopo è reso disponibile anche il file rrunnweb_setup.zip, che contiene esattamente le stesse cose, ma che richiede di fare a mano l estrazione dei file. La cartella di destinazione proposta è quella adatta a WAMP : c:\wamp\www\rrunnweb Se è stato usato XAMPP la cartella da scegliere è c:\xampp\htdocs\rrunnweb Succede, a volte, che Windows segnali che l installazione potrebbe non essere andata a buon fine. Questo messaggio può essere tranquillamente ignorato. Se l installazione viene fatta in modo diverso da quanto qui descritto o su sistemi diversi (ad es. Mac), occorre comunque creare la cartella rrunnweb all interno della cartella radice del proprio server. Tale cartella (rrunnweb) deve avere impostati i privilegi di scrittura per qualsiasi utente, altrimenti non sarà possibile effettuare gli aggiornamenti successivi. Usando rrunnweb_setup.exe questa condizione è automaticamente garantita. 2. Dopo aver creato la cartella rrunnweb e messo al suo interno i file dello zip, occorre aprire il browser e lanciare la pagina http://localhost/rrunnweb/setup_step1.php. Questo passaggio avviene automaticamente se è stato usato rrunnweb_setup.exe Nella pagina a fianco vanno indicati il nome utente e la password per l uso di MySQL. Se è stata fatta una installazione standard di WAMP essi sono: username root password nessuna Quindi è sufficiente premere il bottone di conferma. Per un breve tempo, appare la pagina del caricamento iniziale del database, poi il controllo passa in automatico alla pagina di registrazione del software.
Terminato il caricamento del database, la pagina diventa quella sulla sinistra. RRUNNWEB non può essere utilizzato se non dopo aver effettuato la registrazione. Occorre avere una connessione ad internet attiva, introdurre il proprio numero di tessera e la propria password (quella che serve per il sito). In mancanza di collegamento, il software può essere attivato in locale, usando le stesse credenziali. Potrebbe essere che segretari di nuovo tesseramento non siano riconosciuti nell archivio locale. Fatta la registrazione, il sistema passa al menu principale, rispondente alla pagina http://localhost/rrunnweb. Il sistema è pronto per l utilizzo