Geçiş Yardımcı Programı

HOD'un daha düşük bir sürümünden daha yüksek bir sürümüne geçmek için bu yardımcı programı kullanabilirsiniz. Host On-Demand geçişi iki adımlı bir süreçtir:

  1. Dosyaların kaynak HOD sunucusundan (HOD11 ya da HOD12) dışa aktarılması. Bu işlem Migrationpackage.zip dosyasını yaratır.
  2. Dışa aktarılan dosyaların hedef HOD sunucusuna (içe) aktarılması. Bu işlem, Migrationpackage.zip dosyasındaki dosyaları hedef HOD sunucusuna (HOD12 ya da HO13) aktarır.

HOD kaynak ve hedef sunucusu aynı makinede olabileceği gibi farklı bir makinede de olabilir.

Not: HOD kaynak ve hedef sunucusu farklı makinelerdeyse, dışa aktarma işleminde yaratılan Migrationpackage.zip dosyasının hedef makineye konması gerekir (bu işlemi denetimci el ile yapmalıdır).

İzin verilen Host On-Demand geçiş sürümleri ve ortamları

Host On-Demand geçiş sürümleri

  1. HOD11'den HOD12'ye
  2. HOD11'den HOD13'e
  3. HOD12'den (daha düşük sürüm düzeyi) HOD12'ye (daha yüksek sürüm düzeyi)
  4. HOD12'den HOD13'e

Host On-Demand geçişi için desteklenen ortamlar

  1. 1. Win 2016
  2. Win 7 - 32 bit
  3. Win 7 - 64 bit
  4. Win 2012 64 bit S- Çince
  5. Win 7 - Japonca
  6. Win 10 Ent - 64 bit Creator Update
  7. Win 2012
  8. Ubuntu - 64 bit
  9. z/OS
  10. RHEL 7.2
  11. AIX 7.2
  12. AS400 7.2

Not: Dışa aktarma ve içe aktarma işlemleri yalnızca aynı altyapıda (örneğin, Windows'tan Windows'a, Linux'tan Linux'a) desteklenir.

HOD geçiş yardımcı programının yeri ve kurulması

HODMigrationUtility.zip Fix Central'da kullanıma sunulur. Denetimci bu zip dosyasını aşağı yüklemeli ve Host On-Demand yayın dizinine koymalıdır. Başkaca kuruluş gerekmez.

HODMigrationUtility.zip dosyasının içerdiği dosyalar

  1. Build.ID: HOD sürümünü ve oluşturma tarihini içeren “buildid” (oluşturma tanıtıcısı)
  2. HODMigrationUtility.jar: Geçiş yardımcı programı jar dosyası
  3. Export.xml: “Dışa aktarma” işlemi için gereken giriş dosyası
  4. Import.xml: “İçe aktarma” işlemi için gereken giriş dosyası

HOD geçiş yardımcı programını çalıştırma adımları

  1. HODMigrationUtility.zip dosyasını açın.
  2. Export.xml ve import.xml dosyalarının içeriğini gereken şekilde değiştirin. Hangi girişlerin gerektiğini anlamak için aşağıdaki “5 .Dışa aktarma ve içe aktarma giriş dosyaları” başlıklı kısma bakın.
  3. Bir komut istemi açın ve HODMigrationUtility.jar dosyasının bulunduğu dizine gidin.

    Örn. cd C:\Program Files (x86)\IBM\HostOnDemand13\HOD13\HODMigrationUtility

  4. Geçiş işlemini çalıştıracak komutu belirtin.

    Dışa aktarma işlemi: java –jar HODMigrationUtility.jar c:\Test\Export.xml

    Not: Dışa aktarma işlemi tamamlanınca, bir tamamlama iletisiyle birlikte geçiş paketi zip dosyasının yaratıldığı yer görüntülenir.

    İçe aktarma işlemi: java –jar HODMigrationUtility.jar c:\Test\Import.xml

    Not: İçe aktarma işlemi tamamlanınca bir başarı iletisi görüntülenir.

    Geriye işleme işlemi: java –jar HODMigrationUtility.jar c:\Test\Rollback.xml

    Not: İçe aktarma işlemi gerçekleştirildikten sonra geriye işleme xml dosyası otomatik olarak oluşturulur. Geriye işleme yalnızca bir kez gerçekleştirilebilir.

Dışa aktarma ve içe aktarma giriş dosyaları

Dışa aktarma:

Çizelge 1. Dışa aktarma giriş özniteliklerinin listesi ve anlamları
Giriş özniteliği Açıklama
migrationInput Giriş xml dosyasının kök dizini.
mode Bu etiket işlemin kipini belirtir. Bu etiket için giriş zorunludur. Bu etiketin girişi “export” olmalıdır (büyük ve küçük harfe duyarlı değildir).
HODPublishDirectory Host On-Demand yayın dizinini belirtir.

Bu etiket için giriş zorunludur.

Örn. 

<HODPublishDirectory>C:\Program Files\IBM\HostOnDemand\HOD</HODPublishDirectory>
sourceMigratingPackage Geçiş paketi zip dosyasının saklanacağı yeri belirtir.

Belirlenmezse, geçiş paketi zip dosyasını saklamak için yürürlükteki yer kullanılır.

Örn. 

<migratingPackageLocation>C:\Test</migratingPackageLocation>
overWrite Bu etiket için giriş zorunludur.

“yes” girişi (varsayılan): Geçiş paketi zaten varsa, yardımcı program var olan paketin üzerine yazar. Aşağıdaki ileti görüntülenir.
Geçiş paketi şu yerde zaten var :
C:\Program Files (x86)\IBM\
HostOnDemand\HOD\HODMigrationUtility\MigrationPackage.zip

Geçiş, var olan geçiş paketinin üzerine yazıyor.

Geçiş paketi şu yerde başarıyla yaratıldı...
C:\Program Files (x86)\IBM\
HostOnDemand11\HOD11\HODMigrationUtility\MigrationPackage.zip

“no” girişi: Geçiş paketi zaten varsa, yardımcı program geçiş paketini yaratmaz. Onun yerine, aşağıdaki ileti görüntülenir. 
Geçiş paketi şu yerde zaten var .. : 
C:\Program Files (x86)\IBM\
HostOnDemand\HOD\HODMigrationUtility\MigrationPackage.zip

Var olan geçiş paketi nedeniyle geçiş sonlandırıldı.
HOD geçiş işlemi sonlandırıldı
customFiles customFiles, fileLocation alt etiketlerinin üst etiketidir.

Varsayılan yerden (user/HODObjs) başka yerlerde saklanmış özel dosyalar (.kmp .bar .col .pmp,.mac) varsa, geçişte bu dosyaların da alınabilmesi için bu etikette bu yerler belirtilmelidir.

fileLocation etiketinde her özel dosya yerinin belirtilmesi gerekir.

Örn. 

<customFiles>
	<fileLocation>C:\Test1</fileLocation>
	<fileLocation>C:\Test2</fileLocation>
	</customFiles>

Geçiş paketine (dışa) aktarılacak dosyaların listesi için aşağıdaki çizelgeye bakın.
Çizelge 2. Dışa aktarma işleminin kapsadığı dosyalar
Dosyalar Yer Dosyalar hedef makineye doğrudan kopyalanır Dosyalar geçiş yardımcı programı tarafından değiştirilir
Konuşlandırma sihirbazı dosyaları      
KS tarafından yaratılan html, z_*.html, _J2.html, .jnlp HOD yayın dizini Hayır Tümü
Tüm HOD Data klasörü

.cf dosyaları

wInfo.txt

Policy.obj

Preload.obj

Params.txt

udparams.txt

 HOD yayın dizini HODData Aşağıdaki dosyalar doğrudan hedef HOD sunucusuna kopyalanır:

Policy.obj

Preload.obj

Params.txt

wInfo.txt

.cf dosyası

udparams.txt

