Questo breve manuale definisce la procedura per scaricare ed installare una macchina virtuale preconfigurata per l’utilizzo di BEEing.

Download e scompattamento BEEing

Per prima cosa è necessario effettuare il download dei file necessari all’installazione della macchina virtuale.
All’indirizzo http://sourceforge.net/projects/beeing/files/
si deve effettuare il download dei seguenti files:

Una volta completato il download sarà necessario scompattare il contenuto dei file compressi per procedere all’installazione della macchina virtuale.

nota(estrazione file compresso):
Cliccare sul file “ubuntu10_gv3.part1″ ed estrarne il contenuto. In automatico il programma per la scompattazione (nel nostro caso winrar) procederà a ricostruire il file originale dove è salvata la virtual machine (file suddiviso in 3 parti differenti per motivi di dimensioni). Una volta ottenuto un unico file “UBUNTU10_GV3″ si dovrà procedere all’estrazione vera e propria del disco che contiene la Macchiona virtuale “UBUNTU10GV3.vmdk“.

Installazione Virtual Machine con VMWARE

In questo caso è descritta la procedura per l’installazione della versione light di VMWARE, cioè VMWARE PLAYER.
Come prima cosa procederemo con la creazione di una nuova macchina virtuale vergine:

In questo modo il sistema andrà a creare tutti i file necessari per la gestione di una nuova macchina virtuale.
Procedendo con i vari step per la creazione della virtual machine è consigliabile associare al sistema un disco da 20GB e almeno 1GB di RAM.

A questo punto è necessario sostituire il disco vuoto della macchina virtuale appena creata con il disco precedemente scaricato, il disco di BEEing!

Avvio Macchina Virtuale

A questo punto non resta che avviare la Virtual Machine ed utilizzare le seguenti credenziali per avere accesso alla macchina:

Ubuntu user: administrator
Ubuntu pasw: adminadmin

NOTA: Affinche la macchina appena creata sia visibile dall’esterno è necessario impostare correttamente l’indirizzo ip affinchè sia accessibile dal vostro dominio.

Riepilogo credenziali di accesso ai vari servizi installati

MySQL user: beeing
MySQL psw: beeing

Glassfish user: admin
Glassfish psw: adminadmin

BEEing user: administrator
BEEing psw: administrator

Per installare l’applicazione BEEing è necessario:
- Effettuare Download del BEEing.war e fare il deploy in Glassfish (http://mydomain:4848);
- Il Database si popola con i dati di default.

Soluzione problema visibilità Virtual Machine in rete:

]]> http://www.smartfeeling.org/beeing/2010/07/05/macchina-vmware-preconfigurata/feed/ 1 http://www.smartfeeling.org/beeing/2010/01/03/glassfish-v3-come-verificare-la-connessione-ad-un-database/ http://www.smartfeeling.org/beeing/2010/01/03/glassfish-v3-come-verificare-la-connessione-ad-un-database/#comments Sun, 03 Jan 2010 09:20:06 +0000 angelo.geminiani http://www.smartfeeling.org/beeing/?p=172

Glassfish dispone di un metodo molto semplice per testare la connessione ad un database, il ping.

Per verificare se tutti i parametri inseriti nella procedura di configurazione sono corretti, è sufficiente cliccare sul bottone Ping.

E’ molto semplice, selezionate la connessione desiderata tra quelle presenti nel “Connection Pools” e fate click su “Ping”.

Se tutto ha funzionato a dovere otterrete un bel “Ping Succeded“, oppure un errore di qualche tipo.

Se avete appena installato Glassfish e non avete distribuito i driver del database, allora otterrete un errore JDBC che vi informa dell’impossibilità da parte del sistema di reperire il driver richiesto.
Niente di cui preoccuparsi, ecco come ottenere e distribuire i driver su Glassfish.

Distribuire i driver del vostro database su Glassfish.

Questa procedura ha lo scopo di rendere disponibili i driver di database a livello di application server.
Procedete in questo modo:

