NAME

       traffic_ctl - Traffic Server command line tool

SYNOPSIS

       traffic_ctl [OPTIONS] SUBCOMMAND [OPTIONS]

DESCRIPTION

       traffic_ctl  is  used  to  display  and  manipulate  configure  a  running Traffic Server.
       traffic_ctl includes a number of subcommands that control  different  aspects  of  Traffic
       Server:

       traffic_ctl alarm
              Display and manipulate Traffic Server alarms

       traffic_ctl cluster
              Stop, restart and examine the cluster

       traffic_ctl config
              Manipulate and display configuration records

       traffic_ctl metric
              Manipulate performance and status metrics

       traffic_ctl server
              Stop, restart and examine the server

       traffic_ctl storage
              Manipulate cache storage

       traffic_ctl plugin
              Interact with plugins.

OPTIONS

       --debug
              Enable debugging output.

       -V, --version
              Print version information and exit.

SUBCOMMANDS

   traffic_ctl alarm
       list   List all alarm events that have not been acknowledged (cleared).

       clear  Clear (acknowledge) all current alarms.

       resolve ALARM [ALARM...]
              Clear (acknowledge) an alarm event. The arguments are a specific alarm number (e.g.
              ''1''), or an alarm string identifier (e.g.  ''MGMT_ALARM_PROXY_CONFIG_ERROR'').

   traffic_ctl cluster
       restart [--drain] [--manager]
              Shut down and immediately restart Traffic Server, node by node across the  cluster.
              The  --drain  and  --manager  options have the same behavior as for the traffic_ctl
              server restart subcommand.

       status Show the current cluster status.

   traffic_ctl config
       defaults [--records]
              Display the default values for all configuration records. The  --records  flag  has
              the same behavior as traffic_ctl config get --records.

       describe RECORD [RECORD...]
              Display  all the known information about a configuration record.  This includes the
              current and default values, the data type, the record  class  and  syntax  checking
              expression.

       diff [--records]
              Display  configuration records that have non-default values. The --records flag has
              the same behavior as traffic_ctl config get --records.

       get [--records] RECORD [RECORD...]
              Display the current value of a configuration record.

       --records
              If  this  flag  is  provided,  traffic_ctl  config  get  will   emit   results   in
              records.config format.

       match [--records] REGEX [REGEX...]
              Display  the  current  values  of all configuration variables whose names match the
              given regular expression. The --records flag has the same behavior  as  traffic_ctl
              config get --records.

       reload Initiate  a  Traffic  Server  configuration  reload. Use this command to update the
              running  configuration  after  any   configuration   file   modification.   If   no
              configuration  files have been modified since the previous configuration load, this
              command is a no-op.

              The timestamp of the  last  reconfiguration  event  (in  seconds  since  epoch)  is
              published in the proxy.node.config.reconfigure_time metric.

       set RECORD VALUE
              Set  the  named  configuration  record  to  the  specified  value.   Refer  to  the
              records.config documentation for a list of  the  configuration  variables  you  can
              specify. Note that this is not a synchronous operation.

       status Display  detailed  status  about  the  Traffic  Server  configuration  system. This
              includes version information, whether the internal configuration store  is  current
              and whether any daemon processes should be restarted.

   traffic_ctl metric
       clear [--cluster]
              Reset  all statistics to zero. The --cluster option applies this across all cluster
              nodes.

       get METRIC [METRIC...]
              Display the current value of the specifies statistics.

       match REGEX [REGEX...]
              Display the current values of all statistics whose names match  the  given  regular
              expression.

       zero [--cluster] METRIC [METRIC...]
              Reset  the  named  statistics to zero. The --cluster option applies this across all
              cluster nodes.

   traffic_ctl server
       restart
              Shut down and immediately restart Traffic Server

       --drain
              This  option  modifies  the  behavior  of  traffic_ctl  server  restart  such  that
              traffic_server is not shut down until the number of active client connections drops
              to   the   number   given   by   the   proxy.config.restart.active_client_threshold
              configuration variable.

       --manager
              The default behavior of traffic_ctl server restart is to restart traffic_server. If
              this option is specified, traffic_manager is also restarted.

       start  Start traffic_server if it is already running.

       --clear-cache
              Clear the disk cache upon startup.

       --clear-hostdb
              Clear the DNS resolver cache upon startup.

       status Show the current proxy server status, indicating if we're running or not.

       stop   Stop the running traffic_server process.

       backtrace
              Show a full stack trace of all the traffic_server threads.

   traffic_ctl storage
       offline PATH [PATH ...]
              Mark a cache storage device as offline. The storage is  identified  by  PATH  which
              must  match  exactly  a  path specified in storage.config. This removes the storage
              from the cache and redirects requests that would have used this  storage  to  other
              storage.  This has exactly the same effect as a disk failure for that storage. This
              does not persist across restarts of the traffic_server process.

   traffic_ctl plugin
       msg TAG DATA
              Send   a   message   to   plugins.   All   plugins    that    have    hooked    the
              TSLifecycleHookID::TS_LIFECYCLE_MSG_HOOK will receive a callback for that hook. The
              TAG and DATA will be available to the plugin hook processing. It is  expected  that
              plugins  will  use  TAG to select relevant messages and determine the format of the
              DATA.

EXAMPLES

       Configure Traffic Server to log in Squid format:

          $ traffic_ctl config set proxy.config.log.squid_log_enabled 1
          $ traffic_ctl config set proxy.config.log.squid_log_is_ascii 1
          $ traffic_ctl config reload

SEE ALSO

       records.config(5), storage.config(5)

COPYRIGHT

       2018, dev@trafficserver.apache.org