Préparation de la migration dans InfoSphere Information Server (Linux, AIX)

Avant d'exporter des données de InfoSphere Information Server vers Cloud Pak for Data, effectuez un ensemble de tâches de configuration.

Avant de commencer

Pour effectuer ces tâches, vous devez être connecté au noeud InfoSphere Information Server en tant que root.

Vérifiez également que les prérequis répertoriés dans Prérequis à la migration des données sont remplis.

Tâches à effectuer sur le système InfoSphere Information Server avant la migration

Effectuez les tâches suivantes dansInfoSphere Information Server avant d'exporter vos données et processus de migration :
  1. Paramétrage des variables d'environnement
  2. Installation des outils requis
  3. Augmentation du délai d'expiration du jeton CSRF
  4. Retrait d'utilisateurs non valides
  5. Affectation du rôle Utilisateur de la suite à des utilisateurs ayant des rôles hérités
  6. Octroi de l'accès à tous les projets de qualité de données
  7. Amélioration des performances d'exportation
  8. Installation du kit d'outils de migration
  9. Exécution du script d'initialisation
  10. Vérification de l'intégrité des données
  11. Augmentation de la valeur du délai d'attente pour le jeton LTPA
  12. Installation des progiciels requis
  13. Création d'un fichier de configuration db2dsdriver.cfg
  14. Détermination de la portée de l'exportation

Paramétrage des variables d'environnement

Procédez comme suit. Suivez les instructions pour votre système d'exploitation :

  1. Connectez-vous au noeud InfoSphere Information Server en tant que root.
  2. Ouvrez un interpréteur de commandes bash:
    bash
  3. Définissez les variables d'environnement ci-dessous.
    IIS_INSTALL_PATH=<IIS installation path>
IIS_HOST=<IIS host>
IIS_PORT=<IIS port>
IIS_USERNAME=<IIS username>
IIS_PASSWORD=<IIS password>
TOOLKIT_PATH=<directory for storing the toolkit content; the directory must not be under the /root path>

    Exemple IIS_INSTALL_PATH : si InfoSphere Information Server est installé dans l'emplacement par défaut, définissez la variable IIS_INSTALL_PATH sur la valeur /opt/IBM/InformationServer.

Installation des outils requis

Téléchargez et installez les outils requis pour votre système d'exploitation en tant qu'utilisateur root . Effectuez les étapes qui s'appliquent à votre système d'exploitation.

Red Hat® Enterprise Linux

Installez l'utilitaire jq .

  1. Passez dans le répertoire ${TOOLKIT_PATH}.
    cd ${TOOLKIT_PATH}
  2. Pour installer l'utilitaire, exécutez les commandes suivantes:
    curl -LO https://github.com/jqlang/jq/releases/download/jq-1.7.1/jq-linux-i386
chmod +x ./jq-linux-i386
cp jq-linux-i386 jq
AIX

Installez les utilitaires wget, curl, jqet dos2unix . Exécutez ensuite l'outil dos2unix pour convertir le fichier database.properties au format requis.

  1. Passez dans le répertoire ${TOOLKIT_PATH}.
    cd ${TOOLKIT_PATH}
  2. Pour installer les utilitaires, exécutez les commandes suivantes:
    dnf install wget -y
dnf install curl -y
dnf install jq -y
dnf install dos2unix -y
dos2unix ${IIS_INSTALL_PATH}/ASBServer/conf/database.properties
SUSE Linux

Installez l'utilitaire jq .

  1. Passez dans le répertoire ${TOOLKIT_PATH}.
    cd ${TOOLKIT_PATH}
  2. Pour installer l'utilitaire, exécutez les commandes suivantes:
    zypper install jq
Red Hat Linux on System z

Installez l'utilitaire jq .

  1. Passez dans le répertoire ${TOOLKIT_PATH}.
    cd ${TOOLKIT_PATH}
  2. Pour installer l'utilitaire, exécutez les commandes suivantes:
    curl -LO https://github.com/jqlang/jq/releases/download/jq-1.7/jq-linux-s390x
chmod +x ./jq-linux-s390x
cp jq-linux-s390x jq

Augmentation du délai d'expiration du jeton CSRF

Augmentez le délai d'expiration du jeton CSRF. Exécutez les commandes qui s'appliquent à votre environnement.

  1. Définissez le délai d'expiration sur 600 secondes en exécutant la commande suivante:
    ${IIS_INSTALL_PATH}/ASBServer/bin/iisAdmin.sh -set -key com.ibm.iis.isf.security.CsrfTokenExpiryTime -value 600
  2. Confirmez le paramètre en exécutant la commande suivante:
    ${IIS_INSTALL_PATH}/ASBServer/bin/iisAdmin.sh -d  | grep com.ibm.iis.isf.security.CsrfTokenExpiryTime

Suppression des utilisateurs non valides

