Mono e’ un software che fa da motore al funzionamento di Opensim
E’ un motore opensource che ultimamente e’ stato aggiornato alla versione 2.0
i vantaggi dell aggiornamento, sono una maggiore stabilita ed efficienza
e sopratutto un minore consumo di risorse, memoria e cpu.

In questa guida vi mostrero come aggiornare alla versione 2.0
su un sistema Linux ubuntu server 8.04
da eseguirsi il tutto come utente root.

come prima cosa creiamo una cartella di appoggio

mkdir /home/opensim/mono2.0

e ci posizioniamo li

cd /home/opensim/mono2.0

quindi scarichiamo i pacchetti necessari:

wget http://ftp.novell.com/pub/mono/sources/mono/mono-2.2.tar.bz2
wget http://ftp.novell.com/pub/mono/sources/libgdiplus/libgdiplus-2.2.tar.bz2

installiamo dai repository di ubuntu ulteriori pacchetti indispensabili:

apt-get update
apt-get install gcc
apt-get install bzip2
apt-get install libmono-winforms2.0-cil

apt-get install libglib2.0-dev
apt-get install libfontconfig1-dev
apt-get install bison
apt-get install libgif-dev
apt-get install libtiff4-dev

apt-get install gawk
apt-get install  libjpeg62
apt-get install libpng12-dev
apt-get install libx11-dev
apt-get install make

eccoci quindi pronti alle operazioni di installazione di mono:
queste operazioni possono richiedere diversi minuti (anche 10-15 a seconda del sistema utilizzato).
compariranno a video diversi messaggi non critici

- Librerie grafiche

tar -xjf libgdiplus-2.2.tar.bz2

cd libgdiplus-2.2
./configure
make
make install

cd ..

- Mono 2.0

tar -xjf mono-2.2.tar.bz2
cd mono-2.2
./configure
make
make install

alla fine della fiera il comando:

mono –version

Mono JIT compiler version 2.2 (tarball)
Copyright (C) 2002-2008 Novell, Inc and Contributors. www.mono-project.com
TLS:           __thread
GC:            Included Boehm (with typed GC)
SIGSEGV:       altstack
Notifications: epoll
Architecture:  x86
Disabled:      none

ci restituira la nuova versione del motore installato e funzionante.
Che possiamo utilizzare normalmente per avviare opensim.

Ho abilitato il motore di ricerca interno, permette di listare le isole e gli oggetti su metaverseink http://www.metaverseink.com/
Automaticamente indicizzera il contenuto della sim che ha spuntato l’item ’show in search nelle proprieta’.

Per abilitare il search sulle singole sim bisogna modificare il file OpenSim.ini, inserendo o configurando le sezioni:

[DataSnapshot]
; The following set of configs pertains to search.
; Set index_sims to true to enable search engines to index your searchable data
; If false, no data will be exposed, DataSnapshot module will be off, and you can ignore the rest of these search-related configs
index_sims = True
; If search is on, change this to your grid name; will be ignored for standalones
gridname = “Cyberlandia”
; Period between data snapshots, in seconds. 20 minutes, for starters, so that you see the initial changes fast.
; Later, you may want to increase this to 3600 (1 hour) or more
default_snapshot_period = 1200
; This will be created in bin, if it doesn’t exist already. It will hold the data snapshots.
snapshot_cache_directory = “DataSnapshot”
; This semicolon-separated string serves to notify specific data services
; about the existence of this sim.
data_services=”http://metaverseink.com/cgi-bin/register.py”

[Search]
SearchURL = http://grid.cyberlandia.net/query.php

e riavviare la regione.

Su metaverseink si viene indicizzati dopo alcune ore. Nelle prossime release di hippo verra integrato metaverseink come motore predefinito di ricerca.

Caricando una Opensim su Cyberlandia mi sono imbattuto sul problema firewall. Seguendo le istruzioni per l’installazione su Linux Ubuntu è andato tutto bene fino all’avvio della server. Mi sono accorto che disattivando il firewall funzionava tutto anche IW, entravo e uscivo dalla mia regione e così anche altri avatar. Attivando il firewall invece riuscivo ad entrare solo io e non riuscivo a spostarmi all’esterno della mia regione. Dopo alcuni tentativi di sistemare il firewall ho deciso di reimpostarlo da zero e alla fine funziona tutto perfettamente.

Consiglio di non utlizzare il programma Firestarter, personalmente ho incontrato molte
difficoltà nel farlo funzionare con la Opensim. Per disinstallarlo se eventualmente lo si
ha installato "Sistema->Amministrazione->Gestore pacchetti Synaptic" nella casella cerca
digitare "firestarter" e premere sul pulsante cerca. Nella casella sotto apparirà il
pacchetto con la casellina verde, cliccarci sopra con il tasto destro del mouse e
selezionare la voce "Marca per la rimozione completa" e applicare le variazioni.
Da questo momento si è senza firewall quindi massima attenzione, magari prima di
navigare o scaricare file aspettate di ripristinarlo.

