使用 Notes® 單一使用者到多使用者移轉助理工具

使用此程序，將現有的 Notes® 單一使用者安裝或模擬的多使用者安裝，轉換為單一 Notes® 版本內真正的 Notes® 多使用者安裝。在移轉之後，您可以升級 Notes® 多使用者用戶端的版次。

開始之前

  • 檢閱「瞭解 Notes® 單一使用者到多使用者移轉助理工具」主題中的資訊。
  • 若要執行此工具，您必須以管理員身分登入 Windows™，以確保複製及移動資料所需的權限。
  • 在執行工具之前，請考量備份 Notes® 用戶端。如需詳細資料，請參閱「備份及回復 Notes® 用戶端資料」文章，其包括在本主題尾端的鏈結中。
  • 驗證使用者是否對新的目標目錄具有所需的讀取/寫入/刪除權限。

執行這項作業的原因和時機

程序

  1. 結束 Notes® 應用程式；移轉期間無法執行 Notes®。
  2. 在 Notes® 安裝套件的 Utility 資料夾中找出 MUMigrationAssistant.vbs 及 MUMigrationAssistant.ini 檔案。
  3. 開啟 MUMigrationAssistant.vbs Script，並檢閱其內嵌的文件。
  4. 以文字編輯器開啟 MUMigrationAssistant.ini 配置檔，並指定下列值：
    選項敘述
    CURRENTINIPATH （必要）指定現行 NOTES.INI 檔案位置。此工具會從使用者的 NOTES.INI 檔案中取得使用者的資料目錄位置。
    NOTESPROGRAM （選用）指定使用者的 notes.exe 檔案的現行位置。如果未指定，工具首先會從 Windows 登錄（若為 8.5.x 及更舊版本：HKLM/SOFTWARE/Notes/version/Path；若為 Notes 9.0 或更新版本：HKLM/SOFTWARE/Notes/Path），然後再從使用者的 NOTES.INI 檔案中嘗試決定位置。
    MULTIUSERBASEDIR （選用）指定使用者的資料目錄的目標位置。當執行工具時，它會確認指定的目錄是否存在，並確認是否對該目錄具有讀寫權限。此工具會將 Notes\Data 加至最後（若為 Notes® 9.0 之前的版本），或將 HCL\Notes\Data 加至最後（若為 Notes® 9.0 或更新版本）。設定此值時，您必須將 %USERNAME% 併入 MULTIUSERBASEDIR 中。如果您未指定 MULTIUSERBASEDIR 的值，則會使用預設值 CSIDL_APPDATA。
    重要： 如果您指定了此設定的值，也須指定 MULTIUSERCOMMONDIR 的值。
    MULTIUSERCOMMONDIR （選用）指定一般共用資料目錄所在的位置。當執行工具時，它會確認正要移動其資料的使用者是否對指定的目錄具有讀取權限。

    如果指定一值，工具會檢查該值是否包括 %USERNAME% 環境變數。如果您未指定 MULTIUSERCOMMONDIR 的值，則會使用預設值 CSIDL_COMMON_APPDATA。

    此工具會將 Notes\Data 加至最後（若為 Notes® 9.0 之前的版本），或將 HCL\Notes\Data 加至最後（若為 Notes® 9.0 或更新版本）。

    重要： 如果您指定了此設定的值，也須指定 MULTIUSERBASEDIR 的值。
    DRYRUN （選用）
    • True（預設值）- 當您執行工具時，它會產生一個報告，列出由於執行工具而產生的變更，但它不會執行移轉。
    • False - 當您執行工具時，它會執行移轉
    MIGRATE_REGISTRY
    • True - 工具會針對所有使用者移轉 HKLM 登錄設定，並更新桌面捷徑及開始功能表捷徑。
    • False - 工具不會移轉登錄設定或更新捷徑。

    從模擬的多使用者 Notes® 安裝中移轉時，您可以在執行 cscript 指令時於命令提示字元中指定此選項

    MIGRATE_USER_REGISTRY
    • True - 工具會針對僅執行工具的使用者移轉登錄設定，並更新桌面捷徑及開始功能表捷徑。
    • False - 工具不會移轉登錄設定或更新捷徑。

    從模擬的多使用者 Notes® 安裝中移轉時，您可以在執行 cscript 指令時於命令提示字元中指定此選項

    MIGRATE_SHARED_DIR
    • True - 工具會移轉要在所有使用者之間共用的一般資料檔案。這些是將在 Notes® 多使用者安裝期間安裝至一般共用目錄的檔案
    • False - 工具不會移轉一般資料檔案。

    如果您有其他要移動的檔案，例如使用者的範本，則可以在檔案中列出它們，並在下一個設定 MIGRATE_SHARED_FILES 中指定位置。

    若要自訂已移動檔案的目標位置，請使用 MULTIUSERCOMMONDIR 設定。

    從模擬的多使用者 Notes® 安裝中移轉時，您可以在執行 cscript 指令時於命令提示字元中指定此選項

    MIGRATE_SHARED_FILES 指定 migratefilelist.txt 文字檔的名稱及位置，它會列出其他要移至目標共用目錄的檔案，例如，使用者定義的範本，或 Notes® 未安裝的範本。

    若要使用此設定，您必須將上一個設定 MIGRATE_SHARED_DIR 的值設為 True。

    從模擬的多使用者 Notes® 安裝中移轉時，您可以在執行 cscript 指令時於命令提示字元中指定此選項

    MIGRATE_USERDATA_DIR 只在將模擬的多使用者安裝移轉至真正多使用者安裝時，才會使用此設定。
    • True - 工具會將使用者的個人資料檔案（例如，使用者 ID、範本、資料庫）移轉至 MULTIUSERBASEDIR 設定所指定的目錄。對於每一個使用者，此值應設為 true。
    • False - 工具不會移動個人資料。

    工具會從 NOTES.INI 檔案判定來源資料目錄的位置，然後確認要移轉的每一個檔案是否存在於資料目錄中，並確認工具是否擁有操作檔案的權限。

    您可以在「啟動群組」或 RunOnce 登錄機碼中建立建立一個批次檔，來執行 Script，以在每一個使用者在移轉之後第一次登入 Windows 時，自動為他們移轉資料。如果每一個使用者的來源資料目錄位於個別磁碟機，則您必須為每一個使用者個別執行工具。

    如果未設定 MULTIUSERBASEDIR 的值，則資料會移轉至預設使用者資料路徑所指定的位置。若為 Notes® 8.5x 及更舊版本，預設路徑為：C:\Documents and Settings\username\Local Settings\Application Data\Notes\Data；若為 Notes® 9.0 或更新版本，預設路徑為：C:\Documents and Settings\username\Local Settings\Application Data\HCL\Notes\Data。

    從模擬的多使用者 Notes® 安裝中移轉時，您可以在執行 cscript 指令時於命令提示字元中指定此選項

  5. 儲存並關閉 MUMigrationAssistant.ini 檔案。
  6. 關閉 MUMigrationAssistant.vbs Script。
  7. 在配置檔中將 DRYRUN 選項的值設為 true，然後在命令提示字元中鍵入下列指令，來執行移轉的測試執行： 
    cscript MUMigrationAssistant.vbs configuration_setting=value

    當執行工具時，它會先確認配置檔中的設定，再執行移轉。如果指定 notes.exe 及 notes.ini 檔案位置的 NOTESPATH 及 CURRENTINIPATH 設定無效，則移轉將停止：

    註： 如果在指令行上及配置檔中指定的設定之間發生衝突，則指令行中指定的設定優先採用。
  8. 檢閱輸出報告，並決定 MUMigrationAssistant.ini 檔案是否需要做任何調整。如果要，請立即進行。
  9. 在配置檔中將 DRYRUN 選項的值設為 false，然後在命令提示字元中鍵入下列指令，來執行移轉： 
    cscript MUMigrationAssistant.vbs configuration_setting=value

    將在共用資料目錄中產生 NOTES.INI 檔案。原始的 NOTES.INI 檔案將移至 MULTIUSERBASEDIR 變數指定的目錄。新的資料目錄將位於 MULTIUSERBASEDIR 變數指定的目錄中，而且共用目錄將為 MULTIUSERCOMMONDIR 變數指定的目錄。

