Oracle Application Express Kurulumu

Bu yazımda size sadeleştirilmiş olarak Windows işletim sisteminde, Oracle Application Express'in (APEX 3.1.1) Oracle 10g R2 üzerine nasıl kurulacağını anlatacağım. Doğrudan kuruluma geçmeden önce biraz kurulum hakkında bilgi vereyim. Kurulumu 3 aşamada gerçekleştireceğiz

1. Gerekliliklerin hazırlanması
2. Kurulumun icra edilmesi
3. Kurulum sonrası işlemlerin tamamlanması

APEX kurulumuna başlamadan önce kurulumu sanal bir makine üzerinde test edip iyice pratik yaptıktan sonra canlı ortama geçirmenizi şiddetle tavsiye ederim. Bu iş için Microsoft Virtual PC'yi yada Vmware Server'ı ücretsiz olarak indirip kullanabilirsiniz.

Özellikle Türkçe sistem ve database kullanan arkadaşlarımız dil ayarlarında sıkıntı yaşayabilirler. Aman dikkat. Bu nedenle ilerde canlI ortama kurmayı düşünüyor iseniz mutlaka sanal ortamda sunucunuzun bir kopyası yada bir imajı üzerinde denemeler yapın. Çıkabilecek sorunları tespit edip çözümlerini öğrenin.

Ben kurulum için aynı zamanda ücretsiz olduğu için Oracle 10g R2 ile birlikte gelen Companion CD'deki HTTP Server'ı kullanıyorum ancak siz Oracle Application Server gibi bir tercih yapabilirsiniz. Oracle Companion CD'niz yok ise http://www.oracle.com/ dan indirebilirsiniz.

Sanal bir test ortamı için kabaca adımları şu şekilde sıralayabilirim;

1. MS Virtual PC üzerine Windows 2K3 SP2 kurun (başlangıç için ingilizce tavsiye ederim)
2. Oracle 10g R2 DB kurun ve veritabanınızı oluşturun,
3. Oracle HTTP Server (Apache Standalone) kurun
4. APEX 3.1.1 i Oracle sitesinden indirip Virtual PC de kopyalayıp, sıkıştırılmış dosyayı açın hazır edin.

Ön Gereklilikler;
1. Web Tarayıcı IE 6.0, Firefox 1.0 (veya üzeri)
2. İşletim sistemi (Windows XP, 2000 (sp3+) /Linux; Red Hat AS/ES 2.1, SLES 8, veya üzeri )
3. Oracle Database 9.2.0.3 (veya üzeri)
4. JVM (Java Virtual Machine) --Eğer veritabanınız 10g R1 üzeri ise gerek yok
5. Boş disk alanı: en az 650 MB (APEX kurulumu için 450, APEX tablespace için 125, SYSTEM tablespace için 85, ingilizceden hariç her dil paketi için 34 MB)

6. Shared_pool_size: En az 100 M (eğer bu değere eşit yada büyükse bu işleme gerek yok)

SQL>SHOW_PARAMETER SHARED_POOL_SIZE;
SQL>ALTER SYSTEM SET SHARED_POOL SIZE='100M' SCOPE=spfile;
Veritabanını yeniden başlatın

7. job_queue_size: 20 (eğer bu değere eşit yada büyükse bu işleme gerek yok)

SQL>SELECT VALUE FROM V$PARAMETER WHERE NAME='job_queue_processes';
SQL>ALTER SYSTEM SET JOB_QUEUE_PROCESSES=20;

8. Oracle XML DB: Oracle 10g için ayrıca yüklemeye gerek yok.
9. Oracle Text: Oracle 10g için ayrıca yüklemeye gerek yok.
10. Oracle HTTP Server: Oracle 10g DB R2 Companion CD içerisinde mevcut.

Kurulum Aşamaları
0. Database'i mutlaka yedekleyin, bu aşamadan sonra çıkabilecek arızalar için sorumluluk sizde.
1. Tüm Oracle servislerini durdurun, Enterprise Manager Control ve Listener'ı durdurun. Oracle'ı kapatın ve yeniden başlatın. Listenerı başlatın. Başka uygulamaların DB'ye erişmemesini sağlayın.
2. Apex'i indirmemiş iseniz indirip sıkıştırılmış kurulum dosyalarını çıkartın.
3. Komut satırından sıkıştırılmış Apex kurulum dosyalarını çıkarttığınız klasöre girin.
4. SYS kullanıcısı ile sqlplus'a login olun.
5. Komut satırınına

