Migreringsfunktion

Funktionen kan bruges til migrering fra en tidligere version af HOD til en nyere version. Host On-Demand-migrering er en totrinsproces:

  1. Eksport af filerne fra HOD-kildeserveren (HOD11 eller HOD12). Processen opretter filen Migrationpackage.zip.
  2. Import af de eksporterede filer til HOD-målserveren. Denne proces vil importere filer fra Migrationpackage.zip til HOD-målserveren (HOD12 eller HOD13).

HOD-kilde- og -.målserveren kan være placeret på den samme maskine eller på hver sin maskine.

Bemærk: Hvis HOD-kilde- og målserveren er placeret på forskellige maskiner skal filen Migrationpackage.zip, der blev oprettet i eksportfunktionen, være placeret på målmaskinen. Dette er en manuel proces, som administratoren skal udføre.

Tilladte Host On-Demand-migreringsversioner og -miljøer

Host On-Demand-migreringsversioner

  1. HOD11 til HOD12
  2. HOD11 til HOD13
  3. HOD12 (tidligere version) til HOD12 (nyere version)
  4. HOD12 til HOD13

Understøttede Host On-Demand-migreringsmiljøer

  1. 1. Win 2016
  2. Win 7 - 32 bit
  3. Win 7 - 64 bit
  4. Win 2012 - 64 bit forkortet kinesisk
  5. Win 7 - japansk
  6. Win 10 Ent - 64 bit Creator-opdatering
  7. Win 2012
  8. Ubuntu - 64 bit
  9. z/OS
  10. RHEL 7.2
  11. AIX 7.2
  12. AS400 7.2

Bemærk: Eksport- og Importfunktioner understøttes kun på den samme platform (f.eks. Windows til Windows, Linux til Linux osv.)

Placering af HOD-migreringsfunktion og installation

HODMigrationUtility.zip vil være tilgængelig på Fix Central. Administratoren skal downloade zip-filen og placere den i Host On-Demand-publiceringsbiblioteket. Der er ingen anden nødvendig installation.

Tilgængelige filer i HODMigrationUtility.zip

  1. Build.ID: indholder den “buildid”, der er HOD-version og byggedato
  2. HODMigrationUtility.jar: JAR-fil til migreringsfunktion
  3. Export.xml: Inputfil til eksportfunktion
  4. Import.xml: Inputfil til importfunktion

Trin til at udføre HOD-migreringsfunktionen

  1. Pak filen HODMigrationUtility.zip ud.
  2. Revidér indholdet af filerne export.xml og import.xml efter behov. Læs “5. Eksportér og importér inputfiler” nedenfor for at forstå, hvilket input der kræves.
  3. Åbn en kommandolinje, og skift til det bibliotek, hvor HODMigrationUtility.jar er tilgængelig.

    Eksempel: cd C:\Program Files (x86)\IBM\HostOnDemand13\HOD13\HODMigrationUtility

  4. Angiv kommando til udførelse af migreringsfunktion

    Eksportfunktion: java –jar HODMigrationUtility.jar c:\Test\Export.xml

    Bemærk: Når eksporten er udført, vises en meddelelse, sammen med den placering, hvor zip-filen med migreringspakken er oprettet.

    Importfunktion: java –jar HODMigrationUtility.jar c:\Test\Import.xml

    Bemærk: Når importen er udført uden fejl, vises denne meddelelse.

    Tilbagerulningsfunktion: java –jar HODMigrationUtility.jar c:\Test\Rollback.xml

    Bemærk: Der genereres automatisk en xml-fil til tilbagerulning, når en importfunktion udføres. Tilbagerulning kan kun udføres én gang.

Inputfiler til eksport og import

Eksport:

Tabel 1. Liste over inputattributter til eksport, og hvad de betyder
Inputattribut Forklaring
migrationInput Rodbiblioteket for xml-inputfilen.
mode Denne kode angiver driftstilstanden. Input er påkrævet for denne kode. Input til denne kode skal være “export” (der skelnes ikke mellem store og små bogstaver).
HODPublishDirectory Angiver Host On-Demand-udgivelsesbibliotek

Input er påkrævet for denne kode.

Eksempel: 

<HODPublishDirectory>C:\Program Files\IBM\HostOnDemand\HOD</HODPublishDirectory>
sourceMigratingPackage Angiver placeringen, hvor zip-filen med migreringspakken skal gemmes.

Hvis parameteren ikke angives, bruges den aktuelle placering bruges til at gemme zip-filen med migreringspakken.

Eksempel: 

<migratingPackageLocation>C:\Test</migratingPackageLocation>
overWrite Input er påkrævet for denne kode.

