Tietotekniikka 3/loppuraportti 4

Wikiopistosta

<Tietotekniikka 3/Ryhmä 4

Loppuraporttiohje[muokkaa]

Kirjoittakaa tänne wikiversityyn ryhmänne ohjelmien asennus-, modaus- ja käyttöohjeet.


Ohjelmistojen esittely


AROUNDMe

AROUNDMe on veloituksetta käytettävissä oleva avoimen lähdekoodin sovellus, jonka kehitystyö on koko ajan jatkuvaa. AROUNDMe hyödyttää kayttäjiä, joilla on tarvetta jakaa tietoa muiden käyttäjien kanssa ja toimia digitaaliselle pohjalle rakennetussa sosiaalisessa yhteisössä. AROUNDMen protokollan avulla on mahdollista luoda personoituja sosiaalisia verkkosivuja ja monipuolistaa niitä tarpeiden mukaisesti. Merkittävä tekijä sovelluksessa on sosiaalisten kontaktien hallinta verkon kautta.

Yksinkertaistettuna AROUNDMe pitää sisällään mm. blogin ja kalenteriominaisuuksia ja myös RSS-syötteitä on mahdollista käyttää sovelluksen yhteydessä. AROUNDMe toimii myös kayttäjän omana julkaisuvälineenä. AROUNDMessa on PHP5- ja MySQL-tuki. AROUNDMen verkkopohjaisen käyttöliittymän ulkoasua voi mukauttaa XHTML:llä sekä CSS:llä.

Ilmaisia ohjemia, joita voi liitää AROUNDMehen ovat mm. ProjectPier sekä Zooomr. ProjectPier on avoimen lähdekoodin projektinhallintasovellus ja Zooomr Flickrin kaltainen kuvasovellus, jonka avulla AROUNDMen profiiliin on mahdollista liittää henkilökohtainen kuvagalleria.

AROUNDMe-sovellukseen kirjaudutaan sisään yleisellä OpenID-tunnuksella.


NoseRub

NoseRub on moderni sosiaalisen kommunikaation väline. NoseRubilla käyttäjä voi koostaa itselleen sosiaalisen verkon ja tuoda yhteen materiaalia ja hallita yhteyksiään helposti. NoseRubilla voi esimerkiksi kerätä yhteen RSS-syötteitä eri lähteistä.


Ohjelmistojen asennus'

AROUNDMe:n ja NoseRubin asennukset tuottivat ryhmällemme vaikeuksia, sillä asennusohjeet koettiin puutteellisiksi ja vastaan tuli odottamattomia vaikeuksia. Palvelimelle vaadittujen PHP 5:n lisäosien asennus aiheutti aluksi myös monia kysymyksiä, sillä niiden funktiosta tai asennuksesta ei ollut mitään tietoa aiemmin.

Alla on kuvattuna molempien ohjelmistojen asennusprosessit.


AROUNDMen asennus

AROUNDMe:n asennusvaiheisiin kuuluu esivalmistelujen hoitaminen, jonka jälkeen oman henkilökohtaisen webspacen ja OpenID:n asennus mahdollistuu.

Esivalmistelut

AROUNDMe vaati palvelimelle asennetun Apachen version 1.3/2.x, MySQL 4.1/5.0 tietokannan sekä PHP 5.x -tuen, jotka olivatkin jo valmiiksi asennettuina. Tämän lisäksi PHP5:n tueksi vaadittiin Curl, BCMath sekä GD library.

Curlin avulla voidaan yhdistää ja kommunikoida eri serverien välillä eri protokollia hyväksikäyttäen. Sen avulla voidaan esimerkiksi simuloida käyttäjän toimia verkkoympäristössä.

BC Mathin avulla ohjelmisto pystyy suorittamaan mielivaltaisia binäärisiä laskutoimituksia, jotka voidaa esittää php:ssä string-koodipätkinä.

GD library on avoimeen lähdekoodiin perustuva koodikirjasto, jolla voidaan dynaamisesti luoda grafiikkaa vastaamaan eri tarpeita, esim. tilastointia. GD library tukee mm. png-, jpeg- ja gif-formaatteja.

Saimme Curlin asennettua Unix-ympäristössä komennolla sudo apt get install php5-curl. Tämän jälkeen Apache käynnistettiin uudestaan komennolla sudo apache2 restart, jotta Curlia pystyttiin käyttämään.

Sama prosessi tehtiin seuraavaksi BCMathille sekä GD librarylle, komennoilla sudo apt get install php5-bcmath ja sudo apt get install php5-gdlibrary.


AROUNDMen webspace

