Zoals sommigen weten heb ik een groot zwak voor alles met een appeltje erop. Hierdoor werk ik erg graag op een MacBook, niet alleen het besturingssyteem, maar eigenlijk alles is waanzinnig. Nu alleen een klein probleempje: als APEX enthousiasteling wil je natuurlijk ook lokaal een APEX omgeving kunnen draaien. Lekker ontwikkelen, gebruiken, nieuwe dingen toetsen etcetera. Ondanks dat je het wel zou willen, is er echter geen Oracle XE database voor Mac OS X beschikbaar. Nu maar improviseren… Toch wil je als fatsoenlijke APEX fan geen consessies doen en werken met een 9i database, lauter en alleen omdat die wel voor OS X bestaat. Dus we gaan alsnog voor XE. Dan maar op een andere manier. Virtualisatie is het toverwoord. In onderstaande post zal ik verder uitweiden over de mogelijkheden en op welke manier dit is gedaan. VirtualBox is echt te gek! Het is gratis en bijzonder ligt, hierdoor is het mogelijk om een fatsoenlijke omgeving op de achtergrond te draaien, terwijl je gewoon ontwikkeld en runt in je Hostomgeving.
Installeer als eerste VirtualBox op je Mac. Het is ook beschikbaar voor Linux en Windows, dus denk zelf dat je geen moeite zal hebben om onderstaande voor die OS’en te volgen. Ik heb het echter zelf op een Mac gedaan, dus zal hier ook verder op ingaan.
Je kunt een .dmg bestand van de website van VirtualBox trekken, De installatie wijst zichzelf, dus hier zal ik verder geen uitspraken over doen. Op het moment dat VirtualBox geinstalleerd is, maak dan een nieuwe machine aan. Ik heb zelf gekozen voor veel van de standaard settings, maar als je er meer aandacht aan geeft kan je vast wel meer eruit halen. Ik heb wel gekozen voor 1024mb aan geheugen, heb toch zat en op die manier kan ik de Oracle XE Database straks ten volle gebruiken. Op het moment dat je de nieuwe machine aanmaakt, kies dan voor een Ubuntu machine.
Ik heb voor de naamgeving en alle wachtwoorden ‘orcl’ gekozen. Deze zal dus in onderstaande handleiding regelmatig terugkomen. Kies uiteraard zelf lekker je wachtwoord en usernames, maar dit ter info.
Op het moment dat je de nieuwe Ubuntu virtuele machine hebt geinstalleerd is het tijd om Ubuntu erop te zetten. Ik heb zelf Ubuntu 8.10 gedownload van de Ubuntu site, dit is de nieuwste versie en werkt prima voor dit doel. Het werkt relatief simpel: koppel het .iso bestand welke je gedownload hebt van de Ubuntu site aan de CDrom speler van je VirtualBox machine. Start de machine op en loop door de installatie heen. Ik heb nagenoeg alles laten staan op de default waardes, behalve de partitionering van de harddisk. Ik heb zelf gekozen voor 1500mb aan swap ruimte, dit is op een later stadium een tikkeltje lastiger in te regelen, dus kan je het beste doen tijdens de installatie. Oracle XE heeft minimaal 1024mb aan Swap nodig, dus doet moest voldoende zijn.
Na het installeren van de Virtuele Ubuntu bak, laat even de update van het systeem lopen. Op die manier weten we zeker dat je het voor elkaar krijgt om een stabiel systeem te hebben. Terwijl de pakketen manager een stuk of honderd applicaties download en update kunnen wij makkelijk even Oracle XE en APEX vanaf OTN downloaden en op het Bureaublad van onze Ubuntubak zetten.
Na het updaten zal de Ubuntumachine zeggen dat je deze moet herstarten. Zet de machine gewoon echt uit, dan kunnen we namelijk meteen de image van Ubuntu verwijderen als CDrom speler van deze machine en zal hij niet telkens vragen om installatie van een nieuw systeem tijdens het opstarten.
Na het herstarten van de virtuele machine, zullen we Oracle XE gaan installeren. Omdat we vanaf het Oracle Technology Network een fijne .deb hebben gedownload is het relatief simpel om deze te installeren. Dubbelklik op het .deb bestand en geef je wachtwoord op. Hierna moeten we even de configuratie van de Oracle XE Database doorlopen.
Open een Terminal (Toepassingen, Hulpmiddelen, Terminalvenster) en tik het volgende in:
sudo /etc/init.d/oracle-xe configure
voor je beheerderswachtwoord (in mijn geval ‘orcl’) in en laat de configurator lopen. Hij zal een aantal vragen aan je stellen over jouw wensen voor de Oracle XE Database. Zo zal je het System (sys as sysdba) wachtwoord moeten invoeren (in mijn geval dus ‘orcl’), de poort voor de database connectie, de httppoort voor APEX en of de Oracle XE Database tijdens opstarten ook moet starten (jaja, tuurlijk, lijkt me handig, een Y dus.).
Tijdens het configureren heb ik voor de volgende poorten gekozen:
1521 voor de Database connectie
9876 voor de httppoort, anders zou ik een probleem krijgen met enkele applicaties op mijn Mac.
Na het configureren van de XE Database zullen we APEX 3.1.2 installeren, want, we willen natuurlijk wel de nieuwste versie gebruiken van Application Express.
We pakken de gezipte APEX folder uit in de gebruikersdirectory. Nu staat deze dus in /home/orcl en kunnen we aan de slag. Ik open een terminal en tik het volgende in:
cd /home/orcl
/usr/lib/oracle/xe/app/oracle/product/10.2.0/server/config/scripts/runsqlplus.sh
Dit opent een nieuwe terminalvenster in SQLplus modus.
Nu dan het volgende om APEX 3.1.2 te installeren op de Oracle XE Database.
conn sys as sysdba
password
Het wachtwoord voor sys invoeren, in mijn geval ‘orcl’.
@apexins.sql SYSAUX SYSAUX TEMP /i/
Nu zal het Application Express installatiescript gaan draaien. Dit kan een tijdje duren, dus ik zal maar even een lekker bakkie thee gaan drinken als ik jullie was. De SQLplus sessie kapt er zelf mee op het moment dat de APEX installatie voltooid is, nu moeten we nog een paar stappen ondernemen om klaar te zijn met de echte APEX installatie.
In het nog openstaande Terminalvenster tikken we het volgende in:
/usr/lib/oracle/xe/app/oracle/product/10.2.0/server/config/scripts/runsqlplus.sh
Nu opent er weer een nieuw SQLplus scherm en we doen het volgende:
conn sys as sysdba
password
(deze lijkt me inmiddels bekend, ‘orcl’).
@apxldimg.sql /home/orcl
Dit script zal de images voor APEX 3.1.2 in de juiste plaats zetten, namelijk de /i/ oftewel de IMAGES directory op jouw Oracle XE Database.
Als dit script klaar is moeten we nog even het ADMIN wachtwoord zetten:
@apxxepwd.sql orcl
Nu staat het wachtwoord voor de Internal ADMIN van APEX op ‘orcl’.
Nu hebben we dan eindelijk onze installatie compleet. Natuurlijk willen wij straks vanuit onze Host omgeving, in mijn geval OS X 10.5.5, de APEX installatie en de Oracle XE Database kunnen bedienen en erop kunnen ontwikkelen. Hiervoor zijn nog een aantal stapjes nodig.
Als eerste moeten we de ftp poort voor de IMAGES directory aanzetten:
exec dbms_xdb.setftpport(’2100′);
alter system register;
Hierna moeten we nog even de APEX instantie (http) ook beschikbaar stellen voor buiten de lokale omgeving:
exec dbms_xdb.setlistenerlocalaccess(l_access => FALSE);
Op het moment dat dit gedaan is kunnen we even de machine uit zetten. We zullen nog een aantal poorten moeten mappen om ervoor te zorgen dat we vanuit de Host omgeving bij de database en de APEX pagina’s kunnen komen.
Tik het volgende in een Teminal (op de Host dus) om de poort naar de database te mappen:
Vanuit je Hostomgegeving, tik het volgende in in een Terminalscherm:
VBoxManage setextradata “orcl” “VBoxInternal/Devices/pcnet/0/LUN#0/Config/oracle/Protocol” TCP
en
VBoxManage setextradata “orcl” “VBoxInternal/Devices/pcnet/0/LUN#0/Config/oracle/GuestPort” 1521
en
VBoxManage setextradata “orcl” “VBoxInternal/Devices/pcnet/0/LUN#0/Config/oracle/HostPort” 1521
Hierna even de http poort mappen, zodat je in je favoriete browser naar APEX kan gaan:
VBoxManage setextradata “orcl” “VBoxInternal/Devices/pcnet/0/LUN#0/Config/apex/Protocol” TCP
and
VBoxManage setextradata “orcl” “VBoxInternal/Devices/pcnet/0/LUN#0/Config/apex/HostPort” 9876
and
VBoxManage setextradata “orcl” “VBoxInternal/Devices/pcnet/0/LUN#0/Config/apex/GuestPort” 9876
Als dit gebeurd is, kan je je Ubuntu Virtuele machine opstarten en in je Hostomgeving SQLdeveloper openen, een nieuwe connectie aanmaken naar xe op localhost, en je Browser richten naar http://127.0.0.1:9876/apex .
Veel plezier met je nieuwe omgeving!
APEX omgeving op VirtualBox op Mac OS X,