1. Scaricate il driver desiderato. Poniamo ad esempio che abbiate necessità di testare la connessione con MySQL, allora dovrete scaricare l’ultima versione dei driver da questo sito: http://dev.mysql.com/downloads/connector/j/ (.tar o .zip a seconda del sistema operativo su cui state facendo girare Glassfish)
2. Aprite l’archivio appena scaricato ed estraetene il contenuto in una cartella temporanea o sul Desktop. Dovreste ottenere una cartella con un nome simile a questo: “mysql-connector-java-5.1.10″
3. Aprite la cartella e verificate la presenza di un file .jar dal nome simile a “mysql-connector-java-5.1.10-bin.jar” (il nome può cambiare in funzione della versione del driver).
4. Copiate il file “mysql-connector-java-5.1.10-bin.jar” nella cartella LIB di Glassfish che trovate nel percorso “glassfish/lib/”. Se siete in ambiente Windows e state utilizzando Glassfishv3 il percorso dovrebbe essere grosso modo questo: “c:\glassfishv3\glassfish\lib”.
   Se invece state utilizzando Linux e avete installato Glassfish con i parametri di default, il percorso dovrebbe essere “/home/USER/glassfishv3/glassfish”.
5. Riavviate Glassfish.

A questo punto riprovate il Ping. Se otterrete nuovamente un errore, questa volta dovrebbe trattarsi di un errore diverso da quello precedente e riportante l’indicazione che la connessione non è possibile perchè il database non è raggiungibile o l’utente non è stato riconosciuto.

AUTORE: Gian Angelo Geminiani

Innanzi tutto, per le versioni 3.x, abbiamo accorpato i vari database (bee_sys, bee_membership, bee_wiki, bee_audit, bee_community, ecc..) in uno unico (bee_sys).
Le motivazioni che ci hanno spinto a ridefinire l’architettura dei dati sono innumerevoli, ma la principale è stata l’integrazione con Glassfish 3.x ed il fatto che ora i datasource vengono gestiti direttamente da Glassfish e quindi devono essere configurati al suo interno.

I plug-in, invece, manterranno la classica architettura a database separati e dovranno essere configurati manualmente all’interno di Glassfish (nelle versioni precedenti erano auto-installanti).

Il risultato è che ora l’avvio dell’applicazione (avvio dell’ambiente, controllo integrità database, upgrade database, ecc..) richiede molta meno memoria, un minor utilizzo di CPU e tempi ridotti ad un quinto (circa 18 secondi su una macchina a singolo processore a  con 4 gb di ram).

Installazione e configurazione MySQL.

Non cambia quasi nulla dalla precedente versione di Glassfish.
L’unica cosa è la creazione manuale del database principale: bee_sys.

Creare il database bee_sys.

La creazione manuale del database principale è molto semplice e può essere fatta da riga di comando “CREATE DATABASE …” oppure con un qualunque tool di amministrazione (MYSQL ADMINISTRATOR va benissimo).
E’ importante tener presente che non occorre creare l’intera struttura di metadati (Tabelle, Campi, ecc..) perchè a questo penserà poi la procedura di “sincronizzazione degli schema” di BEEing.

Anche in questo caso mi permetto di consigliarvi uno strumento gratuito nella versione Lite e molto potente per la gestione del database, cioè Navicat.
Purtroppo non è un progetto Open Source, ma vi garantisco che sul mercato difficilmente troverete tools all’altezza di Navicat.
Inoltre la versione Lite fa tutto ciò di cui avrete bisogno per amministrare agevolmente un database.

Installazione e configurazione di Glassfish v 3.x

Glassfish v3 è realmente un application server eccezionale (EJB 3.1, JAVA EE6, Corba 3, ecc..) e potete scaricarlo dal sito ufficiale a questo link: DOWNLOAD GLASSFISH
Sul sito trovate inoltre tutte le indicazioni per installare Glassfish sia in ambiente Windows che Linux o Mac.

Personalmente preferisco lavorare su una macchina virtuale Linux Ubuntu (VMWARE Server è gratis da qualche anno) ed installare BEEing in questo ambiente. In questo modo posso portarmi dietro la macchina virtuale su un disco esterno ed utilizzarla su tutte le macchine di sviluppo senza dover ogni volta riconfigurare l’ambiente o aggiornare il server.
Presto forniremo una macchina virtuale preconfigurata e pronta all’uso (chi ne avesse urgenza può contattarci commentando questo post).