SQL>@apexins SYSAUX SYSAUX TEMP /i/

orjinal formatı
SQL>@apexins tablespace_apex tablespace_files tablespace_temp images

şeklinde kurulum komutunu yazın ve enter'a basın. Bu aşamada kurulum başlayacaktır.

Yukarıdaki formatta yazarsanız kurulum 1. SYSAUX, APEX'in kurulacağı tablespace'i ifade eder, 2.si tablespace dosyaları ve TEMP APEX'in kullanacağı TEMP tablespace'dir. APEX için ayrı tablo alanları oluşturmanızı tavsiye ederim. Oluşturacağınız tablo alanı en az 125 MB olmalı, mümkünse siz bol bol yer verin. Bunun haricinden /i/ ise resim dosyalarının kopyalanacağı klasöre verilen takma addır (alias). İsterseniz değiştirebilirsiniz ancak özellikle yapacağınız bir işlem değilse olduğu gibi bırakın.
6. APEX'in kurulumu bittiğinde yeniden sqlplus'a SYS kullanıcısı ile giriş yapın ve

SQL>@apxchpwd

yazın, kullanıcı adı, şifre sorularına cevap verin. Bu APEX'in admin şifresini ayarlayacaktır.

Kurulum Sonrası İşlemleri
1. APEX_PUBLIC_USER kullanıcının kilidini kaldırın.

SQL>ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK;
SQL>ALTER USER APEX_PUBLIC_USER IDENTIFIED BY yeni_şifreniz;

2. APEX klasöründeki resim dosyalarını (images) Oracle HTTP Server'ın içine kopyalayın

Bendeki yeri;
C:\oracle\product\10.2.0\db\Apache\Apache\images

yani ortam değişkeninene göre;
ORACLE_HTTPSERVER_HOME\Apache\images

3. dads.conf dosyasını edit edin.

Bendeki yeri;
C:\oracle\product\10.2.0\db\Apache\modplsql\conf\dads.conf

ortam değişkeninene göre yol;
ORACLE_HTTPSERVER_HOME\Apache\modplsql\conf\dads.conf

Aşağıdaki satırları wordpad ile açarak dods.conf dosyasına ekleyin ve kendi ayarlarınıza göre düzenleyin, kaydedip kapatın.
-----------------------------------------------------------------
Alias /i/ "C:\oracle\product\10.2.0\db\Apache\Apache\images/"
AddType text/xml xbl
AddType text/x-component htc

SetHandler pls_handler
Order deny,allow
Allow from all
AllowOverride None
PlsqlDatabaseUsername APEX_PUBLIC_USER
PlsqlDatabasePassword apex_public_user_şifrenizi_buraya_yazın
PlsqlDatabaseConnectString serverınızın_adı:db_portu:servis_adı
PlsqlAuthenticationMode Basic
PlsqlDefaultPage apex
PlsqlDocumentTablename wwv_flow_file_objects$
PlsqlDocumentPath docs
PlsqlDocumentProcedure wwv_flow_file_mgr.process_download
PlsqlNLSLanguage AMERICAN_AMERICA.AL32UTF8 /*değiştirmeyin*/
-----------------------------------------------------------------

4. HTTP Server'ı yeniden başlatın

APEX'e bağlanmak için
Admin kullanıcısı olarak: http://hostname:port/pls/apex/apex_admin
Developer kullanıcı olarak: http://hostname:port/pls/apex

Apache server kurulduğunda varsayılan port 7777 olarak gelmektedir. Bu nedenle APEX isimli bir serverımız olduğunu varsayarsak adres http://apex:7777/pls/apex şeklinde olacaktır. Port numarasını değiştirmek yada HTTP sunucunun diğer ayarları kendinize göre ayarlamak isterseniz

ORACLE_HTTPSERVER_HOME\Apache\Apache\conf\https.conf dosyasını edit edebilirsiniz.