Supprimez tous les utilisateurs non valides du registre d'utilisateurs. Exécutez les commandes qui s'appliquent à votre environnement.

  1. Obtenez la liste des utilisateurs non valides.
    ${IIS_INSTALL_PATH}/ASBServer/bin/DirectorySync.sh -url https://${IIS_HOST}:${IIS_PORT}  -user ${IIS_USERNAME} -password ${IIS_PASSWORD}  -giu
  2. Supprimez tous les utilisateurs renvoyés à l'étape précédente. Transmettez les noms d'utilisateur sous forme de liste délimitée par des tilde au script DirectorySync.sh . Si les entrées à supprimer sont des noms de domaine complets longs, placez chaque nom d'utilisateur entre guillemets (").
    ${IIS_INSTALL_PATH}/ASBServer/bin/DirectorySync.sh -user ${IIS_USERNAME} -password ${IIS_PASSWORD} -url https://${IIS_HOST}:${IIS_PORT} -delete_user_ids user1~user2~…userN

Affectation du rôle Utilisateur de la suite à des utilisateurs ayant des rôles hérités

Affectez le rôle Utilisateur de la suite à tous les utilisateurs qui n'ont pas de rôles de sécurité affectés directement mais qui héritent des rôles des groupes dont ils font partie.

Exécutez les commandes qui s'appliquent à votre environnement.

  1. Obtenir la liste des utilisateurs sans affectation directe de rôle:
    ${IIS_INSTALL_PATH}/ASBServer/bin/UsersSync.sh -url https://${IIS_HOST}:${IIS_PORT}  -user ${IIS_USERNAME} -password ${IIS_PASSWORD} -list USERS
  2. Affectez le rôle Utilisateur de la suite aux utilisateurs renvoyés à l'étape précédente:
    ${IIS_INSTALL_PATH}/ASBServer/bin/UsersSync.sh -url https://${IIS_HOST}:${IIS_PORT}  -user ${IIS_USERNAME} -password ${IIS_PASSWORD} -list USERS -sync

Octroi de l'accès à tous les projets de qualité de données

Accordez l'accès à tous les projets de qualité de données. Exécutez les commandes qui s'appliquent à votre environnement.

${IIS_INSTALL_PATH}/ASBServer/bin/iisAdmin.sh -set -key com.ibm.iis.ia.server.accessAllProjects -value true
${IIS_INSTALL_PATH}/ASBServer/bin/iisAdmin.sh -set -key com.ibm.iis.ismigration -value true

Amélioration des performances d'exportation

Pour améliorer les performances de la migration lors de l'exportation, procédez comme suit: root.

  1. Créez des index supplémentaires dans le référentiel de métadonnées. Procédez comme suit en fonction de l'emplacement où votre référentiel de métadonnées est hébergé. Ces étapes doivent être effectuées au niveau des services InfoSphere Information Server:
    Référentiel de métadonnées sur Db2
    Exécutez les commandes xmetaAdmin suivantes :
    cd ${IIS_INSTALL_PATH}/ASBServer/bin
./xmetaAdmin.sh addIndex -model ASCLModel -class DataFileFolder importedVia_DataConnection ASC -dbfile ../conf/database.properties
./xmetaAdmin.sh addIndex -model ASCLModel -class DataConnection accesses_DataStore ASC -dbfile ../conf/database.properties
./xmetaAdmin.sh addIndex -model DataStageX -class DSDataConnection accesses_DataStore ASC -dbfile ../conf/database.properties
./xmetaAdmin.sh addIndex -model ASCLModel -class DataCollection of_PhysicalModel ASC -dbfile ../conf/database.properties
./xmetaAdmin.sh addIndex -model ASCLLogicalModel -class Relationship of_LogicalModel ASC -dbfile ../conf/database.properties
./xmetaAdmin.sh addIndex -model ASCLModel -class HostSystem name ASC -dbfile ../conf/database.properties
./xmetaAdmin.sh addIndex -model ASCLModel -class Connector hostedBy_HostSystem ASC -dbfile ../conf/database.properties
./xmetaAdmin.sh addIndex -model ASCLModel -class Connector connectionType ASC -dbfile ../conf/database.properties
./xmetaAdmin.sh addIndex -model ASCLModel -class DataConnection usedBy_Connector ASC -dbfile ../conf/database.properties
./xmetaAdmin.sh addIndex -model DataStageX -class DSDataConnection usedBy_Connector ASC -dbfile ../conf/database.properties
    Référentiel de métadonnées sur Oracle
    Exécutez la commande suivante :
    CREATE INDEX IDX2102100719410 ON investigateDtQltyDmnsn (OFDATAQUALITYCONFIGURATIONXMET ASC, XMETA_REPOS_OBJECT_ID_XMETA ASC, HAS_BENCHMARK_XMETA ASC, IGNORED_XMETA ASC, WEIGHT_XMETA ASC);