Configurazione di BEEing v3 in Glassfish v3.

La prima cosa da fare è quella di copiare e sovrascrivere il file login.conf (vedi post precedente).
La procedura è molto semplice: Aprite la cartella contenente i files di configurazione e copiatevi all’interno il file login.config, sovrascrivendo la versione esistente.

Ora siamo pronti alla definizione delle risorse database: Connection Pool e JDBC Resources.

I passi da fare sono due.
Per prima cosa dovrete definire una connessione al database all’interno del Connection Pool e attribuirle un nome. Non importa quale nome attribuirete alla connessione perchè lo ritroverete successivamente elencato all’interno di un elenco a discesa (Attribuzione del Nome JNDI).
Successivamente dovrete creare un abbinamento tra nome JNDI (che deve essere tassativamente bee_sys) e risorsa all’interno del Connection Pool selezionando la connessione appena creata dall’elenco a discesa.

1. Creazione della connessione nel Connection Pools:

Selezionate “Connection Pools” dall’albero alla vostra sinistra. Glassfish vi elecherà tutte le connessioni esistenti (in genere quelle di esempio, se non avete creato manualmente altre connessioni).
Per aggiungere una nuova connessione cliccate sul bottone “New..”. Si aprirà la maschera col wizard di configurazione della connessione.

STEP 1

• Name: Un nome a vostra scelta. Non importa quale nome sceglierete in questa fase, perchè successivamente lo ritroverete elencato in una combo box.
• Resource Type: Avrete diverse opzioni. Selezionate “javax.sql.DataSource”.
• Database Vendor: “MySQL”.

STEP 2

La seconda maschera è piuttosto ampia e riporta una serie di campi già precompilati.
Lasciate i valori di default, andranno benissimo.
La sezione a cui dedicare attenzione è quella delle “Additional Properties”.

Questa sezione deve essere compilata con i dati relativi al vostro database.
Eliminate le proprietà di troppo ed assicuratevi di inserire quelle necessarie:

• databaseName: Nome del Database (bee_sys)
• portNumber: Porta del Database (3306)
• driverClass: La classe del driver fornito con il database (com.mysql.jdbc.Driver)
• serverName: Il Nome o L’indirizzo IP del server (localhost)
• user: Nome Utente del database (beeing)
• password: La Password (beeing)

2. Creazione della risorsa JDBC

Creazione dell’utente amministratore del database.

Non dimenticate di creare l’utente amministratore del database.
Nei passi precedenti (Additional Properties) abbiamo utilizzato “beeing” come utente amministratore con password “beeing”.
Potete utilizzare qualunque altro utente in fase di configurazione della connessione, l’importante è che poi non vi dimentichiate di crearlo anche all’interno del database.

La creazione di un utente in MySQL è piuttosto semplice, ma diventa addirittura banale se utilizzate uno strumento come Navicat.
Ricordatevi di assegnare all’utente creato i massimi privilegi, in modo che possa amministrare il database per conto vostro (BEEing si occupa dell’update degli schema).

Note su MySQL.

Se utilizzate MySQL su una macchina differente da quella su cui installate Glassfish, non dimenticate di autorizzare le connessioni da remoto da parte dell’utente utilizzato da BEEing.
In caso contrario MySQL non consentirà l’accesso al database e BEEing non sarà in grado di inizializzarsi correttamente.

A questo punto potete “deployare” il file BEEing.war che avrete scaricato dai repository (potete farlo sia da sourceforge che da kenai).

Login.conf

Non dimenticate di modificare il file login.conf.
Questa modifica è necessaria alla gestione della procedura di autenticazione di BEEing.
Potete scaricare il file Login.conf da questo link.

La procedura è descritta anche nel post precedente: “Come installare BEEing“.

Deploy di BEEing.

Scaricate il file BEEing_3_0_0.war.
Per distinguere le diverse versioni, abbiamo rinominato il file BEEing.war in BEEing_3_0_0.war.
Tuttavia il nome dell’applicazione deve essere BEEing e non BEEing_3_0_0 come invece accadrebbe se effettuaste il deploy con il file BEEing_3_0_0.war.

