Sun Java System Calendar Server 6 2005Q4 管理指南

執行目錄準備程序檔

本小節包含以下主題:

Procedure執行目錄準備程序檔

步驟
  1. 在安裝 Directory Server 的伺服器上,以超級使用者 (root) 身份登入或成為超級使用者。

  2. 如有必要,請啟動 Directory Server。

  3. 變更至 /opt/SUNWcomds/sbin 目錄。

    或者,如果需要,可從 /opt/SUNWcomds/lib 中找到 .zip 檔案

  4. 在無訊息模式或互動式模式中,執行目錄準備程序檔。如需更多步驟,請參閱執行目錄準備程序檔執行目錄準備程序檔

    若要執行此程序檔,請使用做為共用元件提供的或是使用 Java Enterprise System 安裝程式自動安裝的 Perl 版本。安裝完畢後,該 Perl 位於以下目錄:

    ds_svr_base/bin/slapd/admin/bin/perl

在無訊息模式中執行

若要在無訊息模式中執行目錄準備程序檔,請發出 Perl 指令,後跟使用comm_dssetup.pl 語法中所示語法的選項字串。所有選項引數均為必需。表 2–1 說明了這些選項。

公用程式建立以下 LDIF 檔案和 shell 程序檔以更新 LDAP 目錄索引和模式:

/var/tmp/dssetup_timestamp.ldif 
/var/tmp/dssetup_timestamp.sh

公用程式是否透過執行新的程序檔更新 Directory Server 視您發送的選項值而定。如果您已選擇不繼續更新,則可先檢查程序檔並做出任何所需的修改,稍後再執行實際更新。

comm_dssetup.pl 語法

以下是在無訊息模式中執行所需的所有選項:


perl comm_dssetup.pl
    -i yes|no
    -R yes|no
    -c DirectoryServerRoot
    -d DirectoryInstance
    -r DCTreeSuffix
    -u UserGroupSuffix
    -s yes|no
    -D DirectoryManagerDN
    -w DirectoryManagerPassword
    -b yes|no -t 1|1.5|2
    -m yes|no
   [-S PathtoSchemaFiles]
               
表 2–1 無訊息狀態的選項說明

選項與引數 

說明 

-i yes|no

回答問題:「您要配置新的索引嗎?」 

yes 增加新的 Directory Server 索引。目錄準備程序檔為 icsCalendaricsCalendarOwned 屬性增加索引。

no 不增加索引。

-R yes|no

回答問題:「您要立即重新索引嗎?」-m 選項對這個問題的回答也必須是 yes 才能生效。

-c DirectoryServerRoot

Directory Server 根目錄路徑。例如:/var/opt/mps/ldap

-d DirectoryInstance

Directory Server 實例子目錄。例如:slapd-varrius

-r DCTreeSuffix

DC 樹狀結構根目錄字尾。(僅用於 Schema 1 和 Schema 2 相容模式) 

例如:dc=varrius,dc=sesta,dc=com

-u UserGroupSuffix

使用者和群組根目錄字尾。例如:dc:west,dc=sesta,dc=com

-s yes|no

回答問題:「您要更新模式嗎?」 

yes 更新模式。您必須具有包含模式檔案的 config 目錄。

no 不更新模式。

-D DirectoryManagerDN

目錄管理員辨別名稱 (DN)。此值必須加上雙引號 (" ") 以使目錄準備程序檔可以正確解譯帶有空格的值。

例如:"cn=Directory Manager"

-w DirectoryManagerPassword

目錄管理員 DN 密碼。 

-b yes|no

回答問題:「是否將此目錄伺服器用於使用者和群組?」 

yes 使用此目錄來儲存配置資料和使用者群組資料。

no 使用此目錄僅儲存配置資料。

-t 1|1.5|2

模式版本: 

  • 1 Sun LDAP Schema 1

  • 1.5 Sun LDAP Schema 2 相容模式

  • 2 Sun LDAP Schema 2 原生模式

-m yes|no

回答問題:「您要修改目錄伺服器嗎?」 