CREATE INDEX IDX2102100926320 ON issMstrDtFldrfFrmDtFld (DATAFIELD_XMETA ASC);
CREATE INDEX IDX2102100927200 ON investigateDatQltyRslt (FROM_EXECUTIONHISTORY_XMETA ASC, NBRECORDSTESTED_XMETA ASC, XMETA_REPOS_OBJECT_ID_XMETA ASC);
CREATE INDEX IDX2102100927180 ON ASCLAnalysisQultyPrblm (FROM_DATAQUALITYRESULT_XMETA ASC, NBOCCURRENCES_XMETA ASC, XMETA_REPOS_OBJECT_ID_XMETA ASC);
CREATE INDEX IDX2102100927560 ON investigateExectnHstry (OF_QUALITYCOMPONENT_XMETA ASC, STATUS_XMETA ASC, STARTTIME_XMETA ASC, XMETA_REPOS_OBJECT_ID_XMETA ASC, HAS_EXECUTIONRESULT_XMETA ASC);
CREATE INDEX IDX2102100928040 ON investigatQltyPrblmTyp (CODE_XMETA ASC, DESCRIPTION_XMETA ASC, NAME_XMETA ASC);
CREATE INDEX IDX2102100925570 ON investigateRuleCompnnt (OF_ANALYSISPROJECT_XMETA ASC, SHORTDESCRIPTION_XMETA ASC, NAME_XMETA ASC, XMETA_REPOS_OBJECT_ID_XMETA ASC);
CREATE INDEX IDX2102100734290 ON ASCLAnalysisClassifctn (METHOD_XMETA ASC, STATE_XMETA DESC);
CREATE INDEX IDX2102100734240 ON ASCLAnalysisClassifctn (STATE_XMETA ASC, METHOD_XMETA DESC);
CREATE INDEX IDX2102100734490 ON investigtClmnnlyssMstr (PROJECTRID_XMETA ASC, XMETA_REPOS_OBJECT_ID_XMETA ASC, TABLEANALYSISMASTER_XMETA ASC);
CREATE INDEX IDX2102100735000 ON ArfFrmrgntdFrmClssfctn (ORIGINATEDFROMCLASSIFICATINXMT ASC);
CREATE INDEX IDX2102100735420 ON ASCLAnalysis_DataClass (NAME_XMETA ASC, XMETA_REPOS_OBJECT_ID_XMETA ASC);
CREATE INDEX IDX2102100736020 ON ASCLAnalysisClassifctn (STATE_XMETA ASC, XMETA_REPOS_OBJECT_ID_XMETA ASC, VALUEFREQUENCY_XMETA ASC);
CREATE INDEX IDX2102100735470 ON investigtClmnnlyssMstr (PROJECTRID_XMETA ASC, TABLEANALYSISMASTER_XMETA ASC, XMETA_REPOS_OBJECT_ID_XMETA ASC);
CREATE INDEX IDX2102100738180 ON investigateExectnHstry ("OF_QUALITYCOMPONENT_XMETA" ASC, "STARTTIME_XMETA" DESC);
CREATE INDEX IDX2102100736090 ON investigateRuleCompnnt ("OF_ANALYSISPROJECT_XMETA" ASC, "NAME_XMETA" ASC, "XMETA_REPOS_OBJECT_ID_XMETA" ASC);
CREATE INDEX IDX2102100741130 ON investigateDatQltyRslt ("FROM_EXECUTIONHISTORY_XMETA" ASC, "XMETA_REPOS_OBJECT_ID_XMETA" ASC);
CREATE INDEX IDX2102100744410 ON investgtClmnDtTypSmmry (COLUMNANALYSISRESULTS_XMETA ASC, RECORDPERCENT_XMETA ASC, RECORDCOUNT_XMETA ASC, DATATYPE_XMETA ASC);
CREATE INDEX "IDX2102100653330" ON investgtClmnnlyssRslts("COLUMNANALYSISMASTER_XMETA" ASC, "RECORDCOUNT_XMETA" DESC);
CREATE INDEX "IDX2102100653560" ON ASCLModel_DataFile("HOSTEDBY_HOSTSYSTEM_XMETA" ASC, "PATH_XMETA" ASC, "NAME_XMETA" ASC, "XMETA_REPOS_OBJECT_ID_XMETA" ASC);
CREATE INDEX IDX2102100659300 ON investigtClmnnlyssMstr (TABLEANALYSISMASTER_XMETA ASC, COLUMNPROPERTIES_XMETA ASC, XMETA_REPOS_OBJECT_ID_XMETA ASC);
CREATE INDEX "IDX2102100657460" ON investigateTblPKCnddts ("OF_TABLEANALYSISMASTER_XMETA" ASC, "XMETA_REPOS_OBJECT_ID_XMETA" ASC, "CANDIDATEFLAG_XMETA" ASC,"SELECTED_XMETA" ASC, "INFERRED_XMETA" ASC);
CREATE INDEX "IDX2102100704290" ON investigatTblnlyssMstr ("ANALYSISMASTER_XMETA" ASC, "TABLEANALYSISSTATUS_XMETA" ASC, "XMETA_REPOS_OBJECT_ID_XMETA" ASC);
CREATE INDEX "IDX2102100704280" ON iDtCllctnrfFrmDtCllctn("DATACOLLECTION_XMETA" ASC);
CREATE INDEX "IDX2102100706510" ON investigateTblPKCnddts("OF_TABLEANALYSISMASTER_XMETA" ASC, "SELECTED_XMETA" ASC, "REJECTED_XMETA" ASC);
CREATE INDEX "IDX2102100709420" ON ASCLModel_Annotation("NOTELABEL_XMETA" ASC, "OF_COMMONOBJECT_XMETA" DESC);
CREATE INDEX "IDX2102100708160" ON ASCLRules_RuleVariable("FROM_RULE_XMETA" ASC, "XMETA_REPOS_OBJECT_ID_XMETA" ASC, "DEFAULT_RULEBINDING_XMETA" ASC);
CREATE INDEX "IDX2102100708310" ON investigateRuleCompnnt ("OF_ANALYSISPROJECT_XMETA" ASC, "XMETA_REPOS_OBJECT_ID_XMETA" DESC);
CREATE INDEX "IDX2102100713390" ON investigateAnalyssptns ("OF_ANALYSISSUITE_XMETA" ASC, "USEAUTOMATICDATAQLTYCNFGRTNXMT" DESC);
CREATE INDEX "IDX2102100715420" ON investigateTblPKCnddts("SELECTED_XMETA" ASC, "COLUMNANALYSISMASTER_XMETA" ASC, "XMETA_REPOS_OBJECT_ID_XMETA" ASC);
CREATE INDEX "IDX2102100716030" ON investigateKeyComponnt ("OF_TABLEPKCANDIDATE_XMETA" ASC, "USESCOLUMNANALYSISMASTERXMETA" DESC);
CREATE INDEX "IDX2102100717450" ON investigateAnalyssptns ("UNIQUENESSTHRESHOLD_XMETA" ASC, "OF_ANALYSISSUITE_XMETA" DESC);
CREATE INDEX "IDX2102100717410" ON investigateAnalyssptns("UNIQUENESSTHRESHOLD_XMETA" ASC, "OF_ANALYSISPROJECT_XMETA" DESC);
CREATE INDEX "IDX2102100717390" ON investigateAnalyssptns("UNIQUENESSTHRESHOLD_XMETA" ASC, "OF_TABLEANALYSISMASTER_XMETA" DESC);
CREATE INDEX "IDX2102100716190" ON investigateAnalyssptns("OF_COLUMNANALYSISMASTER_XMETA" ASC, "OF_TABLEANALYSISMASTER_XMETA" ASC, "OF_ANALYSISPROJECT_XMETA" ASC, "OF_ANALYSISMASTER_XMETA" ASC, "OF_ANALYSISSUITE_XMETA" ASC);
CREATE INDEX "IDX2102100733120" ON ASCLRules_RuleBinding ("FROM_RULEEXECUTABLE_XMETA" ASC, "XMETA_REPOS_OBJECT_ID_XMETA" ASC, "BINDS_RULEVARIABLE_XMETA" ASC);
CREATE INDEX "IDX2102100730040" ON investigatentgrDstrbtn ("VALUE_XMETA" ASC, "OFRULESETEXECUTIONRESULTXMETA" ASC, "ABSOLUTEFREQUENCY_XMETA" ASC, "FREQUENCY_XMETA" ASC) ;
CREATE INDEX IDX2312060847540 ON investigatTblQltynlyss (OF_TABLEANALYSISMASTER_XMETA ASC, XMETA_REPOS_OBJECT_ID_XMETA DESC);
CREATE INDEX IDX2312060848270 ON investigateExectnHstry (OF_QUALITYCOMPONENT_XMETA ASC, ENDTIME_XMETA ASC, STARTTIME_XMETA ASC, HAS_EXECUTIONRESULT_XMETA ASC);
  2. Procédez comme suit en fonction de l'emplacement où votre référentiel de métadonnées est hébergé. Ces étapes doivent être effectuées sur le niveau de référentiel de métadonnées InfoSphere Information Server .
    Référentiel de métadonnées sur Db2

    1. Réglez la variable d'environnement suivante :

      DB2_INSTANCE_NAME=<db2-instance-name>
    2. Accédez à l'utilisateur de l'instance Db2 , définissez des variables d'environnement et connectez-vous au référentiel de métadonnées:
      su ${DB2_INSTANCE_NAME}
