Migration de Trillium 15.x vers la version 17.2 sous Windows - trillium_discovery - trillium_quality - 17.2

Guide d'installation de Trillium DQ

Product type
Logiciels
Portfolio
Verify
Product family
Product
Trillium > Trillium Quality
Trillium > Trillium Discovery
Version
17.2
Language
Français
Product name
Trillium Quality and Discovery
Title
Guide d'installation de Trillium DQ
Topic type
Référence
Aperçu
Installation
Comment faire
Configuration
First publish date
2008
ft:lastEdition
2024-06-03
ft:lastPublication
2024-06-03T07:36:30.822494
Les étapes pour migrer Trillium Repository 15.x vers Trillium 17.2 sur la plateforme Windows sont les suivantes.
  1. Exportez les fichiers de la base de donnée Berkeley et les fichiers du projet TSQ du référentiel vers un emplacement partagé.
    Utilisez l'utilitaire db_dump.exe qui se trouve dans <installation path>/bin pour exporter les fichiers. L'instance cible accède à ces fichiers qui sont ensuite fusionnés dans un nouveau référentiel.
    Utilisez le script PowerShell suivant pour exporter le référentiel.
    Conseil : Enregistrez l'extrait de code ci-dessous dans un fichier avec les autorisations d'exécution, mettez à jour les parties pertinentes du code avec le répertoire où TSS est installé, l'emplacement du référentiel, l'emplacement d'exportation, puis exécutez le code.
                             Function Write-Log {     [CmdletBinding()]     Param (         $Message     )     Process {         Write-Host $Message     } }  Write-Host "Berkley DB Repository Exporter." Write-Warning "Run this script as Administrator" Write-Warning "Log off from the Repository Manager, Control Center, Admin Center and Discovery Center before continue" Write-Warning "Stop TSS 15 services before continue"  # v15.x installation dir $installDir="C:\Program Files (x86)\Trillium Software\MBSW\15" # repository location $repositoryDir="C:\ProgramData\Trillium Software\MBSW\15\Data" # export location $exportDir="<shared location>"  Write-Host "Install Directory:     $installDir" Write-Host "Repository Directory:  $repositoryDir" Write-Host "Export Location:         $exportDir"  pause   $dbdumpUtil=$installDir + "\bin\db_dump.exe" if (-not(Test-Path -Path $dbdumpUtil -PathType Leaf)) {     Write-Warning "Berksley DB Dump Utility not found at $dbdumpUtil!"     exit 1 }  Write-Log "Preparing Export location..." if (-not(Test-Path -Path $exportDir)) {     [void](mkdir $exportDir) } if (-not(Test-Path -Path $exportDir\metabase)) {     [void](New-Item -Path $exportDir -Name "metabase" -ItemType "directory") } # TODO metabase dir is not empty  if (-not(Test-Path -Path $exportDir\EXPORTED)) {     New-Item -Path $exportDir -Name "EXPORTED" -ItemType "file" }  Write-Log "Finding Repository DB files..." # find database table files (ends with .bdb, .mta, .ndx, .nta) $files = Get-ChildItem $repositoryDir\metabase -recurse | where {$_.name -match ".*?.bdb|.*?.mta|.*?.ndx|.*?.nta"} foreach($file in $files){     # check filesize      if ($file.Length -gt 0kb) {         $dumpPath = $file.FullName         $dumpPath = $dumpPath.replace($repositoryDir, $exportDir)         if (-not(Test-Path -Path (Split-Path $dumpPath))) {             [void](mkdir -p (Split-Path $dumpPath))         }          Write-Log "Dumping $($file.Fullname) to $dumpPath"         # execute utility to dump         & $dbdumpUtil -f $dumpPath $file.FullName     } }  Write-Log "Finding Non Database (TSQ Projects) files..." $files = Get-ChildItem $repositoryDir\metabase -recurse | where-object {$_.name -NotMatch ".*?.bdb|.*?.mta|.*?.ndx|.*?.nta"} foreach($file in $files){     # if directory then ignore     if (Test-Path -Path $file.FullName -PathType Container) {         continue     }     # check filesize      if ($file.Length -gt 0kb) {         $dumpPath = $file.FullName         $dumpPath = $dumpPath.replace($repositoryDir, $exportDir)         if (-not(Test-Path -Path (Split-Path $dumpPath))) {             [void](mkdir -p (Split-Path $dumpPath))         }          Write-Log "Copying $($file.Fullname) to $dumpPath"         Copy-Item $file.Fullname -Destination (Split-Path $dumpPath) -Force     } }  Write-Log "Done."                     
  2. Exécutez les étapes Migration de Linux vers Windows pour la migration de la plateforme Linux vers la plateforme Windows.
  3. Procédez comme suit pour migrer le référentiel
    Avant de migrer le référentiel, il est recommandé de sauvegarder l'état initial du serveur de référentiel TSS.
    Conseil : Installez le serveur de référentiel TSS avec un référentiel non chiffré. Le référentiel chiffré n'est pas pris en charge pour la migration entre plateformes.
    1. Installez le serveur de référentiel TSS comme nouvelle installation.
    2. Supprimez manuellement les répertoires appropriés avant d'intégrer le contenu de l'ancien référentiel dans la nouvelle installation.
      • Supprimez le répertoire de la métabase du dossier des données du référentiel.
      • Supprimez le répertoire de la métabase du dossier des métadonnées du référentiel.
      • Supprimer le contenu du répertoire des projets TSQ
        Avertissement : Le répertoire des métadonnées ne s'applique qu'aux utilisateurs qui disposent d'un référentiel fractionné. Les utilisateurs dont le référentiel n'est pas fractionné n'auront qu'un seul répertoire.
    3. Exécutez la commande Copy pour consommer l'ancien référentiel.
      Pour suivre l'avancement et observer les journaux dans logs/mtb_server.log
      • cd <server>/metabase/bin
      • mtb_admin -user <bootuser> -password <bootuserpassword> -copy source <shared data directory> sourceMetadata <shared metadata directory> sourceTSQDir <shared TSQ projects location> sourceVersion <source version>
    4. Exécutez la commande Convert pour mettre à jour le référentiel, afin qu'il soit compatible avec la nouvelle version.
      Pour comprendre l'avancement et l'observation des journaux dans logs/mtb_server.log
      • cd <server>/metabase/bin
      • mtb_admin -user <bootuser> -password <bootuserpassword> -metabase _control -convert
      Utilisez le code suivant pour migrer le serveur de référentiel :
      Conseil : Enregistrez l'extrait de code ci-dessous dans un fichier avec les autorisations d'exécution, mettez à jour les parties pertinentes du code avec le répertoire où TSS est installé, l'emplacement du référentiel, l'emplacement d'exportation, puis exécutez le code.
       Function Write-Log {     [CmdletBinding()]     Param (         $Message     )     Process {         Write-Host $Message     } }  # v17.2.x installation dir $installDir="C:\Program Files\Trillium Software\MBSW\17" # boot user credentials $bootuser="bob " $bootuserpw="p"  # version of exported repository $version="15.7.4" # exported location $exportDir="<shared location>"  $backup = 1 $scriptDir=(Get-Location)  Write-Log "Import BerkleyDB Repository!" Write-Warning "Run this script as Administrator" Write-Warning "Log off from the Repository Manager, Control Center, Admin Center and Discovery Center before continue" Write-Warning "Stop TSS 17 services before continue"  Write-Log "Install Directory: $installDir" Write-Log "Logging in as:     $bootuser"  Write-Log "Source Version:    $version" Write-Log "Exported Location: $exportDir"  $binFolder=${installDir} + "\bin" if (-not(Test-Path -Path $binFolder -PathType Container)) {     Write-Log "Server folder not found at $installDir!"     exit 1 }  # checking EXPORTED flag if (-not(Test-Path -Path $exportDir\EXPORTED -PathType Leaf)) {     Write-Log "Exported folder not formed correctly. $exportDir"     exit 1 }  cd $binFolder  Write-Log "" Write-Log "Extracting installation properties.."  $encryption=(Get-Content "..\etc\registry.txt" | Select-String 'value encryption-key(.+)$') $encryption="$encryption".replace("value encryption-key", "").replace(" ", "") if ($encryption -ne "0") {     Write-Warning "Not yet Supported for migration! System is configured to encryption at REST"     Write-Log "Please keep a note and change the encryption-key to '0'"     exit 1 }  $system=(Get-ItemProperty -Path "HKLM:\SOFTWARE\Trillium Software\MBSW\17\config\system") $dataDir=$system.data $metadataDir=$system.metadata $tsqProject=$system.tsqprojects   Write-Log "Data Directory:        $dataDir" Write-Log "Metadata Directory:    $metadataDir" Write-Log "TSQ Projects:          $tsqProject"  Write-Log "" Write-Log "Cleaning up the repositories for importing..."   # backup if (Test-Path -Path $dataDir\metabase -PathType Container) {     if ($backup) {         Copy-Item $dataDir\metabase -Destination $dataDir\metabase_bak -recurse -force     }     # remove     Remove-Item $dataDir\metabase -Recurse -Force }  # ignore this if datadir and metadatadir are same if ($dataDir -ne $metadataDir) {     if (Test-Path -Path $metadataDir\metabase -PathType Container) {         if ($backup) {             Copy-Item $metadataDir\metabase -Destination $metadataDir\metabase_bak -recurse -force         }         Remove-Item $metadataDir\metabase -Recurse -Force     } }  # backup if (Test-Path -Path $metadataDir\metabase -PathType Container) {     if ($backup) {         Copy-Item $tsqProject -Destination ${tsqProject}_bak -recurse -force     }     Remove-Item $tsqProject\* -Recurse -Force }  Write-Log "" Write-Log "Starting importing repository (-copy)..." Start-Process -NoNewWindow -Wait -FilePath "$binFolder\mtb_admin.exe" -ArgumentList "-user", $bootuser, "-password", $bootuserpw, "-copy", "sourceVersion $version source $exportDir"  Write-Log "" Write-Log "Updating repository (-convert)..." Start-Process -NoNewWindow -Wait -FilePath "$binFolder\mtb_admin.exe" -ArgumentList "-user $bootuser -password $bootuserpw -metabase _control -convert"  Write-Log "Done" cd $scriptDir 
    5. Démarrez l'ordonnanceur et le serveur Web.
      Remarque : Le chemin partagé utilisé pour l'exportation de l'ancien référentiel peut être supprimé une fois que la consommation est réussie et vérifiée.
      La migration du serveur de référentiel a abouti.
      Important : Une fois que la migration entre plateformes est terminée :
      • Activez la licence.
      • Redéfinissez les répertoires des tables d'adresses postales. La version 15.7.4 utilise un répertoire 32 bits, et la version 17.0 et les versions ultérieures utilisent un répertoire 64 bits.
      • Mettez à jour les fichiers de configuration config.txt, gaserver.ini, config.js. Ces fichiers ne sont pas migrés depuis les anciennes versions.