Per verificare le impostazioni del firewall su Linux Ubuntu usate il comando:

sudo iptables -vv -L

Ecco un pò di comandi da terminale per impostare al meglio il vostro firewall per Linux
Ubuntu:

sudo iptables -P INPUT   DROP
Questo comando chiude tutto il traffico proveniente dall'esterno (dopo apriremo solo
quello necessario)

sudo iptables -P FORWARD   DROP
Questo comando apre tutto il traffico solo in uscita (con linux non ci sono praticamente
rischi)

sudo iptables -A INPUT  -i lo -j ACCEPT
Questo comando permette tutto il traffico all'interno del pc e del server

sudo iptables -A INPUT -m state --state ESTABLISHED,RELATED -j ACCEPT
Questo comando apre il traffico internet ma solo quello richiesto

Dopo queste impostazioni di base che consentono di navigare su internet sicuri sarà
necessario aprire alcune porte specifiche per consentire il traffico in ingresso e in uscita.

sudo iptables -A INPUT -p tcp --dport 22 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 80 -j ACCEPT
Questi due comandi aprono la porta 22 e 80 in tcp per il webserver e ssh

sudo iptables -A INPUT -p tcp --dport 9000 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 9000 -j ACCEPT
Questi due comandi aprono invece la porta 9000 in tcp e udp 

Per la Opensim sarà necessario inoltre aprire in tcp e udp tutte le altre porte
indicate nella e-mail di configurazione sostituendo nei comandi precedenti il numero
della porta
sudo iptables -A INPUT -p tcp --dport nr porta da aprire -j ACCEPT
sudo iptables -A INPUT -p udp --dport nr porta da aprire -j ACCEPT

Alla fine, con il comando sudo iptables -vv -L , dovreste trovarvi con un iptables
(regole per il firewall) seguente:

Chain INPUT (policy DROP 22524 packets, 1266K bytes)
 pkts bytes target     prot opt in     out     source               destination
 142K   35M ACCEPT     all  --  lo     any     anywhere             anywhere
 197K  209M ACCEPT     all  --  any    any     anywhere             anywhere            state RELATED,ESTABLISHED
    0     0 ACCEPT     tcp  --  any    any     anywhere             anywhere            tcp dpt:ssh
    0     0 ACCEPT     tcp  --  any    any     anywhere             anywhere            tcp dpt:www
   14   820 ACCEPT     tcp  --  any    any     anywhere             anywhere            tcp dpt:9000
    0     0 ACCEPT     udp  --  any    any     anywhere             anywhere            udp dpt:9000
    0     0 ACCEPT     tcp  --  any    any     anywhere             anywhere            tcp dpt:9001
    0     0 ACCEPT     udp  --  any    any     anywhere             anywhere            udp dpt:9001
    0     0 ACCEPT     tcp  --  any    any     anywhere             anywhere            tcp dpt:9002
    0     0 ACCEPT     udp  --  any    any     anywhere             anywhere            udp dpt:9002
    0     0 ACCEPT     tcp  --  any    any     anywhere             anywhere            tcp dpt:9003
    0     0 ACCEPT     udp  --  any    any     anywhere             anywhere            udp dpt:9003
    6   360 ACCEPT     tcp  --  any    any     anywhere             anywhere            tcp dpt:8895
    0     0 ACCEPT     udp  --  any    any     anywhere             anywhere            udp dpt:8895 

Chain FORWARD (policy DROP 0 packets, 0 bytes)
 pkts bytes target     prot opt in     out     source               destination         

Chain OUTPUT (policy ACCEPT 285K packets, 49M bytes)
 pkts bytes target     prot opt in     out     source               destination       

Ovviamente verificate che tutte le altre applicazioni funzionino e agite di conseguenza
per aprire eventuali altre porte.

Partiamo dal caso comune, sim in grid mode con asset su database sqlite.

1) scarico il file opensim.zip e lo dezippo in una cartella in locale, magari per distinguerlo rinomino la cartella.

2) copio nella cartella Regions i file xml delle sim, dalla cartella regions della sim su cyberlandia

3) copio i file AssetStorage.db e OpenSim.db dalla cartella bin della sim cyberlandia alla cartella bin in locale.

4) apro con un editor di testi i file xml della region e inserisco questi valori alle voci:

external_host_name=”127.0.0.1″
master_avatar_uuid=”00000000-0000-0000-0000-000000000000″ estate_covanant_uuid=”00000000-0000-0000-0000-000000000000″

