Miten ajan omia WWW-skriptejä Saunalahden koneilla?

WWW-palvelimissa on mahdollista ajaa ohjelmia, joiden tekemä tulostus näkyy käyttäjälle WWW-sivuna.

!!! Varoitus !!!

WWW-palvelimen käynnistämät ohjelmat ajetaan ohjelman tekijän UNIX-käyttäjätunnuksella. Jos haet verkosta jonkun ilkeämielisen ihmisen tekemän ohjelman, se voi aiheuttaa tuhoja tunnuksellasi (esim. tuhota tiedostojasi tai sähköpostejasi UNIX-koneelta).Saunalahti ei pysty ottamaan vastuuta tunnuksellasi ajettavista ohjelmista. Varmistu siis, että tiedät mitä olet tekemässä, ennen kuin teet omia skripti-ohjelmia tai laittat verkosta saamiasi ohjelmia ajoon omille sivuillesi.

Saunalahti tarjoaa vain mahdollisuuden omien skripti-ohjelmien ajoon. Ohjelmoinnin opettaminen tai toimimattomien skriptien vikojen selvittäminen eivät kuulu tähän Saunalahden tarjoamaan palveluun. Jos skriptin mukana ei tule kunnollisia ohjeita, voi olla syytä epäillä koko skriptin laatua.

Saunalahti pidättää oikeuden poistaa käytöstä sellaiset WWW-skriptiohjelmat, jotka vaarantavat Saunalahden koneiden turvallisuutta tai jotka kuormittavat kohtuuttomasti laitteistoja.

Näissä ohjeissa /home/t/u/tunnus/ tarkoittaa omaa kotihakemistoasi, hakemistopolku muodostuu käyttäjätunnuksen kahden ensimmäisen kirjaimen mukaan, esim. /home/e/r/erkki.

Miten saan oman skriptini pyörimään?

unix.saunalahti.fi:ssä sinulla on kotihakemistossasi cgi-bin -niminen hakemisto.

Siirrä tai tee tähän hakemistoon ohjelmasi. Toisin kuin public_html-hakemiston kanssa, skriptien ajo- ja lukuoikeuksien pitää olla vain sinun omalla käyttäjätunnuksellasi:

user			group			other
r	w	x	-	-	-	-	-	-

Varmista, että ohjelmatiedostosi oikeudet ovat samat kuin yllä:

• chmod u+rx /home/t/u/tunnus/cgi-bin/tosihyva
• chmod go-x /home/t/u/tunnus/cgi-bin/tosihyva

Skriptin ajaminen

Jos tekemäsi ohjelman nimi on esim. "tosihyva" ja käyttäjätunnuksesi on "tunnus", niin viite WWW-osoitteeseen

http://www.saunalahti.fi/tunnus/cgi-bin/tosihyva

saa aikaan ohjelman "tosihyva" käynnistymisen käyttäjätunnuksella "tunnus".

Hyvin lyhyt esimerkkiohjelma

Asmolla on hakemistossa ~azmo/cgi-bin ohjelmatiedosto koe.sh, jonka sisältö on:

-------------- tiedoston alku ------------------
#!/bin/sh

echo "Content-Type: text/html";
echo ""

id
echo "++++++++++++++++++++++++++++++++++++++++++"
env
-------------- tiedoston loppu -----------------

Tämä ohjelma tulostaa tiedon käyttäjätunnuksesta (id), rivin plus-merkkejä (echo) ja tiedot ympäristömuuttujista (env).

Jos skriptisi antaa virheilmoituksia

"You dont have permission to access..."
Hakemistojen tai skriptien suojaukset ovat väärin. Anna unix-shellissä seuraavat komennot:

• chmod 750 /home/t/u/tunnus
• chmod 755 /home/t/u/tunnus/public_html
• chmod 711 /home/t/u/tunnus/cgi-bin

"Internal Server Error... ja
... Premature end of script headers"
Skriptisi ohjelmakoodissa on jokin virhe tai tiedoston oikeudet ovat väärin.

Jos olet tarkistanut tiedoston oikeudet eikä skripti silti toimi, saattaa ohjelmakoodissasi olla ohjelmointivirhe. Hyvä keino niiden selvittämiseen on yrittää ajaa skripti unix-shellissä:

• cd /home/t/u/tunnus/cgi-bin
• ./skripti

Katso tarkkaan ohjelman tulostus ja korjaa mahdolliset virheet, yleisimpiä virheitä ovat esim. perl-ohjelmassa rivin lopusta unohtunut puolipiste tai useat sisäkkäiset lainausmerkit.
"aivan kuten tässä "hassussa" esimerkissä".
Oikea versio on laittaa
"sisäkkäiset \"lainausmerkit\" kenoviivojen taakse".

Usein käytettyjen ohjelmien sijainnit palvelimella

Ohjelma	Sijainti Saunalahden palvelimella
Perl	/opt/perl/bin/perl
Sendmail	/usr/lib/sendmail
sh	/bin/sh
date	/bin/date

Linkkejä

• Jippiin käyttämä www-palvelin on Apache, josta löytyy tietoa Apache Projektin sivuilta tai ApacheWeek -verkkolehdestä.
• Perl on suosittu kieli skriptien tekoon .