Oracle E-Business Suite: Patch'lerden Geri Dönüş - Backing Out Patches and Restoring To A Previous State

Uygulanan patch'lerden bazıları bazen hata geri döndürebilir. Bu durumda apply edilmiş patch'ler geri döndürülmez. Hatalı halleriyle kalırlar. Oracle tarafından da otomatize edilmiş patch'ten geri dönüş yolu yoktur. Bu yüzden hatalı patch'leri düzeltme adımları vardır. Yani bakılacak aşamalar, kontrol edilecek işlemler bulunmaktadır.

Bu yüzden 5-10 mb'tan yüksek patch'ler için backup alınmalıdır. Hem veritabanı backup'ı hem de application backup'ı alınmalıdır.

Eğer bir patch hata alırsa:

1- Hatanın nedenini belirlemek:

Hatanın nedeni genelde ekranda ortaya çıkar. Ancak ekranda çalışıyor gibi gözüküyorsa eğer bu durumda bakılacak belirli yerler vardır. Öncelikle bakacağımız yer "adctrl" tool'udur.

Bu tool'u çalıştırıp worker'ların durumunu görebilir ve loglarına bakabiliriz. Bu logları okuyaraktan hangi form, procedure,sql veya script'de hata ile karşılaşıldığı bulunabilinir.

Bu işlemler dışında adpatch loguna bakabiliriz. Bu patch log'u genelde adpatch'in çalıştırıldığı yere konur. Ancak özel bir yer belirtilmediyse $APPL_TOP/admin/$SID/log altına konur. Dosyanın ismi bilinmiyorsa "ls -lrt" komutyla patch sırasında en son değişen dosya bulunabilinir. Bu şekilde hatayla ilgili daha fazla bilgi edinebiliriz.

Hatalarla ilgili baktığımız diğer log lokasyonları da buradaki gibidir.

2-  Bununla İlgili Yapılacak Aksiyonları Belirlemek:

Yukarıdaki belirttiğimiz log dosyalarına bakıp, hata alan işlemleri düzeltmeye çalışabiliriz.

3-  Dosyaları Eski Yerlerine Koymak:

Adpatch dosyaları uygularken eğer bulunduğu klasördeki doküman, değiştireceği dokümandan daha yeniyse eğer, bu dosya (patch_klasörü)/backup/($SID)/($HOSTNAME) kendi ilişkili klasörü altına yedeklenir. Eğer patch çok büyükse patch uygulamadan önceki aldığımız "Apps" dizini backup'ından bütün sistem dönülür.

4- Relink'lemek:

Dosyaların bozulma ihtimaline karşı relink işlemi gerçekleştirilir. Bunun için bozulan dosyalar belirlenir ve adrelink ile tekrar bağlantıları sağlanır.

5- Java Dosyalarını Geri Döndürmek:

Java dosyaları patch sırasında değiştirildiyse eğer  bu dizinden (patch_klasörü)/backup/($SID)/($HOSTNAME) java dosyaları geri döndürülür.

 $ adjava -mx256m oracle.apps.ad.jri.adjcopy @undoScript.cmd 

6- Jar Dosylarının Tekrar Yaratılması: 

Java dosyalarını yukarı da belirttiğimiz gibi tekrar ürettiysek, o zaman Jar dosyalarını da tekrar yaratmalıyız. Bu işlemleri de Adadmin aracıyla yapabiliriz.

7- İlişkili Form'ların Tekrar Yaratılması:

En son olarak da etkilenen bütün modüllerin formlarının compile'ı adadmin ile gerçekleştirilir.

Oracle E-Business Suite: Patch Application Assistant - PAA

Patch Application Assistant kısaca PAA bize Oracle E-Business Suite'de patch geçme konusunda çok büyük kolaylık sağlamaktadır. PAA ile bir patch geçimi için gereklilikleri güzel bir arayüzle görebiliriz. Bu bir arayüz olduğu için "DISPLAY" parametresinin aktif olması gerekir. Eğer arayüz yoksa vncserver veya benzeri bir program ile bağlantı yapmamız gerekir.

Bağlantı yaptıktan sonra $APPL_TOP/$APPLENV dosyasını çalıştırır ve ortamı set ederiz. Sonrasında patch'in driver'ının bulunduğu klasöre gideriz ve bu klasör de "admsi.pl" dosyasını çalışıtırırız. Çalıştırdıktan sonra aşağıdaki gibi bir ekran görüntüsü elde ederiz. Burada patch'in bulunduğu klasörün adını ve Apps kulla nıcısnın şifresini girmemiz gerekir.

Bu bilgileri girdikten sonra karşımıza aşağıdaki gibi bir ekran çıkar. Bu ekrandan patch'imizle ilgili uygulanması gereken prerequisite'ler, post-installation task'leri gibi şeyler varsa görebiliriz.

