Oracle E-Business Suite: Adadmin Nedir? - Ne İşe Yarar?

Adadmin olarak belirttiğimiz araç Ad Administration'dır. Adadmin ile çoğu bakım(maintenance) işlemi gerçekleştirilmektedir. Adadmin tarafından gerçekleştirilebilecek işlemler gruplanmıştır. Bu gruplar aşağıdaki gibidir.

Gruplarda sırasıyla Menu'lerin tekrar yaratılması, veritabanındaki application object'lerinin compile edilmesi, application'ın maintenance mode'a alınması, application ile ilgili bazı işlemlerin gerçekleştirilmesidir. Menu'ler ve içerikleri aşağıdaki gibidir.

Generate Applications Files Menu:

Uygulama kullanımı sırasında bazen formların zamandan zamana yeniden yaratılması gerekebilir.  Bunun için formların,mesajların veya raporların tekrar üretilmesi gerekebilir. Patch'ler uygulandığında ya da geliştirmeler yapıldığında bunlar bozulabilir. Bunların tekrar yaratılması sorunu çözebilir. Bu regenerasyon işlemi sırasında uygulamanın kapatılmasına gerek yoktur ama bu belirttiğimiz tipteki objectlerin kullanılmaması gerekmektedir.

En iyi çözüm ise uygulamanın kapatılıp bu işlemin yapılmasıdır.

Java dosyalarının tekrardan yaratılması ise eğer java kütüphanelerinden herhangi biri eksikse ya da uygulamaya herhangi bir geliştirme uygulandıysa yapılmalıdır.

Mesaj dosyalarının tekrar yaratılması ise EBS ekranlarında gördüğümüz yazıların tekrar yaratılmasını sağlar; ancak bunun kontrollü bir şekilde yapılması gerekmektedir.

Maintain Applications Files Menu:

Compile/Reload Applications Database Entities:

Compile Apps Schema  ile apps schema'sındaki invalid olan object'ler derlenir, compile edilip bozuk olanlar tekrar çalıştırılır.

Compille Menu Information ile menu yapıları tekrar derlenir. Sorun olması durumunda çalıştırılması tavsiye edilir. Aynı şekilde compile flexfields da bozuk olan flexfield'lar yapılır.

Maintain  Applications Database Entities Menu:

Database'in bütünlüğünü kontrol eden bu menu'de "Validate Apps Schema" ile bir rapor yaratılır  ve bu raporda APPS'la ilgili düzeltilmesi gereken sorunlar, APPS'la ilgili olmayan düzeltilmesi gerekn hatalar ve APPS Schema'sıyla ilgili düzeltilebilinecek hatalar listelenir.

"Re-create grants and synonyms for Apps Schema"  ile APPLSYSPUB schema'sı için bazı SYSTEM ve APPS paketlerine grant'ler ve synonym'ler tekrar yaratılır. Genelde "Validate Apps" ile ortaya çıkan sorunlar ertesinde gösterilir.

Application'ın Maintenance Mode'a Alınması

Application'ın maintenance mode'a alınması adadmin aracı ile yapılır. Oracle Applications'ı adstpall.sh scriptiyle kapadıktan sonra, Adadmin'i çalıştırıp 5. seçenek seçilip oradan da enable seçeneği seçilir. Application'ın Maintenance Mode'a alınmasının nedeni patch geçmektir. Patch geçmek için bu mode'a alınması gereklidir.

Not: Maintenace mode ile ilgili yazı

Oracle E-Business Suite: AD Controller Nedir? - Ne İşe Yarar? - Adctrl

Application Dba araçları (adpatch,adadmin,autoconfig) çalışırken, bu araçlar yapacakları her işlem için "worker" dedikleri bir process oluştururlar. Eğer bu worker'lardan herhangi birisi kapanırsa bunların kapandığına  dair manager'a haber vermek, bunları tekrardan çalıştırmak için adctrl komutunu çalıştırırız. Bu komut ile karşımıza bazı seçenekler çıkar. Ad controller ile karşımıza çıkan seçenekler aşağıdaki gibidir.

