<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<article>

  <artheader>
    <title>Sybase-PHP-Apache mini-HOWTO</title>
    <authorgroup>
    <author>
      <firstname>Tyson</firstname>
      <othername>Lloyd</othername>
      <surname>Thwaites</surname>
      <affiliation>
        <address><email>tyson.lloydthwaites@ite.com.au</email></address>
      </affiliation>
    </author>
<author>
<firstname>Vertaald door: Ellen</firstname>
<surname>Bokhorst</surname>
<affiliation>
<address><email>bokkie@nl.linux.org</email></address>
</affiliation>
</author>
</authorgroup>
    <abstract><para>In deze HOWTO wordt uitgelegd hoe een Linux machine
    zo in te stellen dat daarop een Apache webserver draait met PHP
    om een Sybase-ASE database te kunnen benaderen.
    </para>
    </abstract>

    <revhistory>
      <revision>
         <revnumber>1.3</revnumber>
         <date>11-07-2001</date>
         <authorinitials>TLT</authorinitials>
         <revremark>PHP voorbeeldscript gecorrigeerd.</revremark>
      </revision>
       <revision>
         <revnumber>1.2</revnumber>
         <date>13-06-2001</date>
         <authorinitials>TLT</authorinitials>
         <revremark>Shane Gelven wees me op een fout in het init script path.</revremark>
      </revision>
      <revision>
         <revnumber>1.1</revnumber>
         <date>29-05-2001</date>
         <authorinitials>TLT</authorinitials>
         <revremark>Omgeving van de configuratiesectie bijgewerkt
	 wijzigde de naam van de HOWTO.</revremark>
      </revision>
    </revhistory>

  </artheader>

<sect1 id="copyright"><title>Copyright en licentie</title>
<para>Dit document is auteursrechtelijk beschermd 2001 door 
Tyson Lloyd Thwaites, en het is uitgegeven onder de voorwaarden van de
GNU Free Documentation License, welke hierbij als referentie is ingesloten.
Stuur feedback naar
<ulink url="mailto:tyson.lloydthwaites@ite.com.au"><citetitle>tyson.lloydthwaites@ite.com.au</citetitle></ulink>.
</para>
</sect1>


<sect1 id="instlinux"><title>Linux installatie</title>
<para>
In deze howto wordt verondersteld dat je reeds een werkend Linux systeem
tot je beschikking hebt. Deze howto is gebaseerd op een RedHat 6.2 systeem.
Ik zou enige feedback over de installatie hiervan onder andere distro's
erg waarderen.
</para>

<para>
Het eerste dat je moet doen is de rpms <filename>apache</filename> en
<filename>mod_php</filename> de&iuml;nstalleren. Probeer het volgende:
</para>

<programlisting>
    # rpm -e apache
    # rpm -e httpd
    # rpm -e mod_php
    # rpm -e php
</programlisting>

<para>
Hiermee zou je ze kwijt moeten raken. Geef voor de zekerheid de volgende
opdracht:
</para>

<programlisting>
    # rpm -qa | less
</programlisting>

<para>
en controleer of er niets is dat te maken heeft met Apache of PHP
dat is achtergebleven op je systeem.
</para>
</sect1>


<sect1 id="instsybase"><title>Installeer Sybase</title>
<para>
Download de Sybase-ASE bestanden vanaf
<ulink url="http://linux.sybase.com">linux.sybase.com</ulink>. 
Sybase-ASE 11.0.3.3 is gratis voor productie. In deze howto wordt
gerefereerd naar die versie.
</para>

<para>
Installeer als eerste als root de Sybase RPMS:
</para>
<programlisting>
    # rpm -ivh sybase-ase-11_0_3_3-6_i386.rpm
    # rpm -ivh sybase-doc-11_0_3_3-6_i386.rpm
    # rpm -ivh sybase-ocsd-10_0_4-6_i386.rpm
</programlisting>

<para>
Voor informatie over de configuratie van Sybase, lees je de instructies
in het bestand <filename>/opt/sybase/doc/howto/howto-ase-quickstart.html
</filename>. Dit is een zeer goed document, dus is hier geen extra
informatie opgenomen.
</para>