結果

工具會將活動記載至 Install.log 檔案，而此檔案位於安裝使用者的 My Documents 資料夾，以及已移轉使用者的資料目錄中。

範例

範例：模擬的多使用者安裝至（真正）多使用者安裝
在此實務範例中，配置了數個使用者使用模擬的多使用者環境在單一電腦上工作，並使用包含其一般資料檔和使用者特定資料檔的共用磁碟機。
  • NOTES.INI 檔案為 H:\data\notes.ini。
  • Notes® 安裝程式 setup.exe 檔案位於 C:\Program Files\HCL\Notes。
  • 使用者的資料目錄是 H:\data。
  • 共用資料目錄是 C:\notes\common\Notes\data。
  • migratefilelist.txt 檔案（位於您從中執行移轉工具的目錄）指定將移動下列其他檔案：
    • H:\data\template1.ntf
    • H:\data\template2.ntf
    • H:\data\template3.ntf

根據適用的使用案例來移轉使用者，如下所示：

使用案例 1 - 簡易單一使用者至多使用者移轉，適用於所有版本的 Notes®

在此使用案例中，Notes® 8.5.1 是以單一使用者模式安裝，而「程式檔案」安裝至 C:\Program Files\HCL\Notes，資料檔案則安裝至 C:\Program Files\HCL\Notes\Data。