Adcontroller'ın loglarını $APPL_TOP/admin/$SID/log klasörü altında bulabiliriz. Bu dosya alıtnda adcontroller tarafından gözelenen worker'ların ne yaptıklarıyla ilgili loglar tutulmaktadır. Adworker'ların işleri güncellendikçe buradaki loglara yazılırlar.

Show Worker Status Ekranı:

1. seçenek seçildiğinde çalışan worker'lar ve bunların durumları gösterilir. Bu worker'lar failed olabilirler. 1. seçenek sayesinde patch'in ne durumda olduğunu görebiliriz. Eğer patch normalden uzun sürüyorsa yukarıda belirttiğimiz gibi $APPL_TOP/admin/$SID/log klasöründen çalışan worker'ların loglarına bakarız.Eğer burada timeout ya da takılma gibi bir sorundan bahsediliyorsa bu durumda worker'ımızı restart ederiz.

Tell Worker To Restart a Failed Job Ekranı:

2. seçenek seçildiğinde 1. ekranda görüp de fail etmiş bir job'ı tekrar çalıştırabiliriz. O fail eden job'ın numarasına göre burada fail etmiş worker olarak tekrar çalıştırabiliriz.

Tell Worker To Quit Ekranı:

3. seçenek ile herhangi bir worker kapatılabilir. Eğer birden fazla worker aynı işle uğraşıyorsa patch'te kilitlenmeler olabilir. Bu oluşan durumu engellemek için bazı worker'ları çıkmaya zorlayabiliriz.

Restart A Worker On The Current Machine:

Bu seçenekte de zaten çalışan, durumu "Running" olarak gözüken bir worker'ı tekrar çalıştırmaya zorlayabiliriz.

Ad Controller Interactive Olarak Nasıl Çalıştırılır?

Ad controller çalıştırmak için ilk önce $APPL_TOP/$APPLFENV ortam dosyasını çalıştırıp ardından adctrl komutunu çalıştırırız.

Adctrl'daki Gizli Opsiyon - Menu'deki Gizli 8.Seçenek:

Failed olan Worker'ları atlayıp sonradan tekrar çalıştırmak için konulmuş 8. opsiyon bulunmaktadır.
Bunun gizlenmesinin nedeni Oracle'ın çalışmayan Worker Log'larının incelenmesini ve düzeltilmesini sonradan da tekrardan çalıştırılmasını istemesinden dolayıdır. Eğer hızlıca bu konu geçilirse o zaman sorunun ana kaynağı öğrenilemez. Bu amaçlarla gizlidir. Oracle Support tarafından da önerilmedikçe kullanılması tavsiye edilmez.

Oracle E-Business Suite: AD Job Timing Report Nedir? - Ne İşe Yarar?

AD Job Timing raporu Autopatch(adpatch)  veya AD Administration(adadmin) tool'ları çalıştırıldığında otomatik olarak çalıştırılır. Bu rapor içerisinde çalıştırılan process'lerle ilgili bilgiler, session'la ilgili istatistikler depolanır. Ayrıca çalıştırılan porgramların zamanla ilgili istatistikleri de kaydedilir. Bu istatistikler $APPL_TOP/admin/(SID)/out klasörü altında "adt.lst" dosyası içerisinde kaydedilir. 

