Vous pouvez exporter le contenu d'une bibliothèque de contenu Web sur le disque en créant une copie de la bibliothèque de contenu Web. L'utilisation d'une copie exportée permet d'importer la bibliothèque copiée sur le même serveur de contenu Web plusieurs fois et par conséquent, de générer une nouvelle bibliothèque après chaque importation sans que les copies précédentes ne soient affectées. C'est un moyen rapide de créer des bibliothèques remplies avec du contenu Web que vous pouvez adapter facilement à d'autres fins.
- Préambules
Pourquoi et quand exécuter cette tâche
De nombreux aspects de l'exportation et de l'importation standard et de l'exportation et de l'importation de copie sont identiques ; toutefois, certaines différences sont importantes :
- Lorsque vous exportez une bibliothèque en tant que copie, de nouveaux ID sont générés pour tous les objets de la bibliothèque. Ceci évite tout conflit avec des bibliothèques ou des objets existants lorsque vous importez la copie sur un serveur de contenu Web sur lequel se trouve déjà la bibliothèque d'origine. De cette façon, vous pouvez procéder à plusieurs importations sur le même serveur de contenu Web, ce qui génère une nouvelle bibliothèque pour chaque importation.
- Les tâches de configuration (
export-library-copy et import-library-copy) qui fonctionnent sur les copies de bibliothèque utilisent des propriétés qui peuvent être ajoutées au fichier wkplc.properties ou ajoutées manuellement à la ligne de commande, pour un scriptage plus facile.
Effectuez les opérations ci-après pour exporter ou importer une copie d'une bibliothèque de contenu Web. Le serveur à partir duquel les données sont exportées est appelé serveur source, et le serveur sur lequel les données sont importées est appelé serveur cible.
Procédure
- Exportation :
- Ouvrez une invite de commande sur le serveur source.
- Exécutez la tâche
export-library-copy à partir du répertoire wp_profile_root/ConfigEngine.
- Windows™
- ConfigEngine.bat export-library-copy -DLibraryPath=path_to_export_file -DLibraryName=library_name_to_export -DWasPassword=password -DPortalAdminPwd=password
- UNIX™Linux™
- ./ConfigEngine.sh export-library-copy -DLibraryPath=path_to_export_file -DLibraryName=library_name_to_export -DWasPassword=password -DPortalAdminPwd=password
- IBM®i
- ConfigEngine.sh export-library-copy -DLibraryPath=path_to_export_file -DLibraryName=library_name_to_export -DWasPassword=password -DPortalAdminPwd=password
Les propriétés suivantes doivent être spécifiées sur la ligne de commande ou dans le fichier
wkplc.properties.
Remarque : Si vous spécifiez les propriétés dans le fichier wkplc.properties, il n'est pas nécessaire de placer les valeurs contenant des espaces entre guillemets ("). Ces guillemets ne sont requis que si les valeurs des propriétés sont spécifiées sur la ligne de commande.
- LibraryPath
- Chemin de répertoire et nom de fichier utilisés pour stocker la bibliothèque exportée. Le processus d'exportation crée un fichier archive compressé ; par conséquent, il est recommandé de spécifier une extension de fichier, telle que
.zip. Si vous procédez à l'exportation ou à l'importation sur un réseau, cet emplacement peut correspondre à une unité réseau accessible par le serveur source ainsi que par le serveur cible.
- LibraryName
- Nom de la bibliothèque de contenu Web à copier. Si vous exportez plusieurs bibliothèques, séparez chaque nom de bibliothèque par un point-virgule (
;). Par exemple, LibraryName="Web Content;Samples".
- WasUserid
- ID de l'administrateur de WebSphere® Application Server.
- WasPassword
- The administrator password for WebSphere® Application Server.
- PortalAdminId
- L'ID administrateur pour HCL Portal.
- PortalAdminPwd
- Le mot de passe d'administrateur pour HCL Portal.
Par défaut, cette tâche est effectuée sur le portail virtuel par défaut. Pour l'exécuter sur un portail virtuel différent, identifiez le portail virtuel en ajoutant l'un des paramètres ci-après à la ligne de commande. Chaque paramètre requiert le préfixe
-D sur la ligne de commande.
- VirtualPortalHost
- Spécifiez le nom d'hôte du portail virtuel. Par exemple,
vp.example.com.Important : Si le nom d'hôte du portail virtuel est identique au nom d'hôte du portail virtuel par défaut, vous devez également spécifier la propriété VirtualPortalContext. Vous ne pouvez indiquer la propriété VirtualPortalHost seule que si le nom d'hôte est unique.
- ContextePortailVirtuel
- Spécifiez le contexte de portail virtuel identifiant le portail virtuel. Par exemple,
vp1.
Exemples de commande :
- Windows™ : ConfigEngine.bat export-library-copy -DLibraryPath=C:\wcm_export\webcontent.zip -DLibraryName="Web Content" -DWasPassword=mypassword -DPortalAdminPwd=mypassword -DVirtualPortalHost=vp.example.com
- UNIX™Linux™ : ./ConfigEngine.sh export-library-copy -DLibraryPath=/opt/wcm_export/webcontent.zip -DLibraryName="Web Content" -DWasPassword=mypassword -DPortalAdminPwd=mypassword -DVirtualPortalHost=vp.example.com
- IBM® i: ConfigEngine.sh export-library-copy -DLibraryPath=/opt/wcm_export/webcontent.zip -DLibraryName="Web Content" -DWasPassword=mypassword -DPortalAdminPwd=mypassword -DVirtualPortalHost=vp.example.com
- Vérifiez que cette étape de transfert a abouti sans générer d'erreur. Si des erreurs sont survenues, vérifiez les fichiers journaux de portail du serveur source pour obtenir des informations de diagnostic avancées.
- Importation :
- Ouvrez une invite de commande sur le serveur cible.
- Exécutez la tâche
import-library-copy à partir du répertoire wp_profile_root/ConfigEngine.
- Windows™
- ConfigEngine.bat import-library-copy -DLibraryPath=path_to_export_file -DLibraryName=library_name_to_import -DWasPassword=password -DPortalAdminPwd=password
- UNIX™Linux™
- ./ConfigEngine.sh import-library-copy -DLibraryPath=path_to_export_file -DLibraryName=library_name_to_import -DWasPassword=password -DPortalAdminPwd=password
- IBM®i
- ConfigEngine.sh import-library-copy -DLibraryPath=path_to_export_file -DLibraryName=library_name_to_import -DWasPassword=password -DPortalAdminPwd=password
Les propriétés suivantes doivent être spécifiées sur la ligne de commande ou dans le fichier
wkplc.properties.
Remarque : Si vous spécifiez les propriétés dans le fichier wkplc.properties, il n'est pas nécessaire de placer les valeurs contenant des espaces entre guillemets ("). Ces guillemets ne sont requis que si les valeurs des propriétés sont spécifiées sur la ligne de commande.
Differences in paths between versions : Lorsque vous exportez à partir d'un système version 6.1, vous pouvez spécifier un dossier pour y exporter la bibliothèque :
/opt/61/folder/jcr_root
Lorsque vous importez dans la version 8.0 à partir de la version 6.1, il n'est pas nécessaire de spécifier jcr_root dans le chemin d'importation :
/opt/61/folder/
Lorsque vous exportez à partir de la version 7.0 ou d'une version ultérieure, la structure suivante est utilisée :
/opt/70/folder1/folder2
Une fois l'exportation terminée,
folder2 est automatiquement généré.
Lorsque vous effectuez une importation dans la version 8.0 à partir de la version 7.0 ou d'une version ultérieure, il n'est pas nécessaire de spécifier
folder2 dans le chemin d'importation :
/opt/70/folder1/
- LibraryPath
- Chemin de répertoire et nom de fichier contenant la bibliothèque à importer. Si vous procédez à l'exportation et à l'importation sur un réseau, la valeur de cette propriété peut être le chemin d'accès au fichier utilisé pour la propriété
LibraryPath lors du processus d'exportation. Sinon, vous devez copier les données exportées dans un emplacement accessible par le serveur cible avant de tenter l'importation.
- LibraryName
- Nom à utiliser pour la copie de la bibliothèque de contenu Web que vous importez. Si vous importez plusieurs bibliothèques, séparez chaque nouveau nom de bibliothèque par un point-virgule (
;). Par exemple, LibraryName="Web Content Copy;Samples Copy".
- LibraryExportName
- Séquence de noms de bibliothèque utilisée lors de l'exportation d'origine, conformément à la propriété
LibraryName spécifiée pour le processus d'exportation. Par exemple, LibraryExportName="Web Content;Samples". Cette propriété permet au processus d'importation de définir correctement les nouveaux noms de bibliothèque pour les copies importées, en conjonction avec la propriété LibraryName spécifiée pour le processus d'importation. La propriété LibraryExportName est requise uniquement si vous importez plusieurs bibliothèques simultanément.
- WasUserid
- ID de l'administrateur de WebSphere® Application Server.
- WasPassword
- The administrator password for WebSphere® Application Server.
- PortalAdminId
- The administrator ID for HCL Portal.
- PortalAdminPwd
- The administrator password for HCL Portal.
Par défaut, cette tâche est effectuée sur le portail virtuel par défaut. Pour l'exécuter sur un portail virtuel différent, identifiez le portail virtuel en ajoutant l'un des paramètres ci-après à la ligne de commande. Chaque paramètre requiert le préfixe
-D sur la ligne de commande.
- VirtualPortalHost
- Spécifiez le nom d'hôte du portail virtuel. Par exemple,
vp.example.com.Important : Si le nom d'hôte du portail virtuel est identique au nom d'hôte du portail virtuel par défaut, vous devez également spécifier la propriété VirtualPortalContext. Vous ne pouvez indiquer la propriété VirtualPortalHost seule que si le nom d'hôte est unique.
- ContextePortailVirtuel
- Spécifiez le contexte de portail virtuel identifiant le portail virtuel. Par exemple,
vp1.
Les propriétés suivantes sont facultatives et peuvent être spécifiées sur la ligne de commande ou dans le fichier
wkplc.properties :
- LibraryTitle
- Titre à utiliser pour la copie de la bibliothèque de contenu Web que vous importez. Si vous importez plusieurs bibliothèques, séparez chaque nouveau titre de bibliothèque par un point-virgule (
;). Par exemple, LibraryTitle="Web Content Title;Samples Title".
- LibraryDescription
- Description à utiliser pour la copie de la bibliothèque de contenu Web que vous importez. Si vous importez plusieurs bibliothèques, séparez chaque nouvelle description de bibliothèque par un point-virgule (
;). Par exemple, LibraryDescription="Copy of Web Content library;Copy of Samples library".
- LibraryNameTextProvider
- Cette propriété spécifie le nom du fournisseur de texte à utiliser pour localiser le titre traduit de la bibliothèque que vous importez. Si vous importez plusieurs bibliothèques avec différents fournisseurs de texte, séparez chaque nom de fournisseur par un point-virgule (
;). Par exemple, LibraryNameTextProvider=provider1;provider2.
- LibraryNameTextProviderKey
- Cette propriété spécifie la clé figurant dans le fournisseur de texte associé, qui identifie le titre traduit de la bibliothèque que vous importez. Si vous importez plusieurs bibliothèques avec différents titres traduits, séparez chaque clé par un point-virgule (
;). Par exemple, LibraryNameTextProviderKey=key1;key2.
- LibraryBaseLocale
- Environnement local utilisé lors de l'importation de la copie de la bibliothèque de contenu Web.
Exemples de commande :
- Windows™ : ConfigEngine.bat import-library-copy -DLibraryPath=C:\wcm_import\webcontent.zip -DLibraryName="Web Content Copy" -DLibraryTitle="Web Content Copy Title" -DLibraryDescription="Copy of Web Content library" -DLibraryNameTextProvider=provider -DLibraryNameTextProviderKey=key -DLibraryBaseLocale=en -DWasPassword=mypassword -DPortalAdminPwd=mypassword
- UNIX™Linux™ : ./ConfigEngine.sh import-library-copy -DLibraryPath=/opt/wcm_import/webcontent.zip -DLibraryName="Web Content Copy" -DLibraryTitle="Web Content Copy Title" -DLibraryDescription="Copy of Web Content library" -DLibraryNameTextProvider=provider -DLibraryNameTextProviderKey=key -DLibraryBaseLocale=en -DWasPassword=mypassword -DPortalAdminPwd=mypassword
- IBM® i: ConfigEngine.sh import-library-copy -DLibraryPath=/opt/wcm_import/webcontent.zip -DLibraryName="Web Content Copy" -DLibraryTitle="Web Content Copy Title" -DLibraryDescription="Copy of Web Content library" -DLibraryNameTextProvider=provider -DLibraryNameTextProviderKey=key -DLibraryBaseLocale=en -DWasPassword=mypassword -DPortalAdminPwd=mypassword
- Vérifiez que les bibliothèques ont été importées en consultant la liste des bibliothèques répertoriées dans la section des bibliothèques de contenu Web du portlet d'administration sur le serveur cible. Si des erreurs sont survenues, vérifiez les fichiers journaux de portail du serveur cible pour obtenir des informations de diagnostic avancées.
- Réinitialisez le journal des événements du contenu Web.
Exemples de commande pour l'exportation et l'importation de plusieurs bibliothèques
Lorsque vous exportez et importez plusieurs bibliothèques de contenu Web avec une seule commande, prenez en compte les remarques suivantes :
- Pour les propriétés, telles que
LibraryName, qui font référence à plusieurs bibliothèques, séparez les valeurs respectives par un point-virgule (;).
- La valeur de la propriété
LibraryExportName doit correspondre à la valeur de la propriété LibraryName utilisée lors du processus d'exportation pour indiquer la séquence des bibliothèques.
- Windows™
- Exporter : ConfigEngine.bat export-library-copy -DLibraryPath=C:\wcm_export\webcontent.zip -DLibraryName="Web Content;Samples" -DWasPassword=mypassword -DPortalAdminPwd=mypassword
- Importation : ConfigEngine.bat import-library-copy -DLibraryPath=C:\wcm_import\webcontent.zip -DLibraryName="Web Content Copy;Samples Copy" -DLibraryExportName="Web Content;Samples" -DLibraryTitle="Web Content Copy Title;Samples Copy Title" -DLibraryBaseLocale=en -DWasPassword=mypassword -DPortalAdminPwd=mypassword
- UNIX™Linux™
- Exporter : ./ConfigEngine.sh export-library-copy -DLibraryPath=/opt/wcm_export/webcontent.zip -DLibraryName="Web Content;Samples" -DWasPassword=mypassword -DPortalAdminPwd=mypassword
- Importation : ./ConfigEngine.sh import-library-copy -DLibraryPath=/opt/wcm_import/webcontent.zip -DLibraryName="Web Content Copy;Samples Copy" -DLibraryExportName="Web Content;Samples" -DLibraryTitle="Web Content Copy Title;Samples Copy Title" -DLibraryBaseLocale=en -DWasPassword=mypassword -DPortalAdminPwd=mypassword
- IBM®i
- Exporter : ConfigEngine.sh export-library-copy -DLibraryPath=/opt/wcm_export/webcontent.zip -DLibraryName="Web Content;Samples" -DWasPassword=mypassword -DPortalAdminPwd=mypassword
- Importation : ConfigEngine.sh import-library-copy -DLibraryPath=/opt/wcm_import/webcontent.zip -DLibraryName="Web Content Copy;Samples Copy" -DLibraryExportName="Web Content;Samples" -DLibraryTitle="Web Content Copy Title;Samples Copy Title" -DLibraryBaseLocale=en -DWasPassword=mypassword -DPortalAdminPwd=mypassword