Difference between revisions of "INSTALLAZIONE SK"

Latest revision as of 09:29, 7 November 2014

Versione 1.2

ATTENZIONE Questa documentazione si riferisce alla versione 1.2 dello StarterKit. Per le versioni precedenti si faccia riferimento alle relative documentazioni.

Versione 1.0 INSTALLAZIONE_SK-1.0

Lo starterkit viene distribuito come applicazione virtuale (virtual appliance) in formato vmdk (virtual machine disk).
Una demo video per l'installazione è visualizzabile qui.

I file di installazione necessari è il seguente starterkit.vmdk.gz reperibile al seguente indirizzo.

La procedura di installazione è articolata nelle seguenti fasi:

1 Download ed installazione della macchina virtuale nell'ambiente di virtualizzazione
2 Pubblicazione della macchina virtuale e dei relativi servizi
- 2.1 Importare il file starterkit.vmdk.gz nell'ambiente di virtualizzazione del proprio Istituto
- 2.2 Configurare l'interfaccia di rete
3 Configurazione di base
- 3.1 1. Configurazioni base
- 3.2 2. Registrazione del DNS
4 Metadatazione dei servizi e registrazione del nodo

Download ed installazione della macchina virtuale nell'ambiente di virtualizzazione

Scaricare il file starterkit.vmdk.gz reperibile al seguente indirizzo, consigliamo naturalmente di avere il file scaricato direttamente sulla macchina su cui è installato l'ambiente di virtualizzazione. Genericamente è utilizzabile il comando wget seguito dall'url.

  wget http://geosk.ve.ismar.cnr.it/static/vm-sk-1.2-213243242/starterkit.vmdk.gz

Estrarre il file con il comando gunzip

  gunzip starterkit.vmdk.gz

Pubblicazione della macchina virtuale e dei relativi servizi

Questa fase è relativa alle operazioni preliminari di tipo sistemistico per abilitare il nuovo nodo all'offerta di servizi web. NB Generalmente tali operazioni sono eseguite dall'amministratore di sistema

Importare il file starterkit.vmdk.gz nell'ambiente di virtualizzazione del proprio Istituto

L'ambiente di virtualizzazione è scelto dal sistemista del nodo, è consigliato l'uso di VirtualBox o KVM.
Le caratteristiche del server sono elencate in questa pagina. A questo indirizzo un video demo di installazione di SK in KVM, mentre a questo indirizzo una demo di installazione per la macchina virtuale su Virtual Box. In questo sencondo caso caratteristica obbligatoria è la creazione di una macchiana virtuale con Linux 64bit. Le credenziali dello SK di default verranno comunicate all'utente interessato dall'Help Desk RITMARE.

Configurare l'interfaccia di rete

Parametri quali IP address, subnet, dhcp ecc. si modificano editando il file /etc/network/interfaces. Questo file contiene informazioni di configurazione dell'interfaccia di rete per sistemi Ubuntu e Debian Linux. Aprire ed editare il file di configurazione di rete (interface) editando:

  $ sudo vi /etc/network/interfaces

Cercare e rimuovere l'attivazione del dhcp:

  iface eth0 inet dhcp

Aggiungere le nuove impostazioni di configurazione con i parametri della propria rete, assegnando IP e DNS (es: 150.178.42.24 - geosk.ve.ismar.cnr.it). Di seguito un esempio di compilazione:

  iface eth0 inet static
  address 192.168.1.100
  netmask 255.255.255.0
  network 192.168.1.0
  broadcast 192.168.1.255
  gateway 192.168.1.1
  dns-nameservers 192.168.1.1

il parametro address corrisponderà all'IP che sarà assegnato alla macchina virtuale dedicata a StarterKit, il parametro dns-nameserver dovrà esser corrispondente a un indirizzo internet al quale risponde un servizio DNS (esempio geosk.ve.ismar.cnr.it).

Salvare e chiudere il file, successivamente riavviare per attivare la configurazione impostata:

  $ sudo /etc/init.d/networking stop
  $ sudo /etc/init.d/networking start

nel caso questo comando non dovesse funzionare riavviare la macchina virtuale.

Configurazione di base

La seconda fase è relativa alla configurazione di base del software Starter Kit.

1. Configurazioni base

Aprire in scrittura il file /etc/starterkit/local_settings.py

  $ sudo vi /etc/starterkit/local_settings.py

e settare i parametri:

