View source for Oracle 10g ja APEX 4.0 arenduskeskonna paigaldus

Antud artikkel on juhend paigaldamaks Oracle 10g XE andmebaasi ja kaasa tuleva APEXi (''Application Express'') uuendamine versioonile 4.0.1.
== Sissejuhatus ==
Käesoelva juhend eeldab, et on juba paigaldatud Ubuntu Server 10.04 koos kõigi uuendustega. Antud artiklis on loodud juba ''Oracle VirtualBox'''iga virtuaalne masin ''Windows 7 Proffesional'' operatsioonisüsteemile. Samuti kasutatakse hiljem ühendumiseks ''Windowsi'' keskkonda.

== Installatsiooni ettevalmistused ja nõuded ==
Oracle 10g esitab oma nõudmised ''swap'' ruumi ja mälumahu suhtes. Vastavalt swap > 1024MB ja mälu > 512MB. Ühtlasi peab ka olema 1,5GB vaba kettaruumi.
'''NB! Kõik järgnevad käsud on tehtud ''root'' kasutaja alt.'''
Antud nõuetele vastavust saab kontrollida järgnevate käskudega:

Mälu ja swap (Tulemus MB'des):
<pre>
free -m
</pre>
Vaba kettaruum:
<pre>
df -h
</pre>
Swap ruumi juurde tegemiseks loome ja võtame külge swap faili.
Swap fail luuakse ja lisatakse järgmiselt (Antud näites luuakse 1GB swap fail):
<pre>
dd if=/dev/zero of=/swapfail bs=1024 count=1M
mkswap /swapfile
swapon /swapfile
</pre>
Selleks, et uus swap võetaks külge ka alglaadmisel. Tuleb lisada järgmine rida '''/etc/fstab''' faili.
<pre>
/swapfail               swap                    swap    defaults        0 0
</pre>

== Repositooriumi lisamine ==
Lisada /etc/apt/sources.list järgmine rida:
<pre>
deb http://oss.oracle.com/debian unstable main non-free
</pre>
Järgnevalt tuleks lisada GPG (''GNU Privacy Guard'') võti:
<pre>
wget http://oss.oracle.com/el4/RPM-GPG-KEY-oracle  -O- | sudo apt-key add -
</pre>
Seejärel laeme alla uuendused
<pre>
apt-get update
</pre>
Lisaks paigaldame ssh serveri
<pre>
apt-get install openssh-server
</pre>

== Andmebaasi paigaldus ja konfigureerimine ==
Paigaldame oracle andmebaasi:
<pre>
apt-get install oracle-xe-universal
</pre>
Pärast edukat installeerimist tuleb käivitada konfigureerimine:
<pre>
/etc/init.d/oracle-xe configure
</pre>
Samuti on vaja '''.bashrc''' faili lisada järgevad keskkonna muutujad:
<pre>
ORACLE_HOME=/usr/lib/oracle/xe/app/oracle/product/10.2.0/server
PATH=$PATH:$ORACLE_HOME/bin
export ORACLE_HOME
export ORACLE_SID=XE
export PATH
</pre>
Rakendamaks muudatusi kohe, loeme .bashrc uuesti sisse:
<pre>
source ~/.bashrc
</pre>
== APEXi versiooni uuendus ==
Kuna OTNist (''Oracle Technology Network'') ei ole võimalik käsurealt mingil lihtsal viisil tõmmata asju siis olin sunnitud antud juhendi tegemise käigus tõmbama OTNist apexi 4.0.1 versiooni alla ja panema avalikku veebi ülesse.
[http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html APEX 4.0.1]
Loome opti alla kausta apex ja lähme sinna kausta
<pre>
mkdir /opt/apex
cd /opt/apex
</pre>
Tõmbame ülesse pandud apexi uue versiooni alla.
<pre>
wget http://siiaomaurl.xx/apex_4.0.1_en.zip
</pre>
Pakime apexi lahti
<pre>
uzip apex_4.0.1_en.zip
</pre>
Lähme lahti pakitud kausta ja ühendume sqlplusiga serveriga.
<pre>
cd apex
sqlplus /nolog
connect sys as sysdba
''===sisesta oma oracle konfigureerimisel määratud salasõna===''
</pre>
Seejärel käivitame upgrade skripti. '''NB! See võib aega võtta kuni 25 minutit'''
<pre>
@apexins SYSAUX SYSAUX TEMP /i/
</pre>
Logime uuesti sisse.
<pre>
sqlplus /nolog
connect sys as sysdba
</pre>
Lisame vajalikud ikoonid ja muu pildi materjali.
NB! APEX lisab antud skripti käivitamisel ise PATHile otsa /apex/images/ seega kui me pakkisime apexi lahti /opt/apex alla siis käsk on järgmine.
PS: See skript võib samuti aega võtta kuni 10-15 min.
<pre>
@apxldimg.sql /opt/apex
</pre>
Muudame APEXi admini salasõna
<pre>
@apxxepwd.sql ''Sa1AsÕna.123''
</pre>
..ja lubame välisühendused
<pre>
exec dbms_xdb.setListenerLocalAccess (l_access => FALSE);
</pre>

== Host keskonna seadistamine ==
Selleks, et ühenduda virtuaalkeskonnaga konfigureerime vajaliku portid. Antud näite põhjal on host portideks valitud 2222, 1556 ja 1555 neid aga võib muuta vastavalt vajadusele. Täpsem juhend antud konfiguratsiooni tegemiseks asub siin[http://sk.c-wd.net/wp/2008/08/17/virtualbox-port-forwarding-with-windows-host/]

'''NB! Virtuaalmasin peab olema väljalülitatud antud konfiguratsiooni tegemiseks!'''

Command promptis sisestame aga järgmised read.
<pre>
cd C:\"Program Files"\Oracle\VirtualBox\

VBoxManage.exe setextradata "SIIA_OMA_VIRTUAALMASINA_NIMI" "VBoxInternal/Devices/e1000/0/LUN#0/Config/ssh/HostPort" 2222
VBoxManage.exe setextradata "SIIA_OMA_VIRTUAALMASINA_NIMI" "VBoxInternal/Devices/e1000/0/LUN#0/Config/ssh/GuestPort" 22
VBoxManage.exe setextradata "SIIA_OMA_VIRTUAALMASINA_NIMI" "VBoxInternal/Devices/e1000/0/LUN#0/Config/ssh/Protocol" TCP

VBoxManage.exe setextradata "SIIA_OMA_VIRTUAALMASINA_NIMI" "VBoxInternal/Devices/e1000/0/LUN#0/Config/apex/HostPort" 1556
VBoxManage.exe setextradata "SIIA_OMA_VIRTUAALMASINA_NIMI" "VBoxInternal/Devices/e1000/0/LUN#0/Config/apex/GuestPort" 8080
VBoxManage.exe setextradata "SIIA_OMA_VIRTUAALMASINA_NIMI" "VBoxInternal/Devices/e1000/0/LUN#0/Config/apex/Protocol" TCP

VBoxManage.exe setextradata "SIIA_OMA_VIRTUAALMASINA_NIMI" "VBoxInternal/Devices/e1000/0/LUN#0/Config/oraclelistener/HostPort" 1555
VBoxManage.exe setextradata "SIIA_OMA_VIRTUAALMASINA_NIMI" "VBoxInternal/Devices/e1000/0/LUN#0/Config/oraclelistener/GuestPort" 1521
VBoxManage.exe setextradata "SIIA_OMA_VIRTUAALMASINA_NIMI" "VBoxInternal/Devices/e1000/0/LUN#0/Config/oraclelistener/Protocol" TCP
</pre>
'''NB! Kui kasutate mingit teist võrgukaarti kui vaikimis seadistatud INTEL PRO/ 1000 MT Desktop siis peate vastavalt muutma ka "e1000" ära.'''

Kontrollimaks, et kõik sai õigesti seadistatud ja rakendatud võime kontrollida tulemust järgmiselt.
<pre>
VBoxManage.exe getextradata "SIIA_OMA_VIRTUAALMASINA_NIMI" enumerate
</pre>
Tulemus peaks olema midagi sellist
<pre>
C:\Program Files\Oracle\VirtualBox>VBoxManage.exe getextradata "SIIA_OMA_VIRTUAALMASINA_NIMI" enumerate
Oracle VM VirtualBox Command Line Management Interface Version 3.2.10
(C) 2005-2010 Oracle Corporation
All rights reserved.

Key: GUI/LastGuestSizeHint, Value: 640,480
Key: GUI/LastWindowPostion, Value: 552,82,640,523
Key: GUI/MiniToolBarAlignment, Value: bottom
Key: GUI/SaveMountedAtRuntime, Value: yes
Key: GUI/ShowMiniToolBar, Value: yes
Key: VBoxInternal/Devices/pcnet/0/LUN#0/Config/apex/GuestPort, Value: 8080
Key: VBoxInternal/Devices/pcnet/0/LUN#0/Config/apex/HostPort, Value: 1556
Key: VBoxInternal/Devices/pcnet/0/LUN#0/Config/apex/Protocol, Value: TCP
Key: VBoxInternal/Devices/pcnet/0/LUN#0/Config/oraclelistener/GuestPort, Value:1521
Key: VBoxInternal/Devices/pcnet/0/LUN#0/Config/oraclelistener/HostPort, Value: 1555
Key: VBoxInternal/Devices/pcnet/0/LUN#0/Config/oraclelistener/Protocol, Value: TCP
Key: VBoxInternal/Devices/pcnet/0/LUN#0/Config/ssh/GuestPort, Value: 22
Key: VBoxInternal/Devices/pcnet/0/LUN#0/Config/ssh/HostPort, Value: 2222
</pre>

== Ühendumine ==
Selleks, et ühenduda apex keskonnaga on 2 aadressi esmalt tasuks sees ära käia administaatorina ja luua mingi kasutaja ja seejärel logida sisse kasutajana.

ADMIN
<pre>
http://127.0.0.1:1556/apex/f?p=4550:10
</pre>
'''Märkus!''' Kui sa kasutasid apexi jaoks mingit teist porti siis kasuta siin vastavat porti (mitte 1556)!

Tavakasutaja
<pre>
http://127.0.0.1:1556/apex
</pre>

==Autor== 
Sander Laasik<br /> 
[mailto:slaasik@itcollege.ee slaasik@itcollege.ee]
[[Category:IT infrastruktuuri teenused]]