Bu sırada başka bir ekrandan burada istenen işlemleri gerçekletiririz. Bu uygulamayla biz patch uygulamayız. Sadece patch için gereken işlemleri rahat gerçekleştirmek için yararlanırız. Bütün işlemleri gerçekleştirip "next" dediğimizde yapılması zorunlu işlemlerden hangilerinini yapıldığını "Completed" sütununda tıklı olarak görürsek yaptığımız işlemlerin başarıyla gerçekleştirildiğini bilebiliriz.

Oracle E-Business Suite: EBS Patch Geçme Prosedürü - EBS Patching Procedures

Oracle E-Business Suite'de patch geçmek için belli başlı adımları takip etmemiz gerekir. Patch işlemine başlamadan önce her zaman uygulamanın kapatılması "adstpall.sh" ve uygulamanın maintenance mode'a alınması (Adadmin>Enable Maintenance Mode)tavsiye edilir.

1- Patch Readme'sini Okuma:

Patch Readme dosyası, patch klasörünün içinde bulunur. Bu dosyada her patch öncesi,sırası ve sonrasında eğer varsa uygulanması gereken adımları belirtilir. Okunması ve buradaki adımların gerçekleştirilmesi çok önemlidir. Patch'in sağlıklı bir şekilde geçilmesini sağlar.

Bununla ilgili bir Oracle tool'u da bulunmaktadır. Bu yazımızda bununla ilgili bilgileri görebiliriz.


2- Patch Gerekliliklerini (Prerequisites) Gerçekleştirme:

Bu adım Readme dosyasında Pre-Install Tasks başlığı altında gösterilir. Aynı zamanda bu patch'in üzerine kurulması gereken  patch'ler de "Additional Information" başlığı altında gösterilir.

Patch gereklilikleri elle gerçekleştirilmesi gereken adımlarda olabilir. Bir dosyanın başka bir yere elle kopyalanması, formların compile edilmesi veya invalid object'lerin düzeltilmesi gibi işlemler olabilir.

Önceki istenen patch'lerin kurulması veya istenen patch seviyelerinin kontrolü önemlidir. Buna göre patch'ler başarıyla geçilebilinir.


3- Patch Apply Etme:

Patch'i uygulamamız için terminal de "adpatch" komutunu vermemiz gerekir. İlk olarak patch'in bulunduğu klasöre gidip, orada adpatch komutunu çalıştırırız.Sonrasında gereken cevaplar verilerek uygulama safhasına kadar gelinir. Bize en son patch klasörü içinde bulunup bulunmadığımız ve patch dosyasının ismi sorulur. Bu sorular sorulduktan sonra patch apply edilmeye başlanır.

Patch apply edilirken eğer dil bakımından başka bir opsiyon varsa bu opsiyon patch uygulanmadan önce sorulur. Eğer patch'in "Türkçesi" varsa bu patch "US" versiyonundan sonra uygulanmalıdır. İlk önce "US" yani "American"  patch versiyonu uygulanır. Ertesinde "Türkçe" versiyonu uygulanır. Patch uygulanırken bunun temin edilmesi gerektiği belirtilir sadece. Sonrasında uygulanan adımlar ve yapılan işlemler ekranda gösterilir.

Patch Test Etme:

Patch'in etkilerini gözlemlemek için patch'leri ilk olarak test ortamlarına uygularız. Ancak eğer test ortamımız yoksa patch'i uygulamadan yükleriz. Yani "adpatch apply=no" komutunu veririz. Böylece patch tarafından gerçekleştirilecek hareketler listelenir ancak veritabanı veya dosya sisteminde bir değişiklik gerçekleştirilmez.

4- Post Installation Adımları:

Post installation adımları, pre-installation adımları gibi uygulanması gereken adımlardır. Bu adımlarda patch'in sağlıklı bir şekilde bitirilmesi ve sorunun ortadan kaldırılması için önemlidir.

5- Patch Kurulumunun Kontrolleri:

Bununla ilgili kontroller genellikle patch klasörü içindeki "Readme.txt" 'i içerisinde belirtilir. Bu kontrolleri veritabanını sorgulayaraktan veya uygulamada uygun yerleri kontrol ederekten yapabiliriz.

Genelde patch'ler kurulduktan bazı dosyaların versiyonları değişir. Bu versiyon değişimlerini bu yazımızda belirttiğimiz gibi kontrol edebiliriz.

Uygulamadan kontrol etmek istiyorsak da "System Administrator" sorumluluğuna giderekten  "Dashboard" fonksiyonuna tıklayıp giriş yapıp oradan "Software Update" seçeneğini seçeriz

Software Update

2. yöntem olarak "System Administrator" sorumluluğunun altında "Patching and Utilites" sekmesine girip oradan patch numarasına bakabiliriz.

Patching and Utilities