5) Apro con un edito di testi il file OpenSim.ini contenuto nello zip, e modifico:

gridmode = True
in
gridmode = False

eseguo OpenSim.exe ed aspetto che la sim si avvi

Posso ora collegarmi con hippo utilizzando come loginuri: http://127.0.0.1:9000 nel pulsante grid

ed usando come nome cognome e password quelli dell owner della sim. Ci si ritrovera con l’avatar base, ma la sim sara completa di tutti gli oggetti sinora costruiti.

La prossima puntata vi spiego come importare o esportare oggetti dalla sim locale a quella in grid mode. O come ottenere lo stesso risultato nel caso l’asset sia impostato su mysql e non sqlite.

Per aggiornare all’ultima release del simulatore procedere nella seguente maniera:

Per gli utilizzatori di so windows e sqlite:

1) scaricare gli ultimi binari da me compilati, integrati e testati da questo link

2) chiudere la sim attiva con il comando shutdown in consolle

3) copiare integralmente la cartella della sim in un posto sicuro, in modo da recuperarla qualora si volesse tornare indietro

4) scompattare il file opensim.zip scaricato al punto 1

5) individuare e copiare (attenzione su windows, trascinare premendo il tasto maiuscolo e scegliere copia quando si rilascia nella nuova cartella) dalla cartella principale della vecchia versione della sim alla cartella principale della nuova, i seguenti file:

- OpenSim.ini
- estate_settings.xml
- OpenSim.db
- userprofiles.db
- inventoryStore.db
- AssetStorage.db

6) copiare i files con estensione .xml contenuti nella cartella regions dalla vecchia alla nuova installazione

7) avviare la nuova sim, collegarsi e verificare che non ci siano problemi

Se si vuole tornare alla precedente versione, chiudera la sim nuova con shutdown e riavviare la vecchia.

Attenzione, qualora si cominci a costruire o a modificare la nuova sim, se si torna indietro naturalmente le nuove modifiche andranno perse, non copiare assolutamente i file nuovamente su una versione precedente pena la corruzione della sim.

Utilizzatori di Linux Ubuntu e mysql

collegarsi al server con l’utente root, collegarsi su screen e dare da consolle il comando shutdown
in modo da chiudere la sim attiva poi exit due volte per chiudere screen.

su – opensim

creiamo una cartella per la sim aggiornata

mkdir sim-datadioggi

cd sim-datadioggi

wget http://www.cyberlandia.net/comunity/downloads/opensim.zip

unizip opensim.zip

crea una cartella col numero relativo alla sim visibile col comando ls

copiare i file OpenSim.ini e estate_settings.xml dalla cartella bin della vecchia sim alla cartella bin della nuova

copiare i file con estensione xml dalla cartella Regions della vecchia alla cartella Regions della nuova

riavviare con screen la sim lanciando mono OpenSim.exe nella nuova cartella bin

attendere che si riavvii detachare screen e scollegarsi

nota: qualora si debba aggioranare il file OpenSim.ini lo stesso non va sostituito
ma va modificato per l’accesso e l’uso di mysql

le seguenti righe devo avere il ; davanti

; — To use sqlite as region storage:
; storage_plugin = “OpenSim.Data.SQLite.dll”
; storage_connection_string=”URI=file:OpenSim.db,version=3″;

mentre le seguenti no!

storage_plugin=”OpenSim.Data.MySQL.dll”
storage_connection_string=”Data Source=localhost;Database=opensim;User ID=opensim;Password=*****;”;

e al posto degli asterischi va inserita la password relativa all utente opensim per il database mysql

in caso di dubbi controllare sul vecchio OpenSim.ini l’esatta configurazione

vi posto una guida passo passo su come impostare un server ubuntu per cyberlandia.

si puo utilizzare su una qualunque macchina connessa in rete o su un server virtuale (vps)

testato su http://www.linode.com facendo prima il deploy di una macchina linux ubuntu 8.0.5 lst
funziona anche su http://www.slicehost.com o su qualunque server ubuntu con acesso root

— preparazione ambiente — da eseguirsi come root, dare conferma quando richiesto Y

apt-get upgrade
apt-get update
apt-get install screen
apt-get install mc
apt-get install subversion
apt-get install nant
apt-get install mono-gmcs
apt-get install libmono-microsoft8.0-cil
apt-get install libmono-system-runtime2.0-cil
apt-get install libgdiplus
apt-get install libmono-i18n2.0-cil
apt-get install libmono-oracle2.0-cil
apt-get install mysql-common
apt-get install mysql-server (chiede di scegliere e digitare la password dell amministratore di mysql due volte)
apt-get install apache2
apt-get install phpmyadmin
apt-get install wget
apt-get install unzip