Özel dosyalar      
Varsayılan özel dosyalar Kullanıcı dizini HODObjs klasörü, örn.: C:\Users\<SystemUser>\HODObjs Evet Hayır
Kullanıcı tanımlı özel dosyalar Kullanıcı tanımlı yer (paylaşılan dizin ya da ağ yeri) Evet (customfiles klasörü yaratılır ve tüm özel dosyalar kopyalanır) Hayır
Private Dizini dosyaları      
Özel Dosyalar (tüm dosyaları ve klasörler) HOD kuruluş dizini private Evet Hayır
Dizin Yardımcı Programı      
Sample.xml ve kullanıcı tarafından yaratılan .xml HOD kuruluş dizini lib\samples\DirUtil Evet Hayır
Güvenlik      
HODSerKeyDb.kdb HODServerKeyDb.sth HODServerKeyDb.rdb bin dizini Evet Hayır
WellKnownTrustedCAs.class WellKnownTrustedCAs.jks WellKnownTrustedCAs.p12 HOD yayın dizini Aynı adı taşıyan bir dosya zaten varsa, dosya hedef HOD sunucusuna kopyalanmaz. .p12'den jks dosyasına dönüşüm
pdfpdt dosyaları      
Yazıcı Tanımlaması Dosyası: Tüm dosyalar HOD yayın dizini/ pdfpdt Evet Hayır
Özellik dosyası      
Config.properties HOD yayın dizini Evet Hayır
Çizelge 3. İçe aktarma giriş özniteliklerinin listesi ve anlamları
Giriş özniteliği Açıklama
migrationInput Giriş xml dosyasının kök dizini.
mode Bu etiket işlemin kipini belirtir. Bu etiket için giriş zorunludur. Bu etiketin girişi “import” olmalıdır (büyük ve küçük harfe duyarlı değildir).
HODPublishDirectory Host On-Demand yayın dizinini belirtir.

Bu etiket için giriş zorunludur.

Örn. 

<HODPublishDirectory>C:\Program Files\IBM\
HostOnDemand\HOD</HODPublishDirectory>
migratingPackageLocation Geçiş paketi zip dosyasının saklanacağı yeri belirtir.

Belirlenmezse, geçiş paketi zip dosyasını saklamak için yürürlükteki yer kullanılır.

Örn. 

<migratingPackageLocation>C:\Test</migratingPackageLocation>
systemJavaBinDirectory z/OS ve AS/400 sistemi java bin klasörünü belirtir.

Bu etiket yalnızca z/OS ve AS/400 işletim sistemleri için gereklidir.

Örn. 

<systemJavaBinDirectory>>/usr/lpp/javapkg/
J6.0/bin</systemJavaBinDirectory>
options options etiketi, aşağıdaki alt etiketlere giriş sağlayan üst etikettir.

Terminal, FileTransfer, Icon, FTPTerminal, dbaOptions, targetUI

Bu etiketlerin aşağıdaki biçimde belirtilmesi gerekir: 

<Terminal key="" value=""/>
	<FileTransfer key="" value=""/>
	<FTPTerminal key="" value=""/>
	<dbaOptions key="" value=""/>

Yukarıda geçen etiketler oturum değiştirgesiyle ilgilidir.

SSL3'ü JSSE TLS1.2'ye dönüştürmek için güvenlikle ilgili değiştirgeler de belirtilebilir. Bunun Terminal etiketi altında ayarlanması gerekir.

Bu etiketlerin girişi, çift tırnak içine alınmış anahtar ve değerdir. 

Örn. <Terminal key="LUName"
				value="abc"/>

Anahtar boş değerli olmamalıdır, değer boş değer olabilir.

Bu anahtar değer çiftleri, ilgili oturumların hedef sisteminde cf dosyasına yazılır.

Birden fazla oturum değiştirgesi belirtmek için, etiketin farklı anahtar ve değer çiftiyle yinelenmesi gerekir. Örn.

<Terminal key="LUName" value="abc"/>
			<Terminal key="History" value="false"/>
			<Terminal key="fontStyle" value="0"/>
targetUI HOD 11 ve HOD12/HOD13 sürümlerinde HTML dosyası görünüş ve biçemi farklıdır.

HOD12 ve HOD13, HTML dosyaları için “Nimbus” görünüş ve biçemini kullanır.

“yes” girişi (varsayılan): Geçirilen tüm HTML dosyaları kendi kullanıcı arabirimlerinde Nimbus görünüş ve biçemini edinir.

“no” girişi: HTML dosyalarının kaynak kullanıcı arabirimindeki görünüş ve biçemi korunur.
codebase Bu etiket için giriş zorunludur.

Webstart istemci sayfaları için bu kod tabanı gereklidir. Burada belirteceğiniz URL, hedef Host On-Demand yayın dizinini tanıtmalıdır. Örn.
<codebase>http://server_name.mycompany.com/
hodalias</codebase>

Burada server_name.mycompany.com, Host On-Demand'ın kurulu olduğu sunucunun adı ve hodalias, Host On-Demand yayın diğer adıdır.
targetBackup Bu etiket için giriş zorunludur.