<note><title>Hint</title><para>
Nadat je de voorbeelddatabase hebt ge&iuml;nstalleerd, en er een select
op hebt toegepast, kun je stoppen met het opvolgen van de instructies.
De rest van de howto gaat over het de&iuml;nstalleren van de 
voorbeelddatabase, maar we willen het voor latere testdoeleinden bewaren.
</para></note>

<note>
<title>NOOT</title>
<para>
Een aantal mensen hebben problemen gemeld die ze tegenkwamen bij de wijze
waarop de Sybase initscripts er proberen achter te komen waar de Sybase
directory zich bevindt. Mocht je bij de uitvoering van het script
sybinstall.sh de volgende foutmelding tegenkomen:
</para>

<programlisting>
    export: sybase-ase-11.0.3.3: not a legal variable name
</programlisting>

<para>
dan moet je het script sybinstall.sh wijzigen.
Open het script en zoek naar de volgende regels (zo ommenabij regel 104):
</para>

<programlisting>
# export SYBASE=/opt/sybase
export SYBASE=`rpm -q --queryformat \
		'%{installprefix}\n' sybase-ase-11.0.3.3`
</programlisting>

<para>
Wijzig deze regels als volgt:
</para>

<programlisting>
export SYBASE=/opt/sybase
#export SYBASE=`rpm -q --queryformat \
#		'%{installprefix}\n' sybase-ase-11.0.3.3`
</programlisting>

<para>
Hiermee wordt het SYBASE path hard-coded in /opt/sybase. 
Installeerde je Sybase ergens in een niet standaard path en kreeg je deze
foutmelding, dan moet je dit path zodanig wijzigen dat het verwijst naar
je Sybase directory.
</para>

</note>

</sect1>


<sect1 id="config"><title>Configureer omgeving</title>
<para>
Na de installatie van Sybase, moet je de Linux omgeving instellen om
clients toe te staan een verbinding met de dataserver te maken.
</para>

<para>
Het eerste wat we moeten doen is het instellen van bepaalde omgevingsvariabelen
in <filename>/etc/profile</filename>. Open <filename>/etc/profile</filename>
als superuser en plaats hierin de volgende regels:
</para>
<programlisting>
    export SYBASE=/opt/sybase
    export SYBPLATFORM=linux
    export LD_LIBRARY_PATH=$SYBASE/lib
    export LC_ALL=default
    export PATH="$SYBASE/bin:$PATH"
    export DSQUERY=SYBASE
</programlisting>

<para>
Vervolgens moet je de permissies van de Sybase directory wijzigen. Hiermee
worden een aantal problemen gecorrigeerd waarbij PHP niet in staat is
een verbinding te maken met de Sybase server.
Start als superuser de volgende opdracht:
</para>
<programlisting>
chown -R sybase:sybase /opt/sybase
</programlisting>

<para>
Tik het volgende in om te testen of je Sybase omgeving werkt:
</para>
<programlisting>
    # su - nobody
    $ isql -Usa -P
    1> sp_helpdb
    2> go
</programlisting>

<para>
Als het goed is, krijg je een lijst met databases te zien. 
Om te testen of je de voorbeelddatabase kunt gebruiken, tik je in:
</para>
<programlisting>
    1> use pubs2
    2> go
    1> select * from titles
    2> go
</programlisting>

<para>
Als je een lijst te zien krijgt, dan heb je Sybase met succes ingesteld.
</para>

<note><title>NOOT</title><para>
Wellicht dat je het volgende nog moet doen om ervoor te zorgen dat PHP
Sybase kan benaderen. Bewerk het bestand /opt/sybase/install/rc.sybase 
en verwijder de regel:
</para>
<programlisting>
    unset LANG; unset LC_ALL; \ </programlisting>
<para>
Ik heb geen idee waarom die regel daar staat, maar het kan de boel flink
in de war gooien.
</para></note>

<note><title>NOOT</title><para>
Een aantal mensen hebben problemen gemeld met de wijze waarop de Sybase
initscripts de Sybase directory proberen te raden. Zie je de volgende
foutmelding:
</para>
<para>
<programlisting>
    errorerwerqwerqwerwerwer
</programlisting>
wanneer je sybinstall.sh of rc.sybase probeert uit te voeren, dan moet je
ze wijzigen.
</para></note>