. ~/sqllib/db2profile
DB2_INSTANCE_NAME=<db2-instance-name>
XMETA_SCHEMA_NAME=<xmeta-schema-name>
db2 connect to xmeta
    3. Créez les index:
      db2 "CREATE INDEX ${DB2_INSTANCE_NAME}.IDX2312060847540 ON ${XMETA_SCHEMA_NAME}.INVESTIGATE_TABLEQUALITYANALYSIS ( OF_TABLEANALYSISMASTER_XMETA ASC, XMETA_REPOS_OBJECT_ID_XMETA DESC) ALLOW REVERSE SCANS COLLECT SAMPLED DETAILED STATISTICS"
db2 "CREATE INDEX ${DB2_INSTANCE_NAME}.IDX2312060848270 ON ${XMETA_SCHEMA_NAME}.INVESTIGATE_EXECUTIONHISTORY ( OF_QUALITYCOMPONENT_XMETA ASC, ENDTIME_XMETA ASC, STARTTIME_XMETA ASC, HAS_EXECUTIONRESULT_XMETA ASC) ALLOW REVERSE SCANS COLLECT SAMPLED DETAILED STATISTICS"
db2 "CREATE UNIQUE INDEX ${DB2_INSTANCE_NAME}.IDX2312060848320 ON ${XMETA_SCHEMA_NAME}.INVESTIGATE_TABLEANALYSISMASTER ( XMETA_REPOS_OBJECT_ID_XMETA ASC ) INCLUDE ( TABLEANALYSISSTATUS_XMETA , ANALYSISMASTER_XMETA ) ALLOW REVERSE SCANS COLLECT SAMPLED DETAILED STATISTICS"
db2 "CREATE INDEX ${DB2_INSTANCE_NAME}.IDX2312060848360 ON ${XMETA_SCHEMA_NAME}.INVESTIGATE_TABLEANALYSISMASTER_DATACOLLECTION_REFFROM_DATACOLLECTION (DATACOLLECTION_XMETA ASC) ALLOW REVERSE SCANS COLLECT SAMPLED DETAILED STATISTICS"
db2 "CREATE UNIQUE INDEX ${DB2_INSTANCE_NAME}.IDX2312060848530 ON ${XMETA_SCHEMA_NAME}.INVESTIGATE_TABLEANALYSISSTATUS (XMETA_REPOS_OBJECT_ID_XMETA ASC) INCLUDE (DATAQUALITYANALYSISDATE_XMETA, DATAQUALITYANALYSISSTATUS_XMETA) ALLOW REVERSE SCANS COLLECT SAMPLED DETAILED STATISTICS"
db2 "COMMIT"
    4. Mettez à jour les statistiques du système de gestion de base de données pour toutes les tables du référentiel de métadonnées avant de commencer la migration.
      db2 -x "SELECT 'runstats on table',substr(rtrim(tabschema)||'.'||rtrim(tabname),1,50),' and indexes all;' FROM SYSCAT.TABLES WHERE (type = 'T') AND (tabschema = '${XMETA_SCHEMA_NAME}')" > /tmp/runstats_xmeta.out