(Session_id'si nasıl bulunur?)

AD Job Timing Raporu Nasıl Çalıştırılır?

Bu rapor çalıştırılmadan önce ortam parametreleri dosyası çalıştırılır. "$APPL_TOP/$APPLFENV." Bu komut çalıştırıldıktan sonra sqlplus ile veritabanına bağlanıp "$AD_TOP/admin/sql/adtimrpt.sql" scriptini çalıştırırız ve çalıştırırken de 2 tane parametre veririz.

sqlplus apps/apps @$AD_TOP/admin/sql/adtimrpt.sql \ (session id) (output file)

Oracle E-Business Suite: Patch'ler Nasıl Merge Edilir? - Patch Merge Etmek

AD Merge Patch aracıyla(admgrpch) birden fazla application patch'i tek bir patch haline getirilir. $AD_TOP/bin altında bulunur.

-Patch'leri merge etmeden önce dikkatlice okumak gerekir. Patch'lerin içindeki readme dosyaları dikkatlice incelenerek içinde özel talimatlar olup olmadığına bakılır. Eğer varsa o patch merge edilmez. Elle kendimizin patch geçmesi gerekir.

-Merge edilecek patch'ler için bir klasör oluşturulur.

-Patch'lerin zip dosyaları oluşturduğumuz klasör içerisine konulur. (Zip dosyalarının açılması)

-Patch'ler unzip edildikten sonra AD Merge Patch komutu çalıştırılır.

Örnek kullanım:

admrgpch patch'lerin_unzip_edildiği_klasör merge_patch'ın_yaratılacagı_yer \ -merged_name merge'lü_patch'in_ismi

-Patch merge edildikten sonra herhangi bir sorun ihtimaline karşı log dosyası kontrol edilir.(admrgpch.log)

-Sonrasında patch'imiz normal bir şekilde apply edilir.

Oracle E-Business Suite: Application Dba(AD) Araçları - AD Tools

Oracle Applications yönetim araçları olarak "ad" kısaltması ile başlayan birden fazla araç vardır. Bu araçlar ile uygulamaları terminalden yönetebiliriz. Bu araçlar sayesinde kurulum, upgrade, update, patch ve maintenance gibi işlemleri gerçeleştirebiliriz.

Ana olarak kullanılan Application Dba(AD) araçları AD Administration(adadmin), AutoUpgrade(adaimgr), AutoPatch(adpatch) 'dir. Bunlar arasında birbirleriyle iletişim olabilir. Bir araç diğer bir aracı çağırabilir.

Özet olarak bulunan programlar aşağıdaki gibidir:

-Adadmin: AD Administration aracı ile Oracle Applications üzerinde maintenance işlemlerini gerçekleştiririz.

-Adpatch: AutoPatch ile patch'ler uygulanır.

-Adaimgr: AutoUpgrade, Oracle Applications upgrade aracıdır. Son versiyona yükseltir.

-Adctrl: AD Controller ile AutoUpgrade, AD Administration veya AutoPatch uygulamalarının "worker"'ları izlenir. Eğer bir programın worker'ları bozulursa bunları tekrar çalıştırıp, programa haber verir.

-Adutconf.sql: AD Configuration ile Oracle Application uygulamaları hakkında bilgi edinebiliriz. Örnek olarak modüllerin versiyonları,durumları gibi bilgileri bu sql'i çalıştırarak edinebiliriz. - (Adutconf için buradan daha fazla bilgi edinebilirsiniz.)

-Adident: Dosyaların versiyonlarını görmek için kullanabiliriz. Bu bilgi genellikle Oracle Support tarafından kullanılır. (AD File Identification)

-Adrelink: Oracle Executable programları Oracle Server Product Library'leriyle bağlar. (Adrelink)

-Admrgpch: Birden fazla patch'i tek bir patch haline getirir. (Admrgpch)

-AutoConfig: Sistem konfigürasyon dosyalarının ayarlanmasını sağlar. (Autoconfig)

Ortamın Ayarlanması:

Herhangi Application DBA aracı kullanmadan önce ortam değişkenlerinin ayarlanması tavsiye edilir. Eğer bu ayarlar bash_profile'a veya .profile'a atanmıyorsa her açılan session'da tekrar girilmesi gerekir. (Linux Unix Ortam Bash'lerin Rolü)

Ayarların set edilmesi için applmgr kullanıcısıyla makineye bağlanılır. $APPL_TOP/APPLFENV.env dosyası çalıştırılır.