<para>
Wellicht dat je sybase ook toe wilt voegen aan de lijst met services
die tijdens het booten worden uitgevoerd.
Hiervoor voer je de volgende opdrachten uit:
</para>
<programlisting>
    # ln -s /opt/sybase/install/rc.sybase /etc/rc.d/init.d/sybase
    # ln -s /etc/rc.d/init.d/sybase /etc/rc.d/rc3.d/S15sybase
    # ln -s /etc/rc.d/init.d/sybase /etc/rc.d/rc3.d/K15sybase
</programlisting>

<para>
Nu zal Sybase opstarten wanneer je in runlevel 3 boot.
</para>

<note><title>NOOT</title><para>
De noot voor
</para>
</note>

<sect2 id="preapache"><title>Apache voorconfigureren</title>
<para>
Download en pak de laatste Apache distributie uit. In de Apache directory
roep je de volgende opdracht aan:
</para>
<programlisting>
    # ./configure --prefix=/usr/local/apache
</programlisting>

<para>
Ik denk dat de 'prefix' waarde opgeeft waar je je html bestanden wilt opslaan;
Ik stel het gewoon in op hetzelfde als de installatiedirectory van Apace,
waar Apache zijn bestanden plaatst wanneer je de opdracht
'<command>make install</command>' uitvoert.
</para>
</sect2>
</sect1>


<sect1 id="instphp"><title>Installeer PHP</title>
<para>
Download de laatste PHP distributie en pak deze uit.
</para>

<para>
Ga naar de directory <filename>php</filename> en start het script 
<command>configure</command> op.
Je moet bepaalde opties aan het script doorgeven. 
Om toegang tot Sybase in PHP te activeren heb je de optie
<command>--with-sybase-ct</command> nodig. 
Je zult ook de te gebruiken webserverinterface moeten opgeven; in ons
geval is dit Apache, dus gebruiken we <command>--with-apache</command>
Laat --with-apache achterwege als je een CGI-versie van PHP wilt compileren, (wat ook erg handig is als een shellscript tool).
</para>

<para>
Hier is een volledig configure script met de twee bovengenoemde opties, als
ook een aantal andere nuttige opties.
</para>
<programlisting>
    # ./configure --with-apache=../apache_1.3.19
      --with-sybase-ct=/opt/sybase --enable-bcmath --enable-calendar
      --enable-ctype --enable-exif --enable-ftp --enable-gd-imgstrttf
      --with-gd --enable-trans-sid --enable-shmop --enable-sockets
      --enable-sysvsem --enable-sysvshm --enable-wddx
</programlisting>

<para>
Je zult het path naar apache moeten wijzigen in de directory waar je de
apache distributie uitpakte.
</para>

<para>
Als het configure script met succes wordt doorlopen, dan kun je verdergaan met:
</para>
<programlisting>
    # make && make install
</programlisting>

<para>
PHP zou zonder problemen moeten compileren. Nadat het is ge&iuml;nstalleerd,
moet je het bestand <filename>php.ini</filename> installeren:
</para>
<programlisting>
    # cp php.ini-optimized /usr/local/lib/php.ini
</programlisting>

<para>
Nu moeten we nog een aantal zaken wijzigen in 
<filename>/usr/local/lib/php.ini</filename>. Stel de volgende parameters
overeenkomstig de onderstaande gegevens in:
</para>
<programlisting>
    magic_quotes_sybase = on
    sybct.min_server_severity = 11
    sybct.min_client_severity = 11
</programlisting>

<para>
Ik stel graag ook nog het volgende in:
</para>
<programlisting>
    register_globals = on
    include_path=.:/usr/local/lib/php
</programlisting>

<para>
Je hebt de PHP-installatie nu voltooid.
</para>
</sect1>


<sect1 id="instapache"><title>Apache installatie</title>
<para>
Ga nu terug naar de directory waar je apache hebt uitgepakt. Roep de
volgende opdrachten aan:
</para>
<programlisting>
    # ./configure --activate-module=src/modules/php4/libphp4.a
    # make && make install
</programlisting>

<para>
Dit zou zonder problemen moeten worden doorlopen. Wanneer het klaar is,
bewerk je het bestand
<filename>/usr/local/apache/conf/httpd.conf</filename> en haal je het
commentaarteken voor de volgende regel weg:
</para>
<programlisting>
    AddType application/x-httpd-php .php