Input “yes” (standard): Hvis migreringspakken allerede findes, overskriver funktionen den eksisterende pakke. Følgende meddelelse bliver vist.
Migreringspakke findes allerede på:
C:\Program Files (x86)\IBM\
HostOnDemand\HOD\HODMigrationUtility\MigrationPackage.zip

Migreringen overskriver den eksisterende migreringspakke.

Migreringspakken er blevet oprettet ...
C:\Program Files (x86)\IBM\
HostOnDemand11\HOD11\HODMigrationUtility\MigrationPackage.zip

Input “no”. Hvis migreringspakken allerede findes, overskriver funktionen ikke migreringspakken. I stedet bliver følgende meddelelse vist.
Migreringspakke findes allerede på... : 
C:\Program Files (x86)\IBM\
HostOnDemand\HOD\HODMigrationUtility\MigrationPackage.zip

Migreringen er afsluttet pga. den eksisterende migreringspakke.
HOD-migreringsproces er afsluttet.
customFiles customFiles er den overordnede kode for fileLocation-underkoder.

Hvis der er tilpassede filer (.kmp .bar .col .pmp .mac) gemt i andre placeringer end standardplaceringen (user/HODObjs), skal disse placeringer angives i denne kode, så filer i disse placeringer også udvælges til migrering.

Hver tilpasset filplacering skal angives i fileLocation-koden.

Eksempel: 

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

Se tabellen nedenfor for at få vist en liste med filer, der eksporteres til migreringspakken.
Tabel 2. Liste over filer, der er dækket af eksportfunktionen
Filer Placering Filer, der direkte kopieres til målmaskine Filer, der ændres af migreringsfunktion
Filer til guiden Distribution      
DW-oprettet html, z_*.html, _J2.html, .jnlp HOD-publiceringsbibliotek Nej Alle
Fuldstændig HOD-datafolder

.cf-filer

wInfo.txt

Policy.obj

Preload.obj

Params.txt

udparams.txt

 HOD-publiceringsbibliotek (HODData) Følgende filer bliver kopieret direkte til HOD-målserveren

Policy.obj

Preload.obj

Params.txt

wInfo.txt

.cf-fil

udparams.txt

Tilpassede filer      
Tilpassede standardfiler Brugerbibliotek HODObjs-folder f.eks.: C:\Users\<systembruger>\HODObjs Ja Ingen
Brugerdefinerede tilpassede filer Brugerdefineret placering (fælles eller netværksplacering) Ja (customfiles-folder oprettes og alle tilpassede filer bliver kopieret) Ingen
Filer fra privat bibliotek      
Private filer (alle filer og foldere) HOD-installationsbibliotek privat Ja Ingen
biblioteksfunktion      
Sample.xml og brugeroprettet .xml HOD-installationsbibliotek lib\samples\DirUtil Ja Ingen
Sikkerhed      
HODSerKeyDb.kdb HODServerKeyDb.sth HODServerKeyDb.rdb bin-bibliotek Ja Ingen
WellKnownTrustedCAs.class WellKnownTrustedCAs.jks WellKnownTrustedCAs.p12 HOD-publiceringsbibliotek Hvis en fil med det samme navn allerede findes, bliver den ikke kopieret til HOD-målserveren Konvertering af .p12 til jks-fil
pdfpdt-filer      
Printerdefinitionsfil: Alle filerne HOD-publiceringsbibliotek/pdfpdt Ja Ingen
Egenskabsfil      
Config.properties HOD-publiceringsbibliotek Ja Ingen
Tabel 3. Liste over inputattributter til import, og hvad de betyder
Inputattribut Forklaring
migrationInput Rodbiblioteket for xml-inputfilen.
mode Denne kode angiver driftstilstanden. Input er påkrævet for denne kode. Input til denne kode skal være “import” (der skelnes ikke mellem store og små bogstaver).
HODPublishDirectory Angiver Host On-Demand-udgivelsesbibliotek

Input er påkrævet for denne kode.

Eksempel: 

<HODPublishDirectory>C:\Program Files\IBM\
HostOnDemand\HOD</HODPublishDirectory>
migratingPackageLocation Angiver placeringen, hvor zip-filen med migreringspakken skal gemmes.

Hvis parameteren ikke angives, bruges den aktuelle placering bruges til at gemme zip-filen med migreringspakken.

Eksempel: 

<migratingPackageLocation>C:\Test</migratingPackageLocation>
systemJavaBinDirectory Angiver bin-biblioteket til Java i z/OS og AS/400

Dette kodeinput kræves kun til z/OS og AS/400.

Eksempel: 

<systemJavaBinDirectory>>/usr/lpp/javapkg/
J6.0/bin</systemJavaBinDirectory>
options options-koden er den overordnede kode til at levere input til følgende underordnede koder.