AD Araçlarının Çalıştırılması:

Yukarıda belirttiğimiz araçlar çalıştırıldığında örnek olarak adpatch,adadmin,adctrl  kullanıldığında bu programların log dosyaları yaratılır. Böylece eğer programdan "ctrl+c" denerek çıkıldığında veya program çalışması abort edildiğinde, program eğer tekrar çalışırsa eski log dosyası belirtilerek oradan tekrar çalıştırılması sağlanabilir.

Oracle E-Business Suite: Admrgpch Nedir? - Ne İşe Yarar?

AutoPatch (adpatch) uygulaması her çalıştığında bir sürü bilgi talep eder ve uygulamaya bağlanmaya çalışır. Bu bilgilerin tekrar tekrar girilmesini engellemek için bazı generic ve birleştirilmeye uygun patch'ler birleştirilerek programların uygulama süresi kısaltılabilinir.

$AD_TOP/bin altında executable olarak bulunur; ama genellikle daha önceden PATH klasörüne eklendiği için herhangi bir klasör altından çalıştırılabilinir.

Oracle E-Business Suite: Adrelink Nedir? - Ne İşe Yarar?

Adrelink uygulaması Oracle Applications'da tanımlı executable program'ları Oracle Server Product Library'leriyle tekrar bağlantısını sağlar.

Adrelink.sh'ının yaptığını yapan benzer bir araç adadmin aracının içinde yer almaktadır. Ancak bu yolla ad executable'ları bağlanamadığı için ad relink elle çalıştırılmalıdır. Eğer bir hata çıkarsa $APPL_TOP/admin/log dizini altında dosyaya kaydedilir.

Gerekirse log dosyası silinebilir. Çünkü program her çalıştığında yoksa çalışır varsa da üzerine ekler.

Çalıştırılma Syntax'ı:

 $ adrelink.sh force={y | n} []  \  
 []  

Not: Eğer Oracle Applications ürünlerinden bir tanesi relink edilecekse Concurrent Manager'lar kapatılmalıdır.

Oracle E-Business Suite: AD File Identification Nedir? - Ne İşe Yarar?

Adident ile Oracle Application'daki dosyaların versiyon ve diğer bilgilerini görebiliriz. Bu program genelde Oracle Support'tan bir sorun üzerine açtığımız SR'lar sonucunda gelen bilgi isteklerini karşılamak için kullanılır.

Kullanım Şekli:

 $ adident $AD_TOP/sql/adutconf.sql  
 adutconf.sql: 115.13 (0)  

ya da

$ adident Header $AD_TOP/sql/adutconf.sql   
 /orappl/EBSUAT/apps/apps_st/appl/ad/12.0.0/sql/adutconf.sql:  
 $Header adutconf.sql 120.0.12010000.2 2008/10/14 11:14:48 bbhumire ship $

Eğer dosyada versiyon bilgisi varsa gösterilir; yoksa hata verir.

Oracle E-Business Suite: AD Configuration Nedir? - Ne İşe Yarar?

AD Configuration aracı adutconf kısa adıyla geçer. Bu program bir sql script'idir. Oracle Uygulamaları hakkında standart bilgileri gösterir. Bu  araç ile Oracle EBS database'imizin o anlık bir snapshot'ını çıkarabiliriz. Adutconf.sql'ini çalıştırdığımızda adutconf.lst adlı bir rapor dosyası çıkar. Bunun içerisinde de:

• Ürün Grupları
• Lisanslı Ürünler
• Lisanslı Ürünlerin Bilgileri
• Kurulu Diller
• İnit.ora Ayarları 

gibi bilgiler yer alır. 

Adutconf.sql  $AD_TOP/sql klasörü içerisinde yer alır. Çalıştırmak için aşağıdaki komutu uygulayabiliriz.

 cd $AD_TOP/sql  
 sqlplus apps/ @adutconf.sql  