執行工具來執行下列動作：
  • 移轉登錄項目，使它成為真正的多使用者安裝。
  • 將所有使用者要使用的一般檔案移轉至 C:\Documents and Settings\AllUsers\Application Data\Notes\Data。
  • 將使用者的資料檔案和 NOTES.INI 移轉至 C:\Documents and Settings\username\Local Settings\Application Data\Notes\Data。

MUMigrationAssistant.ini 指定的值如下所示：

DRYRUN=true
CURRENTINIPATH=C:\Program Files\HCL\Notes\Data\notes.ini
NOTESPROGRAM=C:\Program Files\HCL\Notes
IS_SIMULATED_MODE=false
MIGRATE_REGISTRY=true
MIGRATE_USER_REGISTRY=true
MIGRATE_SHARED_DIR=true
MIGRATE_USERDATA_DIR=true
MULTIUSERCOMMONDIR= 
MULTIUSERBASEDIR=
註： 將 MULTIUSERBASEDIR 和 MULTIUSERCOMMONDIR 保持空白，以使用預設值。

使用案例 2 - 模擬的多使用者至真正的多使用者移轉 - 第一次執行工具來移動所有共用資料

在此使用案例中，Notes® 8.5.1 是以單一使用者模式安裝，但每一個使用者的資料目錄都會在網路磁碟機上進行對映。「程式檔案」安裝至 C:\Program Files\HCL\Notes，資料檔案安裝至 H:\Data。當所有使用者的來源資料目錄為本端或位於一般網路磁碟機時，您可以執行工具，為該 Notes® 用戶端實例的所有使用者將資料移至目標資料目錄。

從系統中以對使用者的對映資料磁碟機具有存取權的管理員身分執行 MUMigrationAssistant，以執行下列動作：
  • 轉換 HKLM 登錄設定，以指定真正的多使用者安裝。
  • 建立共用資料目錄 C:\notes\common\Data
  • 將所有使用者的一般檔案移轉至共用目錄。

MUMigrationAssistant.ini 指定的值如下所示：

DRYRUN=true
CURRENTINIPATH=H:\data\notes.ini
NOTESPROGRAM=C:\Program Files\HCL\Notes
IS_SIMULATED_MODE=true
MIGRATE_REGISTRY=true
MIGRATE_USER_REGISTRY=false
MIGRATE_SHARED_DIR=true
MIGRATE_USERDATA_DIR=false
MULTIUSERCOMMONDIR=C:\notes\common
MULTIUSERBASEDIR=H:\data

使用案例 3 - 模擬的多使用者至真正的多使用者移轉，當每一個使用者登入時，後續執行此工具來移動每一個使用者的資料

在此使用案例中，Notes® 8.5.1 是以單一使用者模式安裝，但是每一個使用者的資料目錄位於對映磁碟機。管理員已將 Notes® 用戶端上的單一使用者設定移轉至多使用者安裝（根據使用案例 2）。現在每一個使用者都登入系統。

當使用者登入時執行 MUMigrationAssistant，以執行下列動作：
  • 移轉特定使用者的 HKCU 登錄項目。
  • 將使用者的資料從對映磁碟機移至預設位置 C:\Documents and Settings\username\Local Settings\Application Data\Notes\Data。
MUMigrationAssistant.ini 指定的值如下所示：
DRYRUN=true
CURRENTINIPATH=H:\data\notes.ini
NOTESPROGRAM=C:\Program Files\HCL\Notes
IS_SIMULATED_MODE=true
MIGRATE_REGISTRY=false
MIGRATE_USER_REGISTRY=true
MIGRATE_SHARED_DIR=false
MIGRATE_USERDATA_DIR=true
MULTIUSERCOMMONDIR=C:\notes\common
MULTIUSERBASEDIR=
註： 將 MULTIUSERBASEDIR 保持空白，使用它的預設值。