“yes” girişi (varsayılan): Hedef Host On-Demand sunucusu dosyaları için yedek dosya yaratılır. İçe aktarmanın çalıştırılacağı hedef Host On-Demand sunucusu; dosyalar içe aktarma çalıştırılmadan önce yedeklenir. Yedeklenecek dosyaların listesi için aşağıdaki çizelgeye bakın.

“no” girişi: Host On-Demand sunucusu dosyalarını geçirmek için yedek dosya yaratılmaz.
overwriteHODPublishDirectory Bu etiket için giriş zorunludur.

“yes” girişi (varsayılan): Hedef HOD sunucusundaki yayın dizininde, aynı adı taşıyan dosyaların (kaynak ve hedef dosyalar) üzerine yazılır.

“no” girişi: Yayın dizininde, aynı adı taşıyan dosyaların (kaynak ve hedef dosyalar) üzerine yazılmaz; yalnızca, yeni dosyalar ya da dizinler hedefe geçirilir.
overwritePrivate Bu etiket için giriş zorunludur.

“yes” girişi (varsayılan): Hedef HOD sunucusundaki private dizininde, aynı adı taşıyan dosyaların (kaynak ve hedef dosyalar) üzerine yazılır.

“no” girişi: Private dizininde, aynı adı taşıyan dosyaların (kaynak ve hedef dosyalar) üzerine yazılmaz; yalnızca, yeni dosyalar ya da dizinler hedefe geçirilir.
overwritePdfPdt Bu etiket için giriş zorunludur.

“yes” girişi (varsayılan): Hedef HOD sunucusundaki pdfpdt dizininde, aynı adı taşıyan dosyaların (kaynak ve hedef dosyalar) üzerine yazılır.

“no” girişi: pdfpdt dizininde, aynı adı taşıyan dosyaların (kaynak ve hedef dosyalar) üzerine yazılmaz; yalnızca, yeni dosyalar ya da dizinler hedefe geçirilir.
overwriteDirUtil Bu etiket için giriş zorunludur.

“yes” girişi (varsayılan): Hedef HOD sunucusundaki DirUtil dizininde, aynı adı taşıyan dosyaların (kaynak ve hedef dosyalar) üzerine yazılır.

“no” girişi: DirUtil dizininde, aynı adı taşıyan dosyaların (kaynak ve hedef dosyalar) üzerine yazılmaz; yalnızca, yeni dosyalar ya da dizinler hedefe geçirilir.
Çizelge 4. Hedef dizindeki yedeklenecek dosyaların listesi
Klasör Dosyalar
Private dizini Tüm dosyalar ve dizinler
Bin dizini HODServerKeyDb.kdb , HODServerKeyDb.sth, HODServerKeyDb.rdb, HODServerKeyStore.jks
HOD yayın dizini->pdfpdt Yazıcı Tanımlama Dosyası
HOD yayın dizini WellKnownTrustedCAs.class WellKnownTrustedCAs.jks WellKnownTrustedCAs.p12 CustomizedCAs.p12 CustomizedCAs.jks CustomizedCAs.sth Config.properties Konuşlandırma Sihirbazı Dosyaları
lib klasörü redir.properties
lib\samples\DirUtil Tüm dosyalar
HostOnDemand\HOD\HODData Tüm klasörler ve dosyalar

