.. _configuring-traffic-server:

Configuring Traffic Server
**************************

.. Licensed to the Apache Software Foundation (ASF) under one
   or more contributor license agreements.  See the NOTICE file
   distributed with this work for additional information
   regarding copyright ownership.  The ASF licenses this file
   to you under the Apache License, Version 2.0 (the
   "License"); you may not use this file except in compliance
   with the License.  You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing,
   software distributed under the License is distributed on an
   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
   KIND, either express or implied.  See the License for the
   specific language governing permissions and limitations
   under the License.

Traffic Server provides several options for configuring the system.

.. toctree::
   :maxdepth: 2

.. _configure-using-traffic-line:

Configure Traffic Server Using Traffic Line
===========================================

Traffic Line enables you to quickly and easily change your Traffic
Server configuration via command-line interface.

View Configuration Options in Traffic Line
------------------------------------------

To view a configuration setting, enter the following command::

    traffic_line -r var

where ``var`` is the variable associated with the configuration
option. For a list of variables, refer to :ref:`configuration-variables`.

Change Configuration Options in Traffic Line
--------------------------------------------

To change the value of a configuration setting, enter the following
command::

    traffic_line -s var -v value

where ``var`` is the variable associated with the configuration option
and ``value`` is the value you want to use. For a list of the
variables, see :ref:`configuration-variables`.

Configure Traffic Server Using Configuration Files
==================================================

As an alternative to using Traffic Line or Traffic Shell, you can change
Traffic Server configuration options by manually editing specific
variables in the :file:`records.config` file.
After modifying the :file:`records.config`  file,
Traffic Server must reread the configuration files: enter the Traffic
Line command :option:`traffic_line -x`. You may need to restart Traffic Server
to apply some of the configuration changes.

The following is a sample portion of the
:file:`records.config` file:

.. figure:: ../static/images/admin/records.jpg
   :align: center
   :alt: Sample records.config file

   Sample records.config file

In addition to the :file:`records.config` file,
Traffic Server provides other configuration files that are used to
configure specific features. You can manually edit all configuration
files as described in :ref:`configuration-file-reference`.