Terminal, FileTransfer, Icon, FTPTerminal, dbaOptions, targetUI

Disse koder skal angives i følgende format:

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

Ovennævnte koder er relateret til sessionsparameteren.

Sikkerhedsrelaterede parametre kan også angives for at konvertere SSL3 til JSSE TLS1.2. Dette skal angives under Terminal-koden.

Input til disse koder er nøgle og værdi i dobbelte anførselstegn. 

Eksempel: <Terminal key="LUName"
				value="abc"/>

Nøgle må ikke være NULL, værdi kan være NULL.

Disse nøgleværdipar skrives i cf-filen på målsystemet for de tilsvarende sessioner.

Hvis du vil angive mere end én sessionsparameter, skal koden gentages med et andet nøgleværdipar. Eksempel:

<Terminal key="LUName" value="abc"/>
			<Terminal key="History" value="false"/>
			<Terminal key="fontStyle" value="0"/>
targetUI HTML-filens udseende er forskellige for HOD 11 og HOD12/HOD13.

HOD12 og HOD13 har “Nimbus”-udseendet for HTML-filer.

Input “yes” (standard): Alle HTML-migreringsfilerne får Nimbus-udseendet i deres UI.

Input “no”: Bevarer kilde-UI'ens udseende for HTML-filer.
codebase Input er påkrævet for denne kode.

Denne kodebase er påkrævet for webstart-klientsider. Den URL, du angiver her, skal identificere målpubliceringsbiblioteket i Host On-Demand. Eksempel:
<codebase>http://servernavn.mycompany.com/
hodalias</codebase>

hvor servernavn.mycompany.com er navnet på den server, hvor Host On-Demand er installeret, og hodalias er publiceringsaliaset til Host On-Demand.

targetBackup Input er påkrævet for denne kode.

Input “yes” (standard): Der oprettes sikkerhedskopifil af Host On-Demand-målserverfiler. Filerne sikkerhedskopieres på Host On-Demand-målserveren, hvor importen skal udføres. Tabellen nedenfor indeholder en liste over de filer, der bliver sikkerhedskopieret.

Input “no”: Der oprettes ikke sikkerhedskopifil til migrering af Host On-Demand-serverfiler.
overwriteHODPublishDirectory Input er påkrævet for denne kode.

Input “yes” (standard): Filer med samme navn (kilde- og målfiler) vil blive overskrevet i publish-biblioteket på HOD-målserveren.

Input “no”: Filer med samme navn (kilde- og målfiler) bliver ikke overskrevet i publish-biblioteket, kun nye filer og biblioteker bliver migreret til målet.
overwritePrivate Input er påkrævet for denne kode.

Input “yes” (standard): Filer med samme navn (kilde- og målfiler) vil blive overskrevet i private-biblioteket på HOD-målserveren.

Input “no”: Filer med samme navn (kilde- og målfiler) bliver ikke overskrevet i private-biblioteket, kun nye filer og biblioteker bliver migreret til målet.
overwritePdfPdt Input er påkrævet for denne kode.

Input “yes” (standard): Filer med samme navn (kilde- og målfiler) vil blive overskrevet i pdfpdt-biblioteket på HOD-målserveren.

Input “no”: Filer med samme navn (kilde- og målfiler) bliver ikke overskrevet i pdfpdt-biblioteket, kun nye filer og biblioteker bliver migreret til målet.
overwriteDirUtil Input er påkrævet for denne kode.

Input “yes” (standard): Filer med samme navn (kilde- og målfiler) vil blive overskrevet i DirUtil-biblioteket på HOD-målserveren.

Input “no”: Filer med samme navn (kilde- og målfiler) bliver ikke overskrevet i DirUtil-biblioteket, kun nye filer og biblioteker bliver migreret til målet.
Tabel 4. Liste over filer i det målbibliotek, der skal sikkerhedskopieres
Folder Filer
Privat bibliotek Alle filer og biblioteker
Bin-bibliotek HODServerKeyDb.kdb, HODServerKeyDb.sth, HODServerKeyDb.rdb, HODServerKeyStore.jks
HOD-publish-bibliotek->pdfpdt Printerdefinitionfil
HOD-publish-bibliotek WellKnownTrustedCAs.class WellKnownTrustedCAs.jks WellKnownTrustedCAs.p12 CustomizedCAs.p12 CustomizedCAs.jks CustomizedCAs.sth Config.properties Filer fra Deployment Wizard
lib-folder redir.properties
lib\samples\DirUtil Alle filer
HostOnDemand\HOD\HODData Alle foldere og filer