db2 -tvf /tmp/runstats_xmeta.out
    5. Quittez le compte du propriétaire de l'instance Db2 :
      exit
    Référentiel de métadonnées sur Oracle
    Mettez à jour les statistiques du système de gestion de base de données pour votre référentiel de métadonnées après la création des index avec l'aide d'un administrateur de base de données.
    1. Connectez-vous au niveau référentiel avec les données d'identification root .
    2. Connectez-vous à SQL* Plus en tant qu'utilisateur système Oracle :
      sqlplus xmeta-schema-name/password@oracle_sid
      Si cette commande renvoieCommand not found, effectuez les étapes suivantes avant de passer à l'étape 2.c:
      1. Localisez le répertoire de base Oracle et ajoutez-le à la variable PATH .
        
export ORACLE_HOME=<oracle home directory> 
export PATH=$ORACLE_HOME/bin:$PATH
      2. Réexécutez la commande de connexion à SQL* Plus.
    3. Définissez une variable de substitution XMETA_SCHEMA_NAME. Remplacez <xmeta-schema-name> par le nom de schéma du référentiel de métadonnées dans votre environnement:
      DEFINE XMETA_SCHEMA_NAME=<xmeta-schema-name>
    4. Exécutez la commande suivante :
      EXEC DBMS_STATS.GATHER_SCHEMA_STATS(ownname => '&&XMETA_SCHEMA_NAME')
    Remarque: Il est recommandé de mettre à jour les statistiques du SGBD pour toutes les tables du référentiel de métadonnées avant de démarrer la migration.
  3. Créez des index supplémentaires pour les actifs de données dans les projets de qualité de données. Suivez les instructions du document d'assistance Indices pour l'amélioration des performances lors de la migration de InfoSphere Information Server vers IBM Knowledge Catalog.

Installation du kit d'outils de migration

Installez le kit d'outils de migration.

  1. Téléchargez le kit d'outils de migration pour InfoSphere Information Server dans le répertoire ${TOOLKIT_PATH} . Suivez les instructions de cette page de support:

    Migration d'IBM InfoSphere Server vers IBM Knowledge Catalog: Application des correctifs et du toolkit à l'installation d'IBM InfoSphere Server 11.7.1.x (Partie 1 de 2)

    Ce document est mis à jour lorsqu'une nouvelle version du kit d'outils de migration est publiée et contient également des informations sur les correctifs prérequis que vous devrez peut-être installer.

  2. Définissez la version du kit d'outils et accédez au répertoire ${TOOLKIT_PATH} .
    TOOLKIT_VERSION=<toolkit version>
cd $TOOLKIT_PATH
  3. Extrayez le fichier téléchargé dans le répertoire ${TOOLKIT_PATH} .

    Sous Linux, exécutez la commande suivante:

    tar -zxvf iis-migration-toolkit-${TOOLKIT_VERSION}.tar.gz -C ${TOOLKIT_PATH}

    Sous AIX, exécutez la commande suivante :

    gunzip -c iis-migration-toolkit-${TOOLKIT_VERSION}.tar.gz | tar -xvf -

