Cisco UCS Central CLI Configuration Guide, Release 1.0
Managing Time Zones
Downloads: This chapterpdf (PDF - 351.0KB) The complete bookPDF (PDF - 2.17MB) | The complete bookePub (ePub - 408.0KB) | Feedback

Managing Time Zones

Managing Time Zones

This chapter includes the following sections:

Date and Time Policies

Cisco UCS Central supports global date and time policies based on international time zones and defined NTP server. Registered Cisco UCS Manager clients choosing to define date and time globally within that client's policy resolution control will defer the configuration for date and time to its registration with Cisco UCS Central.

Configuring a Date and Time Policy

Procedure
      Command or Action Purpose
    Step 1 UCSC# connect policy-mgr  

    Enters policy manager mode.

     
    Step 2 UCSC(policy-mgr)# scope domain-group domain-group  

    Enters domain group root mode and (optionally) enters a domain group under the domain group root. To enter the domain group root mode, type / as the domain-group.

     
    Step 3 UCSC(policy-mgr) /domain-group # create domain-group domain-group   (Optional)

    This step is only necessary to create a new domain group under the Domain Group root (or creates a domain group under the domain group scoped into).

     
    Step 4 UCSC(policy-mgr) /domain-group* # commit-buffer   (Optional)

    This step is only necessary after creating a new domain group under the Domain Group root (or creating a domain group under the domain group scoped into). Commits the new domain group to the system configuration.

     
    Step 5 UCSC(policy-mgr) /domain-group # create timezone-ntp-config   (Optional)

    This step is only necessary the first time a date and time policy is configured for the newly created domain group under the Domain Group root that was created in the previous step, then enter the time zone NTP configuration mode. A date and time policy was created by the system for the Domain Group root, and is ready to be configured.

     
    Step 6 UCSC(policy-mgr) /domain-group* # scope timezone-ntp-config   (Optional)

    This step is only necessary if entering an existing date and time policy's time zone NTP configuration mode from the Domain Group root or a domain group scoped into. Skip this step if creating a date and time policy.

     
    Step 7 UCSC(policy-mgr) /domain-group/timezone-ntp-config* # set timezone  

    To set the time zone, press Enter after typing the set timezone command and enter the key value at the prompt. Configures the NTP server time zone. The attribute options are as follows:

    • 1 —Africa
    • 2 —Americas
    • 3 —Antarctica
    • 4 —Arctic Ocean
    • 5 —Asia
    • 6 —Atlantic Ocean
    • 7 —Australia
    • 8 —Europe
    • 9 —India Ocean
    • 10 —Pacific Ocean
     
    Step 8 UCSC(policy-mgr) /domain-group/timezone-ntp-config* # commit-buffer  

    Commits the transaction to the system configuration.

     

    The following example shows how to scope the Domain Group root, configure the time zone setting to India Ocean ("a continent or ocean") and Maldives ("a country"), and commit the transaction:

    UCSC # connect policy-mgr
    UCSC(policy-mgr)# scope domain-group /
    UCSC(policy-mgr) /domain-group # scope timezone-ntp-config
    UCSC(policy-mgr) /domain-group/timezone-ntp-config # set timezone
    Please identify a location so that time zone rules can be set correctly.
    Please select a continent or ocean.
    1) Africa            4) Arctic Ocean     7) Australia       10) Pacific Ocean
    2) Americas          5) Asia             8) Europe
    3) Antarctica        6) Atlantic Ocean   9) Indian Ocean
    #? 9
    Please select a country.
    1) British Indian Ocean Territory       7) Maldives
    2) Christmas Island                     8) Mauritius
    3) Cocos (Keeling) Islands              9) Mayotte
    4) Comoros                             10) Reunion
    5) French Southern & Antarctic Lands   11) Seychelles
    6) Madagascar
    #? 7
    The following information has been given:
            Maldives
    Therefore timezone 'Indian/Maldives' will be set.
    Local time is now:      Thu Oct 25 01:58:03 MVT 2012.
    Universal Time is now:  Wed Oct 24 20:58:03 UTC 2012.
    Is the above information OK?
    1) Yes
    2) No
    #? 1
    UCSC(policy-mgr) /domain-group/timezone-ntp-config* # commit-buffer
    UCSC(policy-mgr) /domain-group/timezone-ntp-config # 
    
    

    The following example shows how to create a new domain group called domaingroup01 under the Domain Group root, commit the transaction, create a date and time policy, configure the time zone setting to India Ocean ("a continent or ocean") and Maldives ("a country"), and commit the transaction:

    UCSC # connect policy-mgr
    UCSC(policy-mgr)# scope domain-group /
    UCSC(policy-mgr) /domain-group # create domain-group domaingroup01
    UCSC(policy-mgr) /domain-group* # commit-buffer
    UCSC(policy-mgr) /domain-group # create timezone-ntp-config
    UCSC(policy-mgr) /domain-group/timezone-ntp-config # set timezone
    Please identify a location so that time zone rules can be set correctly.
    Please select a continent or ocean.
    1) Africa            4) Arctic Ocean     7) Australia       10) Pacific Ocean
    2) Americas          5) Asia             8) Europe
    3) Antarctica        6) Atlantic Ocean   9) Indian Ocean
    #? 9
    Please select a country.
    1) British Indian Ocean Territory       7) Maldives
    2) Christmas Island                     8) Mauritius
    3) Cocos (Keeling) Islands              9) Mayotte
    4) Comoros                             10) Reunion
    5) French Southern & Antarctic Lands   11) Seychelles
    6) Madagascar
    #? 7
    The following information has been given:
            Maldives
    Therefore timezone 'Indian/Maldives' will be set.
    Local time is now:      Thu Oct 25 01:58:03 MVT 2012.
    Universal Time is now:  Wed Oct 24 20:58:03 UTC 2012.
    Is the above information OK?
    1) Yes
    2) No
    #? 1
    UCSC(policy-mgr) /domain-group/timezone-ntp-config* # commit-buffer
    UCSC(policy-mgr) /domain-group/timezone-ntp-config # 
    
    

    The following example shows how to scope to domaingroup01 under the Domain Group root, create a date and time policy, configure the time zone setting to India Ocean ("a continent or ocean") and Maldives ("a country"), and commit the transaction:

    UCSC # connect policy-mgr
    UCSC(policy-mgr) /domain-group # scope domain-group domaingroup01
    UCSC(policy-mgr) /domain-group # create timezone-ntp-config
    UCSC(policy-mgr) /domain-group/timezone-ntp-config* # set timezone
    Please identify a location so that time zone rules can be set correctly.
    Please select a continent or ocean.
    1) Africa            4) Arctic Ocean     7) Australia       10) Pacific Ocean
    2) Americas          5) Asia             8) Europe
    3) Antarctica        6) Atlantic Ocean   9) Indian Ocean
    #? 9
    Please select a country.
    1) British Indian Ocean Territory       7) Maldives
    2) Christmas Island                     8) Mauritius
    3) Cocos (Keeling) Islands              9) Mayotte
    4) Comoros                             10) Reunion
    5) French Southern & Antarctic Lands   11) Seychelles
    6) Madagascar
    #? 7
    The following information has been given:
            Maldives
    Therefore timezone 'Indian/Maldives' will be set.
    Local time is now:      Thu Oct 25 01:58:03 MVT 2012.
    Universal Time is now:  Wed Oct 24 20:58:03 UTC 2012.
    Is the above information OK?
    1) Yes
    2) No
    #? 1
    UCSC(policy-mgr) /domain-group/timezone-ntp-config* # commit-buffer
    UCSC(policy-mgr) /domain-group/timezone-ntp-config # 
    
    What to Do Next

    Configure an NTP server for a date and time policy.

    Deleting a Date and Time Policy

    Procedure
        Command or Action Purpose
      Step 1 UCSC# connect policy-mgr  

      Enters policy manager mode.

       
      Step 2 UCSC(policy-mgr)# scope domain-group domain-group  

      Enters a domain group under the domain group root.

      Note   

      Do not enter the domain group root itself. System default date and time policies cannot be deleted under the domain group root.

       
      Step 3 UCSC(policy-mgr) /domain-group # delete timezone-ntp-config  

      Deletes the domain group's time zone policy.

       
      Step 4 UCSC(policy-mgr) /domain-group* # commit-buffer  

      Commits the transaction to the system configuration.

       

      The following example shows how to scope the domain group domaingroup01, delete that domain group's date and time policy, and commit the transaction:

      UCSC # connect policy-mgr
      UCSC(policy-mgr)# scope domain-group domaingroup01
      UCSC(policy-mgr) /domain-group # delete timezone-ntp-config
      UCSC(policy-mgr) /domain-group* # commit-buffer
      UCSC(policy-mgr) /domain-group # 
      
      

      The following example shows how to scope the domain group root, attempt to delete that domain group's date and time policy, commit the transaction and recover from an error message (leaving the buffer in an unrecoverable uncommitted state) by initiating a clean exit and reconnecting to Policy Manager to clear the buffer:

      UCSC # connect policy-mgr
      UCSC(policy-mgr)# scope domain-group /
      UCSC(policy-mgr) /domain-group # delete timezone-ntp-config
      UCSC(policy-mgr) /domain-group* # commit-buffer
      Error: Update failed: 
      [Timezone and NTP configuration under domain group root cannot be deleted]
      UCSC(policy-mgr) /domain-group* # exit
      UCSC(policy-mgr)* # exit
      UCSC# connect policy-mgr
      Cisco UCS Central
      UCSC(policy-mgr)# 
      

      Note


      In the event you mistakenly scope to the domain group root, and enter the command delete timezone-ntp-config, the buffer will encounter an unrecoverable error, remaining in an uncommitted state and preventing subsequent commit-buffer commands from saving to the buffer. You must immediately exit and reconnect to the Policy Manager to clear the buffer.


      Configuring an NTP Server for a Date and Time Policy

      Procedure
          Command or Action Purpose
        Step 1 UCSC# connect policy-mgr  

        Enters policy manager mode.

         
        Step 2 UCSC(policy-mgr)# scope domain-group domain-group  

        Enters domain group root mode and (optionally) enters a domain group under the domain group root. To enter the domain group root mode, type / as the domain-group.

         
        Step 3 UCSC(policy-mgr) /domain-group # scope timezone-ntp-config  

        Enters time zone NTP configuration mode.

         
        Step 4 UCSC(policy-mgr) /domain-group/timezone-ntp-config # create ntp server-name  

        Creates an NTP server instance.

         
        Step 5 UCSC(policy-mgr) /domain-group/timezone-ntp-config* # commit-buffer  

        Commits the transaction to the system configuration.

         

        The following example shows how to scope into the domain group root, create an NTP server instance named domaingroupNTP01, and commit the transaction:

        UCSC # connect policy-mgr
        UCSC(policy-mgr)# scope domain-group /
        UCSC(policy-mgr) /domain-group # scope timezone-ntp-config
        UCSC(policy-mgr) /domain-group/timezone-ntp-config # create ntp domaingroupNTP01
        UCSC(policy-mgr) /domain-group/timezone-ntp-config* # commit-buffer
        UCSC(policy-mgr) /domain-group/timezone-ntp-config # 
        
        

        The following example shows how to scope to the domain group domaingroup01 under the domain group root, create an NTP server instance named domaingroupNTP01, and commit the transaction:

        UCSC # connect policy-mgr
        UCSC(policy-mgr)# scope domain-group domaingroup01
        UCSC(policy-mgr) /domain-group # scope timezone-ntp-config
        UCSC(policy-mgr) /domain-group/timezone-ntp-config # create ntp domaingroupNTP01
        UCSC(policy-mgr) /domain-group/timezone-ntp-config* # commit-buffer
        UCSC(policy-mgr) /domain-group/timezone-ntp-config # 
        
        What to Do Next

        Configure a date and time policy.

        Configuring Properties for an NTP Server

        The properties of an NTP server consist of its name. Changing those properties, unlike steps in the GUI involving configuring the NTP server's properties, requires deleting that NTP server and recreating it with a new name.

        Procedure
            Command or Action Purpose
          Step 1 UCSC# connect policy-mgr  

          Enters policy manager mode.

           
          Step 2 UCSC(policy-mgr)# scope domain-group domain-group  

          Enters domain group root mode and (optionally) enters a domain group under the domain group root. To enter the domain group root mode, type / as the domain-group.

           
          Step 3 UCSC(policy-mgr) /domain-group # scope timezone-ntp-config  

          Enters time zone NTP configuration mode.

           
          Step 4 UCSC(policy-mgr) /domain-group/timezone-ntp-config # delete ntp server-name  

          Deletes an NTP server instance that requires renaming.

           
          Step 5 UCSC(policy-mgr) /domain-group/timezone-ntp-config* # create ntp server-name  

          Creates an NTP server instance to replace the deleted NTP server instance.

           
          Step 6 UCSC(policy-mgr) /domain-group/timezone-ntp-config* # commit-buffer  

          Commits the transaction to the system configuration.

           

          The following example shows how to scope into the domain group root, delete an NTP server instance named domaingroupNTP01 with a name that is no longer relevant, create a new NTP server instance named domaingroupNTP02 to replace the deleted NTP server, and commit the transaction:

          UCSC # connect policy-mgr
          UCSC(policy-mgr)# scope domain-group /
          UCSC(policy-mgr) /domain-group # scope timezone-ntp-config
          UCSC(policy-mgr) /domain-group/timezone-ntp-config # delete ntp domaingroupNTP01
          UCSC(policy-mgr) /domain-group/timezone-ntp-config* # create ntp domaingroupNTP02
          UCSC(policy-mgr) /domain-group/timezone-ntp-config* # commit-buffer
          UCSC(policy-mgr) /domain-group/timezone-ntp-config # 
          
          

          The following example shows how to scope to the domain group domaingroup01 under the domain group root, delete an NTP server instance named domaingroupNTP01 with a name that is no longer relevant, create a new NTP server instance named domaingroupNTP02 to replace the deleted NTP server, and commit the transaction:

          UCSC # connect policy-mgr
          UCSC(policy-mgr)# scope domain-group domaingroup01
          UCSC(policy-mgr) /domain-group # scope timezone-ntp-config
          UCSC(policy-mgr) /domain-group/timezone-ntp-config # delete ntp domaingroupNTP01
          UCSC(policy-mgr) /domain-group/timezone-ntp-config* # create ntp domaingroupNTP02
          UCSC(policy-mgr) /domain-group/timezone-ntp-config* # commit-buffer
          UCSC(policy-mgr) /domain-group/timezone-ntp-config # 
          

          Deleting an NTP Server for a Date and Time Policy

          Procedure
              Command or Action Purpose
            Step 1 UCSC# connect policy-mgr  

            Enters policy manager mode.

             
            Step 2 UCSC(policy-mgr)# scope domain-group domain-group  

            Enters domain group root mode and (optionally) enters a domain group under the domain group root. To enter the domain group root mode, type / as the domain-group.

             
            Step 3 UCSC(policy-mgr) /domain-group # scope timezone-ntp-config  

            Enters time zone NTP configuration mode.

             
            Step 4 UCSC(policy-mgr) /domain-group/timezone-ntp-config # delete ntp server-name  

            Deletes an NTP server instance.

             
            Step 5 UCSC(policy-mgr) /domain-group/timezone-ntp-config* # commit-buffer  

            Commits the transaction to the system configuration.

             

            The following example shows how to scope the date and time policy in the domain group root, delete the NTP server instance domaingroupNTP01, and commit the transaction:

            UCSC # connect policy-mgr
            UCSC(policy-mgr)# scope domain-group /
            UCSC(policy-mgr) /domain-group # scope timezone-ntp-config
            UCSC(policy-mgr) /domain-group/timezone-ntp-config # delete ntp domaingroupNTP01
            UCSC(policy-mgr) /domain-group/timezone-ntp-config* # commit-buffer
            UCSC(policy-mgr) /domain-group/timezone-ntp-config # 
            
            

            The following example shows how to scope the date and time policy in domaingroup01 under the domain group root, delete the NTP server instance domaingroupNTP01, and commit the transaction:

            UCSC # connect policy-mgr
            UCSC(policy-mgr)# scope domain-group domaingroup01
            UCSC(policy-mgr) /domain-group # scope timezone-ntp-config
            UCSC(policy-mgr) /domain-group/timezone-ntp-config # delete ntp domaingroupNTP01
            UCSC(policy-mgr) /domain-group/timezone-ntp-config* # commit-buffer
            UCSC(policy-mgr) /domain-group/timezone-ntp-config #