Henkilökohtaisen näkymän asennus aloitetaan lataamalla AROUNDMen tiedostot ftp:llä palvelimelle haluttuun kansioon. Tämän jälkeen avataan selaimella osoite haluttu kansio/aroundme_pi_2008_01_16/aroundme_c/

Ohjelman asennus alkaa lupaavasti. AROUNDMe tarkistaa, että esivalmistelut on tehty oikein ja vaadittavat lisäosat ovat asennettuina. Tämän lisäksi asennusohjelma pyytää varmistamaan, että konfigurointitiedosto on kirjoituskelpoinen.

Seuraavassa vaiheessa ohjelma pyytää varmistamaan, että domain-nimi on oikein. Jos näyttää hyvältä, paina YES.

Vaihe 3. MySQL-tietokannan tietojen syöttäminen. Tässä vaaditaan palvelimen nimi, tunnus, salasana ja tietokannan nimi.

Vaihe 4. Osoiteriville laitetaan openID tunnus, jolla tunnistaudutaan palvelimelle.

Vaihe 5. Ohjelma kysyy, kuka pystyy luomaan sivustotilan (webspace). Vaihtoehtoina on kaikki, ylläpidon hyväksymät henkilöt sekä ylläpitäjät.


Webspacen luomisvaiheet:

Vaihe 1. Hyväksytään käyttäjäehdot.

Vaihe 2. Syötetään OpenID-tunnus kenttään.

Vaihe 3. Vahvistetaan OpenID, valitaan webspacen väriteema ja otsikko.

Vaihe 4. Valitaan webspace URL-tunnus, tyyliin http://url.stadia.fi

Vaihe 5. Tämän jälkeen webspacen luomisesta lähetetään tiedot OpenID:n sähköpostiosoitteeseen. Mikäli ID:hen ei kuitenkaan ole liitetty osoitetta, webspacea ei saa näkyviin. Kun s-postiosoite on tallennettu OpenID:hen, voidaan palata vaiheeseen 4.

(Mahdollinen, mutta todennäköinen vaihe 6. Todetaan, että OpenID:n sähköpostia ei tule ollenkaan, ja jätetään asennus. )


AROUNDMe:n OpenID

AROUNDMe:n Personal Identityn avulla voi luoda oman henkilökohtaisen profiilin ja oman OpenID-tunnuksen, jotka eivät kuitenkaan oikein toimineet koeasennuksessa. AROUNDMellä luodut OpenID:t eivät jostain syystä toimineet, virheilmoituksia ei ilmennyt. Mikäli haluaa vain luoda OpenID:n, niin se onnistuu helpommin muissa olemassaolevissa osoitteissa, esim. http://olen.fi:ssä.

AROUNDMe:n Modaus

AroundMe:ssä pystytään muokkaamaan css halutunlaiseksi tiedostossa core/template/css/aroundme.css


Noserubin asennus


Esivalmistelut

Noserub vaatii MySYQL ja PHP5-tuen, sekä BC Math- ja GD library –lisäosat asennettuina, kuten AROUNDMe:kin. Tämän lisäksi mod_rewrite pitää olla asennettuna.

Asennus

Vaihe 1. Puretaan Noserubin tiedostot ja ladataan ne FTP:llä palvelimelle.

Vaihe 2. Luodaan Noserubille oma MySQL-tietokanta.

Vaihe 3. Etsitään tiedostot database.php.default sekä noserub.php.default tiedostorakenteen noserub/app/config/ alta.

Vaihe 4. Avataan database.php ja kirjataan sinne MySQL-tietokannan nimi, käyttäjätunnus ja salasana.

Vaihe 5. Luodaan oma, henkilökohtainen hash, eli tunnisterivi. Tämä tapahtuu php-ympäristössä koodipätkällä:

<Xphp

$hash = md5("salasana");

echo "

".$hash."

";

?> Ajetaan skripti selaimella ja kopioidaan saatu hash-arvo talteen.

Vaihe 6. Avataan noserub.php ja kirjataan kohtaan NOSERUB_ADMIN_HASH edellisessä vaiheessa luotu hash.

Vaihe 7. Avataan selaimella osoite http://<server_name>/noserub/jobs/<NOSERUB_ADMIN_HASH>/system/update

Noserubin Modaus

Noserubissa pystytään muokkaamaan css halutunlaiseksi tiedostossa /noserub/css/noserub.css

Asennuksen jälkipuinti

Noserubin asennuksessa hankalinta oli hashin luominen, joka tuottaa kokemattomille varmasti vaikeuksia. Mikäli tämä olisi integroitu automaattisesti asennusprosessiin, auttaisi se käyttöönottoa huomattavasti.

Noserubin asennukseen liittyy edelleen jotan muutakin mystistä, sillä asennuksenkin jälkeen huomataan, että OpenID-kirjautuminen ei toimi.