————– preparazione dell utente opensim —————

mkdir /home/opensim
useradd opensim
passwd opensim
—->  digitare due volte la password di opensim diversa da quella di root e da quella di linode
annotarla da qualche parte

cambiamo permission all directory dell utente opensim

chown opensim:opensim /home/opensim

—————— download e installazione del software ————————

diventiamo opensim

su – opensim notare che il prompt diventa un $

mkdir lamiasim

cd lamiasim

wget http://www.cyberlandia.net/comunity/downloads/opensim.zip

unzip opensim.zip

ls

crea una cartella col numero corrente della sim (attualmente 6046)

—- avvio e configurazione della sim —-

cd 6046/bin/

lanciare la sim col comando:

mono OpenSim.exe

rispondere alle domande seguenti e premere invio:

DEFAULT REGION CONFIG: Region Name [OpenSim Test]:
nome da assegnare alla sim
DEFAULT REGION CONFIG: Grid Location (X Axis) [1000]:
coordinate assegnate per la x
DEFAULT REGION CONFIG: Grid Location (Y Axis) [1000]:
coordinate assegnate per la y
DEFAULT REGION CONFIG: Internal IP Address for incoming UDP client connections [0.0.0.0]:
invio
DEFAULT REGION CONFIG: Internal IP Port for incoming UDP client connections [9000]:
invio
DEFAULT REGION CONFIG: External Host Name [127.0.0.1]:
rispondere con l’indirizzo ip pubblico del server o in alternativa se disponibile col nome del
server registrato sul dns, nel caso si stia usando la connessione adsl si ricava da http://www.ilmiop.it
nel caso il server sia connesso direttamente alla rete con il comando ifconfig
o dalle impostazioni di configurazione ricevute al momento dell attivazione dell hosting

rispondere con nome cognome e password dell avatar owner alle domande succesive

se tutto va bene si conclude con il seguente messaggio

14:36:10 – [STARTUP]: No startup command script specified. Moving on…
14:36:10 – [!]:STARTUP COMPLETE
Currently selected region is root
Region (root) # :

la sim e’ attiva la si puo andare a cercare in mappa

per inserire ulteriori regioni: il comando in consolle e’

create-region nomeregione nomeregione.xml

pone le stesse domande della prima installazione, rispondere con le coordinate
assegnate per le nuove sim, e alla voce

DEFAULT REGION CONFIG: Internal IP Port for incoming UDP client connections [9000]:
indicare una porta successiva 9001 per la seconda sim, 9002 per la terza e cosi via

——– configurazione mysql ——

usando phpmyadmin:

per usare mysql al posto di sqlite (obbligatorio se  si prevede di utilizzare oltre 6000 prims o piu regioni)

http://ipdelserver/phpmyadmin

utente root password quella scelta durante l’installazione di phpmyadmin

alla voce privileges, creare un nuovo utente opensim con un database associato con lo stesso nome e con tutti i privilegi
annotarsi la password

——– da riga di comando ——-

in alternativa i comandi per creare un database dal nome opensim su mysql sono:

mysql -u root -p
chiede la password dell utente root di mysql

myslq> create database opensim;
mysql> grant all on opensim.* to 'opensim'@'localhost' identified by 'SECRET';

al posto di SECRET scrivere la password tra apici che si intende assegnare all utente opensim

che andra poi inserita sul file OpenSim.ini

in consolle digitare:

mc

usare mc e posizionarsi usando i tasti freccia e tab sul file OpenSim.ini contenuto nella dir bin

premere esc 4 per editarlo

individuare le righe
; — To use sqlite as region storage:
storage_plugin = “OpenSim.Data.SQLite.dll”
storage_connection_string=”URI=file:OpenSim.db,version=3″;

e aggiungi un punto e virgola davanti in modo da non usare sqlite

individua le righe:
; storage_plugin=”OpenSim.Data.MySQL.dll”
; storage_connection_string=”Data Source=localhost;Database=opensim;User ID=opensim;Password=*****;”;

leva il punto e virgola e al posto degli asterischi scrivi la password scelta per l’utente opensim del database opensim
precedentemente creato

premi esc due volte e scegli di salvare le modifiche

per chiudere mc premere esc 0 (tasto esco numero zero)

per chiudere la sim usare sempre il comando shutdown in consolle.

— gestire la sim usando screen —-

screen permette di avviare un terminale e staccare la connessione

da root digitare:

screen e premere invio

invio un altra volta e si ha un prompt dentro screen

su – opensim

ls

cd cartelladellasim\versione\bin\

mono OpenSim.exe

la sim si avvia, attendere

premere control+maiuscolo + a

premere d

risponde detached

exit esce da screen

ulteriore

exit chiude il terminale