Exécution du script d'initialisation

Exécutez le init_migration_iis.sh script. Le script est téléchargé dans le cadre du kit d'outils de migration et se trouve dans le répertoire TOOLKIT_PATH .

  1. Exécutez le script en tant qu'utilisateur root :
    ${TOOLKIT_PATH}/migration/iis/init_migration_iis.sh "$IIS_INSTALL_PATH"
  2. Accordez à l'utilisateur wkc le droit d'écriture et d'exécution sur le répertoire ${TOOLKIT_PATH} . Suivez les instructions pour votre système d'exploitation :
    Red Hat Enterprise Linux

    Exécutez la commande suivante :

    setfacl -m u:wkc:rwx ${TOOLKIT_PATH}
    AIX
    Procédez comme suit :
    1. Définissez l'éditeur pour éditer les informations de contrôle d'accès.
      export EDITOR=/usr/bin/vi
    2. Modifiez les informations de contrôle d'accès pour le répertoire ${TOOLKIT_PATH} .
      acledit ${TOOLKIT_PATH}
      Ajoutez l'entrée suivante et sauvegardez les informations:
      extended permissions
    enabled
    permit rwx u:wkc
    3. Modifiez les informations de contrôle d'accès pour le répertoire /tmp .
      acledit /tmp
      Ajoutez l'entrée suivante et sauvegardez les informations:
      extended permissions
    enabled
    permit rwx u:wkc
    SUSE Linux
    Exécutez la commande suivante :
    zypper install acl
setfacl -m u:wkc:rwx ${TOOLKIT_PATH}
setfacl -m u:wkc:rwx /tmp
  3. Définissez le chemin d'accès au répertoire de données d'exportation et accordez à l'utilisateur wkc le droit d'accès en écriture à ce répertoire:
    1. Définissez la variable d'environnement EXPORT_DATA_DIR :
      EXPORT_DATA_DIR=<path to the export data directory>
    2. Accordez à l'utilisateur wkc le droit d'écriture et d'exécution sur le répertoire ${EXPORT_DATA_DIR} . Suivez les instructions pour votre système d'exploitation :
      Red Hat Enterprise Linux

      Exécutez la commande suivante :

      setfacl -m u:wkc:rwx ${EXPORT_DATA_DIR}
      AIX
      Procédez comme suit :
      1. Définissez l'éditeur pour éditer les informations de contrôle d'accès.
        export EDITOR=/usr/bin/vi
      2. Modifiez les informations de contrôle d'accès pour le répertoire ${EXPORT_DATA_DIR} .
        acledit ${EXPORT_DATA_DIR}
        Ajoutez l'entrée suivante et sauvegardez les informations:
        extended permissions
    enabled
    permit rwx u:wkc
      SUSE Linux
      Exécutez la commande suivante :
      setfacl -m u:wkc:rwx ${EXPORT_DATA_DIR}

Vérification de l'intégrité des données

Pour vérifier l'intégrité des données dans InfoSphere Information Server, exécutez l'outil ISALite en tant qu'utilisateur root .

Important: Si InfoSphere Information Server n'est pas installé dans le chemin par défaut, vous devez mettre à jour le fichier de réponses ${TOOLKIT_PATH}/migration/iis_scripts/isalite_adt_mr_response_11714.txt (pour InfoSphere Information Server 11.7.1.4) ou le fichier de réponses ${TOOLKIT_PATH}/migration/iis_scripts/isalite_adt_mr_response.txt (pour InfoSphere Information Server 11.7.1.5) avant d'exécuter l'outil ISALite . Assurez-vous que fieldTask.IS.root est défini sur le chemin d'installation correct.
Exécutez la commande suivante :
${TOOLKIT_PATH}/migration/iis_scripts/run_IIS_ISALite.sh ${IIS_INSTALL_PATH}

L'outil prendra un certain temps pour traiter les données et générer un rapport. Ce rapport est stocké dans le sous-répertoire ISA_XMetHC_localhost_EngServ_${timestamp} du répertoire en cours.

Ouvrez le fichier de rapport XMETAHealthChecker.html dans un navigateur et examinez les résultats et les instructions qu'il contient. Vérifiez qu'aucune erreur ne s'est produite et que toutes les vérifications affichent le statut SUCCESS.

Augmentation de la valeur de délai d'attente pour le jeton LTPA

Pour vous assurer que la session peut être actualisée sans aucun problème, augmentez la valeur du délai d'attente pour le jeton LTPA.

Pour WebSphere Application Server Liberty
Procédez comme suit :
  1. Éditez le fichier ${IIS_INSTALL_PATH}/wlp/usr/servers/iis/server.xml.
  2. Recherchez l'entrée <ltpa expiration="795m"/> et mettez à jour cette valeur d'expiration avec un nombre plus élevé. Remplacez-la par 1440m, qui correspond à 24 heures, ou par 2880m, qui correspond à 48 heures.
  3. Redémarrez le serveur d'applications. Effectuez les étapes qui s'appliquent à votre système d'exploitation.
    1. Arrêtez le serveur d'applications :
      ${IIS_INSTALL_PATH}/ASBServer/bin/MetadataServer.sh stop
    2. Démarrez le serveur d'applications :
      ${IIS_INSTALL_PATH}/ASBServer/bin/MetadataServer.sh run
