legacy-knowledge-base
公開されました Jul. 2, 2025

Liferay Portalのデータ移行ツールの使用について

投稿者

Liferay Support

knowledge-article-header-disclaimer-how-to

knowledge-article-header-disclaimer

legacy-article

learn-legacy-article-disclaimer-text

本記事では、Liferay Portalのシステム管理セクションにあるデータ移行ツールの2つの使い方を説明します。 データ移行ツールは、Liferay Portal 6.2以降に完全対応しています。 DXP 7.0では非推奨となりました。

注: このツールは、 Liferay データ(Liferay プラットフォームのサービスビルダーで構築されたデータ)のみを移行します。 カスタムデータを移行することはできません。

解像度

ドキュメントライブラリのディレクトリの場所を変更する

ドキュメントライブラリの保存場所を、Liferay Portalで設定したデフォルトの場所とは異なる場所にしたい場合は、 ${liferay.home}/data/document_library

Liferay Portal 6.2およびそれ以前のバージョン。

  1. Liferay Portal をシャットダウンします。
  2. portal-ext.properties に以下のポータルプロパティを追加し、目的のファイルストレージルートディレクトリへのパスを指定します
    dl.store.file.system.root.dir=
  3. アプリケーションサーバーを再起動します。

ファイルシステムの保存方法の切り替え

  1. Admin > Control Panel > Server Administration > Data Migration オプションに移動します。 Advanced File Store など、希望するファイルストアシステムオプションを選択し、 実行をクリックします。
  2. ログを見て、処理が完了したことを知り、例外があれば特に注意してください。
  3. ${liferay.home}/data/document_library 変更されていない場合、または portal-ext.propertiesdl.store.file.system.root.dir に入力したパス、または現在ドキュメントを保持しているシステムのいずれかに、データが適切なドキュメントライブラリ保存場所に書き込まれたことを確認します。
  4. Liferay Portal をシャットダウンします。
  5. 現在の dl.store.impl プロパティをコメントアウトし、新しい dl.store.impl プロパティに、ステップ 4 で選択したファイルストアシステムオプションの値を追加します
    #dl.store.impl=com.liferay.portlet.documentlibrary.store.DBStore
    #DBStoreからの移行後にAFSに切り替える...
    dl.store.impl=com.liferay.portlet.documentlibrary.store.AdvancedFileSystemStore
    dl.store.file.system.root.dir=/mnt/nfs/lrdocs
  6. Liferay Portal を再起動します。

データベースから別のデータベースへの切替

  1. コントロールパネル > サーバ管理 > データ移行(Portal 6.2 を使用している場合)にアクセスします。
  2. 移行先のデータベースのフィールドに、以下の値を設定します。 例えば、対象データベースがMySQLの場合:
    • JDBCドライバクラス名: com.mysql.jdbc.Driver
    • JDBC の URL です: jdbc:mysql://[IP address]/[DB Name]?useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false
    • JDBC User Name: [user name]
    • JDBCパスワード: [Password]
  3. SQL Server 2008 以降への移行を予定している管理者は、以下の値を入力することができます:
    • JDBCドライバクラス名: com.microsoft.sqlserver.jdbc.SQLServerDriver
    • JDBCのURLです: jdbc:sqlserver://localhost;databaseName=lportal
    • JDBC User Name: sa
    • JDBCパスワード: [Password]
  4. 実行する ボタンをクリックします。
  5. 処理が終了すると、ログにこのようなメッセージが表示されます:
    	16:07:24,745 DEBUG [liferay/convert_process-1][MaintenanceUtil:64] Please change your JDBC settings before restarting server 16:07:24,746 INFO [liferay/convert_process-1][ConvertProcess:47] Finished conversion for com.liferay.portal.convert.ConvertDatabase in 48619 ms
    	
  6. サーバーをシャットダウンし、ポータルを起動する前に、ステップ2の新しいデータベースに接続するために、 portal-ext.properties を更新してください。

追加情報

  • サーバー管理に関する6.2公式ドキュメントの「 Data Migration 」セクションをご覧ください。
  • DXP 7.0 へのアップグレードガイドの「 Documents and Media の設定」セクションを参照してください。
did-this-article-resolve-your-issue

legacy-knowledge-base