Baggrundsoplysninger om importfunktion

  1. Tilpassede filer (både standard og dem, der er angivet i eksport-xml) bliver importeret.
    • Tilpasset filplacering: /lib/CustomFiles/
    • Standardfilplaceringen: Systembruger/admin/HODObjs/
  2. Sikkerhedsnøglelager bliver importeret, hvis det ikke findes på målet.
    • Hvis kun P12- og KDB-nøglelager findes på målet, bliver P12 og KDB fra kildesystemet konverteret til JKS.
    • Hvis målet findes består af JKS, P12 og KDB, ignorerer importen alle nøglelagrene. Nøglelageret på målet bevares intakt.
  3. Importresumé.
    • En korrekt udført importproces vil oprette:
      1. ImportSummary.txt under det aktuelle bibliotek
      2. .importSuccess under /lib/.importSuccess
    • Hvis importen er forsøgt, bliver der vist en meddelelse på konsollen.
      Filer fra en kilde-HOD-server er allerede migreret til målet. C:\lib\.importSuccess. HOD-migreringsproces er afsluttet.
    • ImportSummary.txt indeholder en rapport over importerede filer fra kilde til mål.
  4. Tilbagerulning
    • Hvis der er fejl/undtagelser i importprocessen, eller en unormal tilstand opstår, foretages der automatisk en tilbagerulning.
    • Der bliver udført tilbagerulning for den aktuelle målserver. De filer, der var sikkerhedskopieret på målet, bliver returneret til deres foregående tilstand.
    • Importen genererer Rollback.xml i det aktuelle bibliotek. Der vises en meddelelse på konsollen. 
      Rollback-fil er oprettet i det aktuelle bibliotek til udførelse af rollback. C:\Test\Rollback.xml
    • Filen .rollback oprettes i lib-folderen.
    • Den genererede Rollback.xml bliver brugt til at udføre tilbagerulning én gang.
    • I hvert af de biblioteker, der er sikkerhedskopieret, oprettes der være en ekstra fil ved navn .checkSumTemp, og der tilføjes en indgang i /lib/ImportDirectory.txt. Når tilbagerulningen er fuldført, bliver filen .checkSumTemp slettet.
    • Tilbagerulningen kan også udføres manuelt med den genererede rollback.xml. Denne funktion fjerner alle importerede filer fra det aktuelle HOD-bibliotek og retablerer til den forrige tilstand.
    • Når tilbagerulningen er fuldført, vil både tidsstempel og indhold af filen også være ændret.
    • Efter en vellykket tilbagerulning genereres der en fil ved navn .rollbackSuccess i /lib-folderen.
    • Hvis tilbagerulning forsøges gentaget efter en vellykket tilbagerulning, vises der en meddelelse på konsollen.

At huske

  1. Host On-Demand-services skal være stoppet, mens migreringsfunktionen udføres. Når migreringen er fuldført, skal Host On-Demand-services genstartes.
  2. Omdøb aldrig “HODMigrationUtility.jar”
  3. Efter migreringen er følgende ekstra filer blevet oprettet. Dette sker for at registrere oplysninger, der skal bruges af migreringsfunktionen. Undlad at slette eller ændre følgende filer:  .rollback, .rollbackSuccess,.importsuccess, .checksumtemp, ImportDirectory.txt 
  4. En afinstallation af HOD sletter ikke HODMigrationUtility.jar fra HOD-publiceringsbiblioteket.

Begrænsninger

  1. Omdirigerings-IP skal efter migrering opdateres på målsystemet, fordi migreringsfunktionen ikke ændrer destinationsadresse for eventuelle omdirigeringssessioner i eksporten. Brugerne skal ændre destinationsadressen manuelt.
  2. Hvis brugerne har dynamisk HTML-tilsidesættelse konfigureret i deres sessioner, bliver disse indstillinger ikke migreret. Det kan derfor ikke anbefales at udføre migreringsfunktionen, hvis brugerne har konfigureret dynamisk HTML-tilsidesættelse.
  3. Brugere, der anvender programmérbar HOD, anbefales af samme grund heller ikke at udføre migreringsfunktionen.
  4. Hvis placeringen af tilpassede filer er identisk bortset fra drevet, vil alle tilpassede filer efter import være flettet og kopieret til samme bibliotek.

Forudsætninger

  1. Kilde- og målsystemer, hvor funktionen skal udføres, skal have installeret Java, og Java-stien skal være angivet i systemvariablen.
  2. Der skal være fuld adgang til alle biblioteker i Host On-Demand. Det gælder særlig for ikke-Windows-servere.
  3. Hvis de tilpassede filer findes i et fælles bibliotek eller på en netværksplacering, skal der også være adgang til disse placeringer.
Overordnet emne: Migrering af Host On-Demand