yes 修改 Directory Server,但不提示使用者。

no 不修改 Directory Server,也不提示使用者。

-S PathtoSchemaFiles

模式檔案所在目錄的路徑。例如: ./schema

Procedure在互動式模式中執行

若要在互動模式中執行目錄準備程序檔,請在不使用任何引數的情況下執行程序檔,然後輸入您選擇的所提問題。

以下清單依面板順序提供有關如何使用互動模式程序檔的說明。

步驟
  1. 歡迎和簡介面板


    # cd /opt/SUNWcomds/sbin
    # ./comm_dssetup.pl
    
    Welcome to the Directory Server preparation tool for 
    Sun Java System Communications Services.
    (Version 6.3 Revision 0.1)
    This tool prepares your directory server for use by the
    communications services which include Messaging, 
    Calendar and their components.
    The logfile is /var/tmp/dssetup_YYYYMMDDHHSS
    Do you want to continue [y]:

    按下 Enter 繼續,或鍵入 no,然後按下 Enter 結束。

  2. Directory Server 的安裝根目錄面板


    Please enter the full path to the directory where the 
            Sun Java System Directory Server was installed.
    Directory server root [/var/opt/mps/serverroot]

    指定 Directory Server 的安裝根目錄的位置,或按下 Enter 接受預設值。

  3. Directory Server 實例面板

    如果該機器上有多個 Directory Server 實例,則程式會將其列出並要求您選擇一個。


    Please select a directory server instance from the following list:
           [1] slapd-varrius
    Which instance do you want [1]:

    輸入與您的選擇對應的數字,然後按下 Enter。或者,不輸入數字,直接按下 Enter 接受預設。

  4. 目錄管理員辨別名稱 (DN) 面板

    此面板有兩部分,請輸入目錄管理員 DN 和目錄管理員的密碼。

    1. 首先,程序檔要求您輸入目錄管理員的辨別名稱 (DN):


      Please enter the directory manager DN [cn=Directory Manager]:

      目錄管理員 DN (預設為 cn=Directory Manager) 是負責組織樹狀結構中使用者和群組資料的管理員。請確定您在此程序檔中指定的目錄管理員 DN 與您為安裝 Directory Server 和配置 Calendar Server 而設定的 DN 相同。

      請輸入目錄管理員 DN,或按下 Enter 接受預設值。

    2. 然後程序檔會要求您輸入目錄管理員的密碼。


      Password:

      請輸入目錄管理員密碼並按下 Enter。

      程式會檢查 Directory Server 是否正在執行並偵聽連接埠 389 (預設連接埠)。

      如果成功,將顯示偵測到的版本,如以下範例中所示:


      Detected DS version 5.2

      如果不成功,將通知您無法偵測到正在執行或偵聽連接埠 389 的 Directory Server,並會引導您修正此問題,然後才允許您繼續。程序檔結束。以下範例顯示這種情況下的輸出:


      Directory Server not running or not listening to port 389.
      Detected DS version 0.0
      Please correct the problem and re-run this script.
  5. [使用者和群組 Directory Server] 面板


    Will this directory server be used for users/groups [Yes]:

    如果此目錄實例僅用於儲存配置資料,請輸入 No,或按下 Enter 接受預設值。

    如果您輸入 No,則還必須對儲存使用者和群組資料的目錄實例執行此程序檔。(請在執行配置程式 csconfigurator.sh 之前執行此作業。)

    如果您回答 yes,則必須為組織樹狀結構指定使用者和群組基底字尾。

  6. 使用者和群組基底字尾面板


    Please enter the Users/Groups base suffix [o=usergroup]:

    使用者和群組基底字尾是 LDAP 組織樹狀結構的頂層項目。確定在此選擇的字尾與為 Directory Server、Calendar Server 和 Access Manager 指定的字尾相同。

  7. [模式類型] 面板


    There are 3 possible schema types:
    1-schema 1 for systems with Calendar or Messaging 5.x data
    1.5-schema 2 compatibility for systems with Calendar or Messaging 5.x
        data that has been converted with the Schema Migration Utility 
        commdirmig
    2-schema 2 native for systems using Access Manager
    Please enter the Schema Type (1, 1.5, 2) [1]:

    輸入模式類型,或按下 Enter 接受預設值。


    備註 –

    若要使用 Schema 2 (選項 1.52),則必須安裝和配置 Access Manager。否則,目錄準備程序檔將會終止。您必須在重新執行目錄準備程序檔之前,安裝 Access Manager。


  8. [網域元件 (DC) 樹狀結構基底字尾] 面板

    如果您選擇 Schema 1 或 Schema 2 相容模式,則系統會要求您提供 DC 樹狀結構基底字尾。如果您選擇 Schema 2 原生模式,則系統不會詢問此問題。


    Please enter the DC Tree base suffix [o=internet]:

    在之前說明的 [模式類型面板] 中,如果您選擇 Schema 1 或 Schema 2 相容模式,系統將要求您提供 DC 樹狀結構基底字尾。如果您選擇 Schema 2 原生模式,則系統不會詢問此問題。

    DC 樹可鏡射本機 DNS 結構,系統會使用 DC 樹作為包含使用者資料項目和群組資料項目的組織樹的索引。DC 樹狀結構基底字尾是 DC 樹狀結構上頂層項目的名稱。

    輸入字尾,或按下 Enter 接受預設值。

  9. [系列問題] 面板

    這個後續面板會提出一系列有關對您的 LDAP 進行更新的問題。

    1. 更新模式檔案

      此時程式會檢查您的模式是否具有正確的模式元素。如果您的模式缺少某些元素,本程式將輸出以下訊息:


      Detected bad schema elements in 99user.ldif. 
      It is recommended that you update the schema.
      
      Do you want to update the schema files [yes]:

      回答 Yes 以將所需的新元素增加至您的模式。在每次安裝新版 Calendar Server 或 Messaging Server 時,均需使用新的模式檔案來更新目錄。

      如果您想延遲更新模式檔案,請回答 No

    2. 配置新的索引

      如果上一步您選擇更新模式,系統將詢問您是否希望配置新的索引。如需有關為屬性建立索引的更多資訊,請參閱屬性索引


      Do you want to configure new indexes [yes]:

      若同意配置索引,請按下 Enter。

      如果您已為相同屬性執行此建立索引步驟,請回答 no

    3. 立即重新索引

      您可以選擇現在建立索引或者稍後建立索引。如果您選擇推遲建立索引,則請在方便時重新執行該程序檔並選擇建立索引。建立索引可能需要很長的時間,但是 Directory Server 仍可發揮其功能,也就是說,它在建立索引期間並未處於唯讀模式。


      Reindex now [yes]?

      如果您想稍後再建立索引,請回答 no,否則,請按下 Enter 接受預設值。

  10. [設定摘要] 面板

    目錄準備程序檔在更新 Directory Server 配置之前,會顯示您的設定摘要,然後詢問您是否繼續。


    Here is a summary of the settings that you chose:
      Server Root                    : /var/opt/mps/serverroot/
      Server Instance                : slapd-varrius
      Users/Groups Directory         : yes
      Update Schema                  : yes
      Schema Type                    : 1
      DC Root                        : o=internet
      User/Group Root                : dc=red,dc=sesta,dc=com
      Add New Indexes                : yes
      Reindex New Indexes Now        : yes
      Directory Manager DN           : cn=Directory Manager
    
    Now ready to generate a shell script and ldif file to modify the
    Directory. 
    No changes to the Directory Server will be made this time.
    Do you want to continue [Y]:

    如果您在執行目錄準備程序檔中選擇 Schema 2 原生模式,則 DC 根將與您為使用者/群組根輸入的值相同。

    若要變更任何設定,請輸入 no,然後重新執行程序檔。

    如果您想繼續,請按下 Enter。目錄準備程序檔會產生一個 LDIF 檔案和一個 shell 程序檔。其建立的檔案名稱如下:


    /var/tmp/dssetup_timestamp.ldif
     /var/tmp/dssetup_timestamp.sh

    如果選擇繼續,程式運行時將列印訊息。以下是您將看到的輸出範例:


    Generating files...
    
    Checking to see if Suffixes need to be added
    
    Checking to see that uid uniqueness plugins are turned off
    
    Adding indexes
      Adding Indexes for User/group Tree (backend:userRoot)
        Checking indexes for member
          No new indexes required
        Checking indexes for mailAlternateAddress
          No new indexes required
        Checking indexes for mail
          No new indexes required
        Checking indexes for mailEquivalentAddress
          No new indexes required
        Checking indexes for cosspecifier
          No new indexes required
      Adding Indexes for DC Tree (backend:internetdb2)
        Checking indexes for inetCanonicalDomainName
          No new indexes required
        Checking indexes for inetDomainBaseDN
          No new indexes required
      Adding Indexes for PAB Tree (backend:pabdb2)
        Checking indexes for memberOfPAB
          No new indexes required
        Checking indexes for icsCalendar
          No new indexes required
        Checking indexes for un
          No new indexes required
        Checking indexes for memberOfPABGroup
          No new indexes required
        Checking indexes for icsCalendarOwned
          No new indexes required
        Checking indexes for memberOfManagedGroup
          No new indexes required
      Adding Indexes for New PAB Tree (backend:PiServerDbdb2)
        Checking indexes for MemberOfPiBook
          No new indexes required
        Checking indexes for MemberofPiGroup
          No new indexes required
        Checking indexes for displayname
          No new indexes required
    
    Checking to see if DN needs to be created for suffixes 
    Generating ldif for installer metadata
      Generating ldif for Adding schema for installer metadata
      Generating ldif for updating DN for cn=CommServers,o=comms-config
    The following files have been created:
       /var/tmp/dssetup_20041209114027.sh
       /var/tmp/dssetup_20041209114027.ldif
    
    Running /var/tmp/dssetup_20041209114027.sh will make changes 
      to the Directory. You can run this file now or at a later time
    Ready to execute the script now.
  11. 執行程序檔


    Do you want to continue [yes]:

    按下 Enter 接受預設設定 (yes)。dssetup_timestamp.sh 程序檔針對 LDAP 目錄執行。如果您不希望立即執行該程序檔,請輸入 No 結束。如果結束,您可以稍後執行 /var/tmp/dssetup_ timestamp.sh 程序檔。

    以下是程序檔執行時產生的文字輸出範例:


    Running /var/tmp/dssetup_20041209114027.sh 
       -D "cn=Directory Manager"
       -j /var/tmp/dssetup_20041209114027.pw
    Stopping Directory Server
    Updating Schema files...
    Copying 20subscriber.ldif
    Copying 50ns-delegated-admin.ldif
    Copying 50ns-mail.ldif
    Copying 50ns-mlm.ldif
    Copying 50ns-msg.ldif
    Copying 50ns-value.ldif
    Copying 55ims-ical.ldif
    Copying 56ims-schema.ldif
    Copying 70sun-schema2.ldif
    Copying 71sun-am.ldif
    Copying 60iplanet-calendar.ldif
    Copying 50ns-iabs.ldif
    Copying 98ns-dummy-uwc.ldif
    Copying 70delgated-admin.ldif
    Copying /var/tmp/99user_20041209114027.ldif to 
            /var/opt/mps/serverroot/slapd-varrius/config/schema/99user.ldif
    Starting Directory Server
    Applying ldif file /var/tmp/dssetup_20041209114027.ldif
    modifying entry cn=schema
    
    modifying entry cn=schema
    
    modifying entry cn=CommServers,o=comms-config
    
    Done Applying ldif file /var/tmp/dssetup_20041209114027.ldif
    rejects to /var/tmp/dssetup_20041209114027.ldif.rej status = 0
    Successful Completion. 
    Consult /var/tmp/dssetup_20041209114027.log for details