</programlisting>

<para>
Hiermee vertel je apache dat PHP bestanden met de extensie 
<filename>.php</filename> mag verwerken. Wellicht dat je hier nog andere
extensies aan toe wilt voegen, bv:
</para>
<programlisting>
    AddType application/x-httpd-php .php .php3 .html .htm
</programlisting>

<para>
Je hebt nu alle software die je nodig hebt en bent zover om je systeem te
testen.
</para>
</sect1>

<sect1 id="testsys"><title>Test het systeem</title>
<para>
Zorg eerst dat Apache en Sybase worden opgestart:
</para>
<programlisting>
    # /usr/local/apache/bin/apachectl start
    # /opt/sybase/install/rc.sybase start
</programlisting>

<para>
Ga nu naar de directory <filename>/usr/local/apache/htdocs</filename>. 
Maak een bestand aan met de naam <filename>test.php</filename> en
plaats hierin de volgende inhoud:
</para>
<programlisting>
        &lt;?php
                $con = sybase_connect("SYBASE", "sa", "");
                sybase_select_db("pubs2");
                $qry = sybase_query("select * from titles", $con);

                echo sybase_result($qry, 1, 1);

                sybase_close($con);
        ?&gt;
</programlisting>

<para>
Sla het bestand op en vraag dan de volgende URL op in je browser:
</para>
<programlisting>
    http://localhost/test.php
</programlisting>

<para>
Als je wat tekst te zien krijgt, dan gefeliciteerd! Je hebt een volledige
Linux/Apache/PHP/Sybase-ASE installatie. Zo niet.... Controleer of je
daadwerkelijk de pubs2 database hebt ge&iuml;nstalleerd. 
Als je hier niet zeker van bent, probeer dan:
</para>

<programlisting>
        # isql -Usa -P < /opt/sybase/scripts/installpubs2
</programlisting>

<para>
</para>

<para>
<ulink url="mailto:tyson.lloydthwaites@ite.com.au">Email me</ulink> als er
problemen zijn. Stuur me (alsjeblieft!) je correcties of aanvullingen, maar
e-mail me pas als je alles in deze howto hebt geprobeerd! Bedankt.
</para>
</sect1>

<sect1 id="postinst"><title>Post Installatie taken</title>
<para>
Slaak allereerst een zucht van verlichting als je eenmaal een werkend 
systeem hebt. (ik raad je ook aan iets te eten). Hierna heb je nog een
aantal taken uit te voeren.
</para>

<para>
Het EERSTE dat je zou moeten doen is het wijzigen van het wachtwoord van
de gebruiker 'sa'. Standaard is dit wachtwoord leeg. Typ voor het instellen
van een wachtwoord voor sa het volgende in isql:
</para>

<programlisting>
        1> sp_password null, 'new_pass123', 'sa'
        2> go
</programlisting>

<para>
Hiermee zal het wachtwoord worden ingesteld. Je zult dit nu als een parameter
aan sybase_connect door moeten geven. Je zult het ook op moeten geven als
isql wordt opgestart, wat je kunt doen met de '-P' switch.
</para>

<note><title>NOOT</title><para>
Zodra je een wachtwoord hebt ingesteld, kun je het niet ongedaan maken. 
(Sybase vereist een minimum van zes tekens voor een wachtwoord, dus
'' zal niet worden geaccepteerd.)
</para></note>

<para>
Wellicht dat je ook de Windows client tools wilt installeren. Deze zijn
te vinden op een CD als je ASE van Sybase kocht. Als je echter de vrije
11.0.3.3 versie gebruikt, dan kun je een demo van ASE 12.0 voor NT
downloaden en alleen de 'ASE Plugin voor Sybase Central' , 'ASE ODBC Driver',
en 'Sybase Central' componenten installeren.
</para>

<note><title></title><para>
Ik ben niet zeker van de licentiekwesties die het gebruik van de clients
met zich meebrengt als je ASE niet hebt gekocht. Alhoewel ik niet denk
dat het een probleem zal zijn, zou je direct contact op moeten nemen met Sybase
als je hier zeker van wilt zijn.
</para></note>

<para>
Ik sta open voor meer aanwijzingen voor in deze sectie.
</para>

</sect1>

</article>