Pour WebSphere Application Server Network Deployment
Procédez comme suit :
  1. Connectez-vous à la console d'administration du serveur d'applications WebSphere .
  2. Allez dans Sécurité > Sécurité globale > LTPA > LTPA timeout.
  3. Augmentez la valeur du délai d'attente. Remplacez-la par 1440m, qui correspond à 24 heures, ou par 2880m, qui correspond à 48 heures.
  4. Cliquez sur Appliquer, D'ACCORD, et Sauvegarder.
  5. Redémarrez le serveur d'applications. Suivez les instructions qui s'appliquent à votre système d'exploitation.
    installation autonome
    1. Arrêtez le serveur d'applications :
      ${IIS_INSTALL_PATH}/ASBServer/bin/MetadataServer.sh stop
    2. Démarrez le serveur d'applications :
      ${IIS_INSTALL_PATH}/ASBServer/bin/MetadataServer.sh run
    Installation en cluster
    1. Arrêtez le cluster comme décrit dans WebSphere Application Server Network Deployment : Arrêt des clusters.
    2. Démarrez le cluster comme décrit dans WebSphere Application Server Network Deployment : Démarrage des clusters.

Installation des progiciels requis

Téléchargez et installez le package IBM Semeru Runtimes. Suivez les instructions relatives à votre système d'exploitation.

Red Hat Enterprise Linux

Procédez comme suit :

  1. Accédez à l'utilisateur wkc et ouvrez un interpréteur de commandes bash:
    su wkc
bash
  2. Accédez au répertoire dans lequel le contenu du kit d'outils est stocké:
    TOOLKIT_PATH=<toolkit_path>
cd $TOOLKIT_PATH
  3. Téléchargez et installez l' IBM Semeru Runtimes OpenJDK 17.
    Téléchargez et installez jdk-17.0.9:
    curl -LO https://github.com/ibmruntimes/semeru17-binaries/releases/download/jdk-17.0.9%2B9_openj9-0.41.0/ibm-semeru-open-jdk_x64_linux_17.0.9_9_openj9-0.41.0.tar.gz
    tar -zxvf ibm-semeru-open-jdk_x64_linux_17.0.9_9_openj9-0.41.0.tar.gz
  4. Définissez le chemin d'accès de sorte qu'il pointe vers le kit IBM JDK 17 java installé dans les étapes précédentes.
    export PATH=${TOOLKIT_PATH}/jdk-17.0.9+9/bin:${TOOLKIT_PATH}:$PATH
AIX

Procédez comme suit :

  1. Passez à l'utilisateur wkc :
    su wkc
  2. Accédez au répertoire dans lequel le contenu du kit d'outils est stocké:
    TOOLKIT_PATH=<toolkit_path>
cd $TOOLKIT_PATH
  3. Téléchargez et installez l' IBM Semeru Runtimes OpenJDK 17.
    curl -LO https://github.com/ibmruntimes/semeru17-binaries/releases/download/jdk-17.0.9%2B9_openj9-0.41.0/ibm-semeru-open-jdk_ppc64_aix_17.0.9_9_openj9-0.41.0.tar.gz
    gunzip -c ibm-semeru-open-jdk_ppc64_aix_17.0.9_9_openj9-0.41.0.tar.gz | tar -xvf -
  4. Définissez le chemin d'accès de sorte qu'il pointe vers le kit IBM JDK 17 java installé dans les étapes précédentes.
    export PATH=${TOOLKIT_PATH}/jdk-17.0.9+9/bin:${TOOLKIT_PATH}:$PATH
SUSE Linux

Procédez comme suit :

  1. Passez à l'utilisateur wkc :
    su wkc
  2. Accédez au répertoire dans lequel le contenu du kit d'outils est stocké:
    TOOLKIT_PATH=<toolkit_path>
cd $TOOLKIT_PATH
  3. Téléchargez et installez l' IBM Semeru Runtimes OpenJDK 17.
    curl -LO https://github.com/ibmruntimes/semeru17-binaries/releases/download/jdk-17.0.9%2B9_openj9-0.41.0/ibm-semeru-open-jdk_x64_linux_17.0.9_9_openj9-0.41.0.tar.gz
    tar -zxvf ibm-semeru-open-jdk_x64_linux_17.0.9_9_openj9-0.41.0.tar.gz
  4. Définissez le chemin d'accès de sorte qu'il pointe vers le kit IBM JDK 17 java installé dans les étapes précédentes.
    export PATH=${TOOLKIT_PATH}/jdk-17.0.9+9/bin:${TOOLKIT_PATH}:$PATH
Red Hat Linux on System z et SUSE Linux on System z

Procédez comme suit :

  1. Passez à l'utilisateur wkc :
    su wkc
  2. Accédez au répertoire dans lequel le contenu du kit d'outils est stocké:
    TOOLKIT_PATH=<toolkit_path>
