NAME

       calendarserver_manage_timezones — Calendar Server timezone database management utility

SYNOPSIS

       calendarserver_manage_timezones   [-f  file]  [-h]  [-x  file]  [-z  directory]  [--tzvers  tzdb-version]
                                       [--url url] [--refresh]  [--refreshpkg]  [--create]  [--update]  [--list]
                                       [--changed date] [--cache]

DESCRIPTION

       calendarserver_manage_timezones  This  utility  will  create,  update,  or  list an XML timezone database
       summary XML file, or refresh timezone data from IANA, or refresh  timezone  data  from  another  timezone
       server.

       It can also be used to update the server's own zoneinfo database from IANA.

       It  should  be  run as a user with the same privileges as the Calendar Server itself, as it needs to read
       and write data that belongs to the server. If using the --refreshpkg option it will need to write to  the
       actual python package data so will need to be run as root.

       Actions to perform are specified via the options below.  Only one action is allowed.

OPTIONS

       -h    Displays usage information

       -f FILE
             Use   the   Calendar   Server   configuration   specified   in   the   given   file.   Defaults  to
             /etc/caldavd/caldavd.plist.

       -x FILE
             Update the timezone database XML file at the specified location.  Defaults to timezones.xml in  the
             zoneinfo directory.

       -z DIRECTORY
             Path  to  a zoneinfo directory where timezone data is stored.  Defaults to the configuration file's
             Data/zoneinfo directory.

       --tzvers version
             Name of IANA timezone data version to use (e.g., '2013a').

       --url
             If the server is configured as a secondary timezone zone, use this URL as the URL of the  secondary
             server to pull timezone data from.

ACTIONS

       --refresh
             Update the zoneinfo data from the IANA registry.

       --refreshpkg
             Update   the   server's   zoneinfo   package   data   from   the   IANA   registry.   This  updates
             twistedcaldav.zoneinfo and should only be used by server developers wishing to  update  the  server
             repository.

       --create
             Create  a  new  timezone  database  XML  file  based on the timezone data currently in the zoneinfo
             directory.

       --update
             Update the timezone database XML file  based  on  the  timezone  data  currently  in  the  zoneinfo
             directory.

       --list
             List the timezones specified in the timezone database XML file.

       --changed date
             List  the  timezones  in  the timezone database XML file that have changed since the specified date
             value (YYYYMMHH).

       --cache
             Update the server's timezone database by pulling data from a primary timezone server.

EXAMPLES

       Update the server's timezone data from the latest IANA data:

             calendarserver_manage_timezones --refesh

FILES

       /etc/caldavd/caldavd.plist
             The Calendar Server configuration file.

SEE ALSO

       caldavd(8)

Debian                                            May 11, 2013                CALENDARSERVER_MANAGE_TIMEZONES(8)