Oracle E-Business Suite: Autoconfig Nedir? - Nasıl Çalıştırılır?

Autoconfig Nedir?

Autoconfig Oracle Applications'da konfigürasyon aracı olarak kullanılır. Ne zaman konfigürasyonda bir değişiklik yapılırsa ya da bir patch readme'sinde yazılırsa autoconfig script'i çalıştırılır. Application instance'ındaki standart değişikliklerin yapılması için kullanılan, kurulum,konfigürasyonve patch'leme işlemlerinde çalıştırılan ana araçtır.

APPL_TOP konfigürasyonları ile ayarların tutulduğu ve Application'ın çalışması ile ilgili bilgilerin barındırıldığı ana merkez "Applications Context" olarak belirtilir. Autoconfig çalıştığında Context dosyasındaki bilgileri kullanarak konfigürasyon dosyalarını oluşturur ve veritabanındaki profilleri günceller.

Autoconfig ile context dosyası değiştirilir(xml dosyası). Değiştirilen bu context dosyasıyla ilgili konfigürasyon modifikasyonuula ilgili bilgiler toplanır. Bunlar uygun konfigurasyon dosyasına yazılır ya da gerekli dosyalar yaratılır. Buna göre uygun process'ler çalıştırılır. Belirli konfigürasyon dosyalarına ek olarak httpd.conf, jserv.properties, appsweb.cfg dosyaları da konfigüre edilir. Veritabanında tutulan çeşitli ayarların değiştirilmesi mümkündür.

Applications context file'ı $INST_TOP/appl/admin/$CONTEXT_NAME.xml 'dir. Bu context file içinde

• Database Bilgisi
• Form ve Web Servis Bilgileri
• Port Numaraları
• Application Bilgileri

yer alır. 

Not: $CONTEXT_NAME=$SID_$HOSTNAME 'dir.

Database context file'ı ise $ORACLE_HOME/appsutil/$CONTEXT_NAME.xml 'dir. Database tarafında autoconfig çalıştırıldığında bu dosya değişir.

Application tarafında çalıştığında application context file'ını kullanıp konfigürasyon dosyalarını oluşturup database profillerini güncelleştirirken, database tarafında çalıştığında database context file'ını kullanır. 

Autoconfig Nasıl Çalıştırılır?

Application tarafında:  $ADMIN_SCRIPTS_HOME altında database tarafında: $ORACLE_HOME/appsutil/scripts/$CONTEXT_NAME dizinlerinde bulunur.

Not: $ADMIN_SCRIPTS_HOME=$INST_TOP/admin/scripts

Adautocfg.sh,  $AD_TOP/bin altındaki adconfig.sh'ı çağırır. O da yine $AD_TOP/bin altındaki adconfig.pl'i çağırır.

Application tarafındaki aşamalar Sırasıyla:

1. Application kullanıcısıyla bağlanılır. (Genelde applmgr oalrak)2.

     2. $APPL_TOP/$SID_$MAKINE_ADI.env adlı environment dosyası çalışıtırılır. 

     3. Application kapatılır.

     

        ./$ADMIN_SCRIPTS_HOME/adstpall.sh apps/password

     4. $ADMIN_SCRIPTS_HOME altındaki ./adautocfg.sh çalıştırılır.

     5. Autoconfig. çalıştırıldıktan sonra bulunduğumuz klasörden afterconfig.sh çalıştırırız.

     6. Application açılır.

         $ADMIN_SCRIPTS_HOME altındaki ./adstrtall.sh çalıştırılır.

Log Dosyası:

Autoconfig'in log dosyası $INST_TOP/admin/log/$(date) dizinindedir. Bununla birlikte
$INST_TOP/admin/install altında install scriptleri $INST_TOP/admin/scripts altında control script'leri bulunur. 

Context File:

Autoconfi dosyası $INST_TOP/appl/admin/$CONTEXT_NAME.xml adlı dizindedir. 

Bu dosyada değişiklikler yapılır.