cd $TOOLKIT_PATH
  3. Téléchargez et installez l' IBM Semeru Runtimes OpenJDK 17.
    curl -LO https://github.com/ibmruntimes/semeru17-binaries/releases/download/jdk-17.0.9%2B9_openj9-0.41.0/ibm-semeru-open-jdk_s390x_linux_17.0.9_9_openj9-0.41.0.tar.gz
    tar -zxvf ibm-semeru-open-jdk_s390x_linux_17.0.9_9_openj9-0.41.0.tar.gz
  4. Définissez le chemin d'accès de sorte qu'il pointe vers le kit IBM JDK 17 java installé dans les étapes précédentes.
    export PATH=${TOOLKIT_PATH}/jdk-17.0.9+9/bin:${TOOLKIT_PATH}:$PATH

Création d'un fichier de configuration db2dsdriver.cfg

  1. Sur leInfoSphere Information Server niveau de services, exécutez la commande suivante pour répertorier lesDb2 Connexions:
    ${IIS_INSTALL_PATH}/ASBServer/bin/xmetaAdmin.sh query -expr "select dc.name as connection_name, dc.username as user_name, dc.connectionString as database_name from connector in Connector, dc in connector->uses_DataConnection where connector.name='DB2Connector'" -dbfile ${IIS_INSTALL_PATH}/ASBServer/conf/database.properties http:///5.3/ASCLModel.ecore
    1. Vérifiez la sortie et vérifiez si les connexions Db2 sont valides et requises pour la migration.
    2. Passez à l' étape 2et aux étapes suivantes, uniquement si les connexions Db2 doivent être migrées.
  2. Connectez-vous au niveau moteur en tant qu'utilisateur de l'instance Db2 .
  3. Vérifiez si le client Db2 se trouve au niveau du moteur.
  4. Créez un fichier de configuration db2dsdriver.cfg pour la base de données Db2 sur l'hôte de niveau moteur InfoSphere Information Server et rendez le fichier de configuration disponible pour l'agent ASBNode et le service d'accès au connecteur (CAS).
    1. Définissez les variables d'environnement suivantes :
      DB2_INSTANCE_NAME=<db2-instance-name>
OUTPUT_FOLDER=<output folder>
    2. Créez et remplissez le fichier de configuration db2dsdriver.cfg en exécutant la commande suivante:
      db2dsdcfgfill -i ${DB2_INSTANCE_NAME} -o ${OUTPUT_FOLDER}
    3. Assurez-vous que le droit de lecture sur le fichier db2dsdriver.cfg généré est accordé au groupe Other users. Exécutez la commande suivante :
      chmod 644 ${OUTPUT_FOLDER}/db2dsdriver.cfg

    4. Vérifiez le contenu du fichier db2dsdriver.cfg généré. Si vous trouvez des entrées de base de données locale avec les paramètres host="LOCALHOST" et port="0", remplacez LOCALHOST par le nom d'hôte correct et mettez à jour l'entrée port avec le numéro de port Db2 correct. Enregistrez vos modifications.

      Pour certaines versions de Db2 , l'exécution de la commande db2dsdcfgfill peut ne pas créer le fichier de configuration db2dsdriver.cfg dans le dossier spécifié.

      Si cette erreur se produit lorsque vous exécutez la commande db2dsdcfgfill , vérifiez la version du client Db2 et effectuez une mise à niveau vers la version 11.5.7.0 si nécessaire. Pour plus d'informations sur la mise à niveau du client Db2, voir Mise à niveau de votre instance de client IBM Db2.

    5. Mettez le fichier de configuration db2dsdriver.cfg à la disposition de l'agent ASBNode et de CAS. En tant qu'utilisateur root , procédez comme suit:
      1. Définissez les variables d'environnement ci-dessous.
        IIS_INSTALL_PATH=<IIS installation path>
DB2_INSTANCE_NAME=<db2-instance-name>
OUTPUT_FOLDER=<output folder>
      2. Ajoutez la variable d'environnement suivante à ${IIS_INSTALL_PATH}/ASBNode/bin/NodeAgents_env_DS.sh:
        export CC_DB2_CONNECTION_MIGRATION_DB2DSDRIVER_CFG_${DB2_INSTANCE_NAME}=${OUTPUT_FOLDER}/db2dsdriver.cfg
      3. Redémarrez l'agent ASBNode en exécutant les commandes suivantes. Vous devez disposer de droits en lecture sur le fichier de configuration db2dsdriver.cfg .
        ${IIS_INSTALL_PATH}/ASBNode/bin/NodeAgents.sh stop
        ${IIS_INSTALL_PATH}/ASBNode/bin/NodeAgents.sh start

Si vous disposez de plusieurs instances Db2 , procédez comme suit pour chaque instance.

Détermination de la portée de l'exportation

Evaluez les données que vous souhaitez migrer et supprimez toutes les données inutiles pour éviter d'encombrer le nouveau déploiement.

Etape suivante

Effectuez les tâches de configuration pour Cloud Pak for Data dans Préparation de la migration dans IBM Cloud Pak for Data.