Rinominate BEEing_3_0_0.war in BEEing.war e procedete al deploy.
E’ fondamentale che “Application Name” e “Context Root” siano BEEing.

Se avete dubbi su come effettuare il deploy di un’applicazione su Glassfish, fate riferimento al post precedente “Come installare BEEing“.

Link Utili:

Sito Glassfish: https://glassfish.dev.java.net/

Sito MySQL: http://dev.mysql.com/downloads/mysql/5.1.html

Sito Navicat: http://www.navicat.com/download/download.html

Sito VMWare: http://www.vmware.com/products/server/

BEEing Download v3 da SourceForge

BEEing Download v3 da Kenai

Come verificare la connessione al database.

Buon Anno a tutti

AUTORE: Gian Angelo Geminiani

Glassfish e MySQL

Noi abbiamo scelto Glassfish come Application Server, che potete scaricare dal sito ufficiale (https://glassfish.dev.java.net/public/downloadsindex.html#top).

Glassfish è un eccezionale application server ed ha una community molto vasta (https://glassfish.dev.java.net/public/users.html). Questo garantisce continuità nello sviluppo, supporto e documentazione sempre aggiornata.

Per l’installazione e la configurazione di Glassfish potete far riferimento al sito: https://glassfish.dev.java.net/public/getstarted.html

MySQL (http://dev.mysql.com/downloads/mysql/5.1.html) è un ottimo database adatto anche ad un utilizzo enterprise. Benchè BEEing supporti diversi database, MySQL è quello che preferiamo e che offre la migliore integrazione con la piattaforma.

Prima di partire con BEEing

Una volta completata l’installazione di Glassfish dovreste essere in grado di accedere alla console di amministrazione (vedi immagine seguente).
L’indirizzo dovrebbe essere simile a questo: http://localhost:4848/

Dalla console sarete in grado di identificare la cartella di installazione di Glassfish e quella che contiene i files di configurazione  (nel mio caso /opt/glassfish/domains/domain1/config). La radice del percorso potrebbe cambiare a seconda delle versioni e del Sistema Operativo utilizzato. L’immagine riporta il percorso per una macchina Linux.

Aprite la cartella contenente i files di configurazione e copiatevi all’interno il file login.config, sovrascrivendo la versione esistente,
Ora riavviate Glassfish. Siete quasi pronti per installare BEEing.

Installazione di MySQL

Se avete installato MySQL, ora potete creare l’utente database di sistema.
Aggiungete al database un utente beeing con password beeing (che potrete cambiare in seguito).
In questo modo BEEing è in grado di creare tutti i database e le tabelle necessarie automaticamente.
Inoltre, a fronte di un aggiornamento o dell’installazione di un nuovo plug-in, il sistema è in grado di effettuare i dovuti aggiornamenti ai database.

Installazione ed avvio di BEEing.

Scaricate i file binari da sourceforge (BEEing.war).
Aprite la console di amministrazione di Glassfish (http://localhost:4848/) e attivate la voce “Web Applications” dal menu ad albero presente sulla sinistra.

Cliccate su “Scegli file”, selezionate il file BEEing.war, e poi cliccate su “OK”.
A questo punto BEEing viene installato per la prima volta.
L’avvio di BEEing può richiedere anche alcuni minuti, a seconda della potenza di calcolo della macchina che lo ospita.
Non preoccupatevi anche se dovessero passare due o tre minuti.
Ad ogni avvio BEEing controlla l’integrità delle tabelle, provvede ad aggiornare gli schema se necessario, distribuisce o aggiorna i contenuti di sistema (utenti, ruoli, pagine, templates, ecc..), installa o aggiorna i temi grafici.

Al termine del caricamento dovreste visualizzare una videata simile a questa.

Cliccate su “Launch”, oppure digitate nel browser l’indirizzo http://localhost:8080/BEEing

Potete effettuare il primo login utilizzando l’utente amministratore di sistema administrator con password administrator (la password potete cambiarla quando volete).

Note:

Per ulteriori informazioni su come installare BEEing 3.x su Glassfish 3.x, fate riferimento al post “Come installare la versione 3.x di BEEing” .

BEEing è una piattaforma java per lo sviluppo di soluzioni Enterprise 2.0, intranet ed extranet.
Lo sviluppo delle funzionalità base è molto dinamico e ad ogni release è possibile trovare nuove applicazioni (wiki, blog, microblogging, project management, crm, ecc..).
In futuro è possibile che alcuni moduli siano distribuiti come plug-in, e quindi non vengano integrati nel pacchetto base (es: il modulo di configurazione prodotto).
La distribuzione separata di alcuni plug-in specifici consente al modulo “CORE” di mantenere un peso ridotto e un minor numero di parametri di sistema.
Tutti i moduli ed i plug-in sono distribuiti completi di codice sorgente, compresi quelli di integrazione a sistemi proprietari (es: modulo per SAP/R3).
I moduli di integrazione a sistemi proprietari possono richiedere, per un corretto funzionamento,  la presenza di librerie di terze parti e delle relative licenze d’uso (non distribuite coi moduli BEEing)

Il framework di sviluppo è stato progettato con un’architettura modulare e basata sul concetto di plug-in.
La stratificazione del codice e dei package secondo una logica a “layer funzionali” consente una miglior manutenzione anche nel lungo periodo e favorisce lo sviluppo in team grazie ad una chiara e semplice suddivisione dei compiti.

I Moduli

Attualmente BEEing è composto da:

• CORE: Contiene le classi base del framework e l’integrazione con alcune librerie open source (es: rome, Json, ZK, OpenJpa);
• WEBAPP: E’ il cuore dell’application server e raggruppa in se il modulo wiki, il blog, la gestione utenti, la gestione dei profili, il datastore ed i componenti base per la gestione delle dashboard e dei widgets;
• LIB_ADMIN: E’ un plug-in di sistema e contiene tutte le maschere e le logiche di amministrazione (variazione dei parametri di configurazione, definizione delle costanti di sitema, gestione delle lingue, gestione delle localizzazioni);
• LIB_KNOL: Contiene l’interfaccia grafica del modulo wiki, del modulo gestione conoscenza e del modulo di gestione del datastore (per l’archiviazione dei file allegati);
• LIB_BLOG: Contiene l’interfaccia grafica del modulo blog;
• LIB_RSS: Contiene le logiche di conversione dei contenuti in formato RSS;
• LIB_TRACKBACK: Modulo di gestione dei trackback;
• PLG_CUSTOMER: Plug-in per il CRM (in fase alpha)
• PLG_FLASHGATEWAY: Plug-in di integrazione con librerie Flash Remoting (Adobe Flash) per l’integrazione con Flash;
• PLG_SAP/R3: Plug-in per l’integrazione con SAP/R3 (richiede librerie proprietarie SAP che non vengono distribuite con BEEing)

Come si sviluppa con BEEing

BEEing non è un’applicazione, ma un framework di sviluppo modulare.
Benchè le molte funzionalità base lo rendano del tutto simile ad una applicazione, ed in futuro lo sarà sempre piu’, BEEing nasce per essere integrato o per integrare sistemi esistenti. Grazie a BEEing potrete implementare soluzioni extranet/inranet molto avanzate, estendere l’interfaccia del vostro sistema ERP o integrarlo con sistemi di e-commerce o social networking, potete realizzare CRM o sistemi di configurazione prodotto facilmente integrabili con sistemi esistenti, così come estendere la vostra archiviazione documentale o implementarla partendo da zero (il datastore interno è compatibile JSR-000170).

Su BEEing si sviluppa in Java, Scripting Java, Scripting Velocity, XML, XUL.
Ma principalmente in Java.
L’architettura del sistema consente lo sviluppo di plug-in che possono essere vere e proprie applicazioni complete di database, maschere e menù, semplicemente integrabili alla WEBAPP.
Il deploy dei plug-in è completamente automatico ed il sistema integra i moduli esterni esattamente come accade per quelli nativi.
Non tutti i plug-in devono contenere obbligatoriamente elementi di interfaccia utente o database. E’ possibile integrare oggetti che il sistema caricherà come task schedulati o thread “one shot”, per compiere le piu’ disparate attività (backup, sincronizzazione database, controllo risorse di sistema, monitoraggio e alert, ecc..) .