İçe aktarma işlemiyle ilgili artalan bilgileri

  1. Özel dosyalar (hem varsayılanlar hem de export xml içindekiler) içe aktarılır.
    • Özel Dosya Yeri: /lib/CustomFiles/
    • Varsayılan Dosya Yeri: System user/admin/HODObjs/
  2. Güvenlik anahtar deposu hedefte yoksa içe aktarılır.
    • Hedefte yalnızca P12 ve KDB anahtar deposu varsa, kaynak sistemdeki P12 ve KDB, JKS'ye dönüştürülür.
    • Hedef zaten JKS, P12 ve KDB'den oluşuyorsa, içe aktarmada tüm anahtar depoları yoksayılır. Hedefteki anahtar deposu olduğu gibi bırakılır.
  3. İçe Aktarma Özeti.
    • İçe aktarma işlemi başarılı olursa yaratılanlar:
      1. Yürürlükteki dizinin altında ImportSummary.txt
      2. /lib/.importSuccess altında .importSuccess
    • İçe aktarma işlemi ikinci kez denenirse, konsolda bir ileti görüntülenir. 
      Kaynak bir HOD sunucusundaki dosyalar hedefe zaten geçirildi. C:\lib\.importSuccess. HOD geçiş işlemi sonlandırıldı
    • ImportSummary.txt, kaynaktan hedefe (içe) aktarılan dosyalara ilişkin bir rapor içerir.
  4. Geriye işleme
    • İçe aktarma işleminde herhangi bir hata/kural dışı durum oluşursa ya da anormal bir durum saptanırsa, geriye işleme otomatik olarak çalışır.
    • Geriye işleme yürürlükteki hedef sunucu için gerçekleştirilir. Hedeften hangi yedeklemeler yaratıldıysa, bu dosyaların tümü önceki durumlarına geri çevrilir.
    • İçe aktarma işlemi yürürlükteki dizinde Rollback.xml dosyasını yaratır. Konsolda bir ileti görüntülenir. 
      Geriye işleme gerçekleştirmek için yürürlükteki dizinde geriye işleme dosyası yaratıldı. C:\Test\Rollback.xml
    • lib klasöründe .rollback dosyası yaratılır.
    • Oluşturulan Rollback.xml, geriye işleme işlemini çalıştırmak için bir kez kullanılır.
    • Yedekleme yapılmış olan her dizinde .checkSumTemp adlı ek bir dosya yaratılır ve /lib/ImportDirectory.txt dosyasına bir giriş eklenir. Geriye işleme tamamlandıktan sonra .checkSumTemp dosyası silinir.
    • Geriye işleme, oluşturulan rollback.xml kullanılarak el ile de çalıştırılabilir. Bu işlem, içe aktarılan tüm dosyaları yürürlükteki HOD dizininden kaldırır ve önceki durumlarına geri yükler.
    • Geriye işleme tamamlanınca, dosyanın yalnızca içeriği değil zaman damgası da değişir.
    • Başarılı bir geriye işlemeden sonra, geriye işleme işlemi /lib klasöründe .rollbackSuccess adlı bir dosya oluşturur.
    • Başarılı bir geriye işlemeden sonra geriye işleme işlemi el ile yeniden denenirse konsolda bir ileti görüntülenir.

Unutulmaması gereken noktalar

  1. Geçiş yardımcı programı çalıştırılırken Host On-Demand hizmetleri durdurulmalıdır. Geçiş tamamlandıktan sonra Host On-Demand hizmetleri yeniden başlatılmalıdır.
  2. “HODMigrationUtility.jar” dosyasını hiçbir zaman yeniden adlandırmayın.
  3. Geçişten sonra aşağıdaki ek dosyalar yaratılır. Bu dosyalar, geçiş yardımcı programının kullandığı bilgileri kaydeder. Bu dosyaları silmeyin ya da değiştirmeyin:  .rollback , .rollbackSuccess ,.importsuccess , .checksumtemp, ImportDirectory.txt 
  4. HOD kaldırma programı, Hod yayın dizininden HODMigrationUtility.jar dosyasını silmez.

Sınırlamalar

  1. Geçişten sonra, yönlendirici IP adresinin hedef makinede güncellenmesi gerekir; örneğin, dışa aktarma yönlendirici oturumlarından oluşuyorsa, geçiş yardımcı programı bu oturumların hedef adresini değiştirmez. Hedef adresini kullanıcılar el ile değiştirmelidir.
  2. Kullanıcıların oturumlarında Dinamik HTML geçersiz kılma değeri yapılandırıldıysa, bu ayarlar geçirilmez. Bu nedenle, kullanıcılar Dinamik HTML geçersiz kılmayı yapılandırdıysa, geçiş yardımcı programının çalıştırılması önerilmez.
  3. Yukarıdaki nedenden ötürü, Programlanır HOD kullanan kullanıcıların da geçiş yardımcı programını kullanması önerilmez.
  4. Özel dosyaların yeri sürücü farkı dışında aynıysa, özel dosyaların tümü birleştirilir ve tek bir dizin altına kopyalanır.

Önkoşullar

  1. Yardımcı programın çalıştırılması gereken kaynak ve hedef sistemlerde java kurulmuş ve ortam değişkeninde java yolu ayarlanmış olmalıdır.
  2. Host On-Demand'ın tüm dizinlerinin tam denetim erişimi olmalıdır; bu erişim özellikle de Windows dışı sunucular için gereklidir.
  3. Özel dosyalar paylaşılan bir dizinde ya da bir ağ yerinde bulunabilir; bu yerlerin de erişilebilir olması gerekir.
Ana başlık: Host On-Demand 'ın geçirilmesi