SITENAME: nome del sito (es. StarterKit ISMAR) che verrà utilizzato all'interno delle pagine.
ADMINS: indirizzi email delle persone abilitate alla ricezione delle notifiche di errore

2. Registrazione del DNS

Come amministratore va eseguito il seguente comando:

  sudo sk-updateip 'il_tuo_nuovo_dns'

A titolo esemplificativo:

  sudo sk-updateip sk.irea.cnr.it

Il comando registrerà il DNS prescelto e configurerà correttamente i servizi di erogazione di SK.

A questo punto il nodo è configurato correttamente ed è possibile raggiungerlo via web:

http://il_tuo_nuovo_dns/

Metadatazione dei servizi e registrazione del nodo

Lo StarterKit viene rilasciato con un utente amministratore già abilitato (le credenziali di accesso ti verranno comunicate al momento della consegna delle starterkit).

Dopo il primo login, l'utente sarà invitato a completare la registrazione attraverso una procedura guidata (web) articolata in due fasi:

Metadatazione dei servizi
Registrazione del nodo

Al primo accesso ricordarsi di modificare le credenziali di accesso.

Per dettagli su questo passaggio vedi qui

@@ Line 1: / Line 1: @@
-Lo starterkit viene distribuito come applicazione virtuale (virtual appliance) in formato "ovf" (Open Virtualization Format).<br />
+'''Versione 1.2 '''
-I file di installazione necessari sono tre:
+'''ATTENZIONE'''
-* vmdk
+Questa documentazione si riferisce alla versione 1.2 dello StarterKit. Per le versioni precedenti si faccia riferimento alle relative documentazioni.
-* ovf
+* Versione 1.0 [[INSTALLAZIONE_SK-1.0]]
-* mf
+Lo starterkit viene distribuito come applicazione virtuale (virtual appliance) in formato ''vmdk'' (virtual machine disk).<br />
+Una demo video per l'installazione è visualizzabile [http://sp7.irea.cnr.it/svn/SP7/Shared/videos/import_VM.mov qui].
-La procedura di installazione è articolata nelle seguenti fasi: I) Messa in linea della Virtual Machine; II) Configurazione di base; III) Metadatazione dei servizi e registrazione.
+I file di installazione necessari è il seguente ''starterkit.vmdk.gz'' reperibile al seguente [http://geosk.ve.ismar.cnr.it/static/vm-sk-1.0-50985378/ indirizzo].
-== I) Messa in linea della Virtual Machine ==
+La procedura di installazione è articolata nelle seguenti fasi:
-# installazione e configurazione dell'interfaccia di rete
+== Download ed installazione della macchina virtuale nell'ambiente di virtualizzazione ==
-# pubblicazione della VM in internet con assegnazione di IP e (possibilmente) DNS (es: 150.178.42.24 - geosk.ve.ismar.cnr.it)
+Scaricare il file ''starterkit.vmdk.gz'' reperibile al seguente [http://geosk.ve.ismar.cnr.it/static/vm-sk-1.0-50985378/ indirizzo], consigliamo naturalmente di avere il file scaricato direttamente sulla macchina su cui è installato l'ambiente di virtualizzazione. Genericamente è utilizzabile il comando wget seguito dall'url.
+<pre style="color: green">
+  wget http://geosk.ve.ismar.cnr.it/static/vm-sk-1.2-213243242/starterkit.vmdk.gz
+</pre>
+Estrarre il file con il comando gunzip
+<pre style="color: green">
+  gunzip starterkit.vmdk.gz
+</pre>
-==II: Configurazione di base==
+== Pubblicazione della macchina virtuale e dei relativi servizi ==
-Come amministratore vanno eseguiti i seguenti passaggi <br />
+Questa fase è relativa alle operazioni preliminari di tipo sistemistico per abilitare il nuovo nodo all'offerta di servizi web. '''NB Generalmente tali operazioni sono eseguite dall'amministratore di sistema'''
--  digitare da shell i comando:
+=== Importare il file starterkit.vmdk.gz nell'ambiente di virtualizzazione del proprio Istituto ===
-<pre style="color: green">sudo sk-updateip 'il_tuo_nuovo_dns'
+L'ambiente di virtualizzazione è scelto dal sistemista del nodo, è consigliato l'uso di [https://www.virtualbox.org VirtualBox] o [http://www.linux-kvm.org/ KVM]. <br />
+Le caratteristiche del server sono elencate in [[Caratteristiche_server|questa pagina]].
+[http://sp7.irea.cnr.it/svn/SP7/Shared/videos/import_VM.mov A questo indirizzo] un video demo di installazione di SK in KVM, mentre [http://sp7.irea.cnr.it/svn/SP7/Shared/videos/import_VM_VirtualBox.mov a questo indirizzo] una demo di installazione per la macchina virtuale su Virtual Box. In questo sencondo caso caratteristica obbligatoria è la creazione di una macchiana virtuale con Linux 64bit.
+Le credenziali dello SK di default verranno comunicate all'utente interessato dall'Help Desk RITMARE.
+=== Configurare l'interfaccia di rete ===
+Parametri quali IP address, subnet, dhcp ecc. si modificano editando il file /etc/network/interfaces. Questo file contiene informazioni di configurazione dell'interfaccia di rete per sistemi Ubuntu e Debian Linux.
+Aprire ed editare il file di configurazione di rete (interface) editando:
+<pre style="color: green">
+  $ sudo vi /etc/network/interfaces
 </pre>
-(es: sudo sk-updateip geosk.ve.ismar.cnr.it). <br />
+Cercare e rimuovere l'attivazione del dhcp:
+<pre style="color: green">
+  iface eth0 inet dhcp
+</pre>
+Aggiungere le nuove impostazioni di configurazione con i parametri della propria rete, assegnando IP e DNS (es: 150.178.42.24 - geosk.ve.ismar.cnr.it). Di seguito un esempio di compilazione:
+<pre style="color: green">
+  iface eth0 inet static
+  address 192.168.1.100
+  netmask 255.255.255.0
+  network 192.168.1.0
+  broadcast 192.168.1.255
+  gateway 192.168.1.1
+  dns-nameservers 192.168.1.1
+</pre>
+il parametro address corrisponderà all'IP che sarà assegnato alla macchina virtuale dedicata a StarterKit,
+il parametro dns-nameserver dovrà esser corrispondente a un indirizzo internet al quale risponde un servizio DNS (esempio geosk.ve.ismar.cnr.it).
+Salvare e chiudere il file, successivamente riavviare per attivare la configurazione impostata:
+<pre style="color: green">
+  $ sudo /etc/init.d/networking stop
+  $ sudo /etc/init.d/networking start
+</pre>
+nel caso questo comando non dovesse funzionare riavviare la macchina virtuale.
+== Configurazione di base==
+La seconda fase è relativa alla configurazione di base del software Starter Kit.
+===1. Configurazioni base===
+Aprire in scrittura il file <code>/etc/starterkit/local_settings.py</code>
+<pre style="color: green">
+  $ sudo vi /etc/starterkit/local_settings.py
+</pre>
+e settare i parametri:
+* SITENAME: nome del sito (es. StarterKit ISMAR) che verrà utilizzato all'interno delle pagine.
+* ADMINS: indirizzi email delle persone abilitate alla ricezione delle notifiche di errore
+===2. Registrazione del DNS===
+Come amministratore va eseguito il seguente comando:
+<pre style="color: green">
+  sudo sk-updateip 'il_tuo_nuovo_dns'
+</pre>
+A titolo esemplificativo:
+<pre style="color: green">
+  sudo sk-updateip sk.irea.cnr.it
+</pre>
+Il comando registrerà il DNS prescelto e configurerà correttamente i servizi di erogazione di SK.
+A questo punto il nodo è configurato correttamente ed è possibile raggiungerlo via web:
+* <code>http://il_tuo_nuovo_dns/</code>
+== Metadatazione dei servizi e registrazione del nodo ==
+Lo StarterKit viene rilasciato con un utente amministratore già abilitato ('''le credenziali di accesso ti verranno comunicate al momento della consegna delle starterkit''').
+Dopo il primo login, l'utente sarà invitato a completare la registrazione attraverso una procedura guidata (web) articolata in due fasi:
+*Metadatazione dei servizi
+*Registrazione del nodo
--  Aprire il file con permesso di scrittura '/home/starterkit/geosk/local_settings.py' e settare i parametri:  SITENAME, THEME_ACCOUNT_CONTACT_EMAIL, ADMINS
+Al primo accesso ricordarsi di modificare le credenziali di accesso.
-* Personalizzazione dei metadatie  e servizi (titoli delle pagine, metadati, punti di contatto ecc.)
-==III: Metadatazione dei servizi e registrazione del nodo ==
+Per dettagli su questo passaggio vedi [[SK_registration|qui]]