Veritabanından patch'in kurulumunu kontrol etmek istiyorsak ad_applied_patches veya ad_bugs tablolarını kontrol edebiliriz. "ad_bugs" tablosu patch'lerin varlığını kontrol etmek için daha garanti bir yoldur; çünkü bazı patch'ler diğer patch'lerle merge edilmiş olabilirler. Bu yüzden "ad_applied_patches" tablosunda görünmeyebilirler. Uygulamadan kontrol etmek de her zaman garanti bir yoldur.

Oracle E-Business Suite: Dosya Versiyonlarının Kontrolü - Checking The Versions of The Files

Oracle E-Business Suite'de dosya ve sistemin versiyonlarının kontrol edilmesi, patch geçilmesi sırasında gerekebilmektedir. Bazı patch'lerde kontrol yapmak için bizden dosyaların versiyonları istenmektedir. Bunun için genel istekleri sıralarsak:

-Application versiyonu için:

 select release_name from apps.fnd_product_Groups;  

-Herhangi bir form'un veya report'un dosya versiyonunu bulmak için:

strings -a form_ismi | grep Header 

Örnek:

strings -a APXINWKB.fmb | grep Header 

Başka bir yöntem ise aşağıdaki komutu kullanmaktır.

 adident Header form_ismi

-Application Product, Patch Set Level, Code Level:

Patch'lerde gözüken, ve prerequisite olarak bazen istenen bilgiler olarak Application Product ya da Patch Set Level ya Code Level aşağıdaki sorguyla bulunabilinir. Örneğin Application DBA uygulaması için Patch Set Level'ı aşağıdaki sorgunun sonucudur.

select patch_level from fnd_product_installations where patch_level like '%AD%'; 

Eğer başka bir uygulama için isteniyorsa da "AD" yerine o uygulamanın kısa adını yazabiliriz.

Bu sorguyla yine diğer bütün uygulamaların seviyelerini bulabiliriz.

 select APP_SHORT_NAME, max(PATCH_LEVEL) from AD_PATCH_DRIVER_MINIPKS GROUP BY APP_SHORT_NAME;

Uygulamanın geliştirilme versiyonları aşağıdaki sorguyla bulunabilinir.

 select ARU_RELEASE_NAME||'.'||MINOR_VERSION||'.'||TAPE_VERSION version,  
  START_DATE_ACTIVE updated, END_DATE_ACTIVE "when lasted",  
  CASE WHEN BASE_RELEASE_FLAG = 'Y' Then 'BASE VERSION'  
  ELSE 'Upgrade' END "BASE/UPGRADE", ROW_SOURCE_COMMENTS "how it is done"  
  from APPS.AD_RELEASES; 

Oracle Veritabanı ve E-Business Suite: My Oracle Support(Metalink)'ten Nasıl Patch İndirilir? - How To Download a Patch For EBS or Oracle Database

Oracle'ın bütün ürünleri için aşağıdaki adımları izleyerek patch'ler indirebiliriz. Burada anlattığımız yollar Oracle Veritabanı ve Oracle E-Business Suite özelinde hazırlanmıştır ancak diğer ürünler içinde nereden indirilebileceğini aşağıdaki yoldan görebiliriz. İlk olarak My Oracle Support sayfasına gitmemiz gerekir. Bu ana sayfadan diğer yerlere yönlenebiliriz.

Bu sayfadan sonra yukarıdaki tab'dan "Patches & Updates" sekmesine tıklarız.

 Bu örnek için özel olarak patch numarasını bildiğimiz için buna göre bir arama gerçekleştiririz. Üzerine yükleyeceğimiz patch'i de seçip "search" düğmesine tıklayınca bununla ilgili sonuçlar aşağıdaki gibi karşımıza çıkar.

Bu patch arama işlemi sonrasında çıkan sayfada gerekli seçeneklleri seçeriz. Bazen versiyon seçenekleri, dil seçenekleri ve platform tipini sorabilmektedir. Aşağıdaki örnek için sadece dil seçeneğini seçeriz. Dil olarak türkçe seçmemiz önemlidir; çünkü sistemimiz türkçe'dir. Tabi bu duruma göre değişir. Türkçe'yi direk seçersek beraberinde US versiyonu da birlikte gelmektedir. Eğer EBS kurulumunda olduğu gibi US versiyonu Base installation'la birlikte gelmektedir. Yani default kurulumla birlikte gelir. Eğer Türkçeyi seçersek  yanında US versiyonunu da indirmek için soracaktır.

Burada da US versiyonunu indirmek için sormaktadır; çünkü öncesinde  versiyonu Türkçe olarak belirtmiştik.

Buradan her ikisini de indiririz.

Yukarıdaki resim de ise Oracle Database için nasıl patch indirilebileceğini görmekteyiz. Ürün olarak Oracle Database seçtikten sonra versiyonumuzu ve platformumuzu seçeriz. Sonrasında "Search"  diyip buna uygun patch'ler karşımıza çıkar

Karşımıza çıkan sonuçlardan istediğimizi seçip aşağıdaki örnekteki gibi indirip kurabiliriz.