traffic_layout¶
Synopsis¶
traffic_layout SUBCOMMAND [OPTIONS]
Environment¶
-
TS_RUNROOT¶ The path to the run root file. It has the same effect as the command line option
--run-root.
Description¶
Document for the special functionality of runroot inside traffic_layout. This feature
is for the setup of traffic server runroot. It will create a runtime sandbox for any program of
traffic server to run under.
Usage¶
First we need to create a runroot. It can be created simply by calling command init.
traffic_layout init --path /path/to/runroot
A runroot will be created in /path/to/runroot, available for other programs to use.
If the path is not specified, the current working directory will be used.
- To run traffic_manager, for example, using the runroot, there are several ways:
/path/to/runroot/bin/traffic_managertraffic_manager --run-root=/path/to/runroottraffic_manager --run-root=/path/to/runroot/runroot.yamlSet
TS_RUNROOTto/path/to/runrootand runtraffic_managerRun
traffic_managerwith/path/to/runrootas current working directory
Note
if none of the above is found as runroot, runroot will not be used and the program will fall back to the default.
Subcommands¶
init¶
Use the current working directory or the specific path to create runroot. The path can be absolute or relative.
- workflow:
Create a sandbox directory for programs to run under.
Copy and symlink build time directories and files to the sandbox, allowing users to modify freely.
Emit a YAML file that defines layout structure for other programs to use (relative path).
Example:
traffic_layout init (--path /path/to/sandbox/) (--force) (--absolute) (--copy-style=[HARD/SOFT/FULL]) (--layout=special_layout.yml)
For the --layout=[<YAML file>] option, a custom layout can be used to construct a runroot.
Below is an example of customized yaml file (custom.yml) to construct.
prefix: ./runroot
exec_prefix: ./runroot
bindir: ./runroot/custom_bin
sbindir: ./runroot/custom_sbin
sysconfdir: ./runroot/custom_sysconf
datadir: ./runroot/custom_data
includedir: ./runroot/custom_include
libdir: ./runroot/custom_lib
libexecdir: ./runroot/custom_libexec
localstatedir: ./runroot/custom_localstate
runtimedir: ./runroot/custom_runtime
logdir: ./runroot/custom_log
cachedir: ./runroot/custom_cache
If traffic_layout init --layout="custom.yml" is executed, a runroot following the format above will be created.
Note
storage.config does not use the cachedir value, but makes its relatives paths relative to the base prefix.
So please update the directory for cache in storage.config according to the customized runroot.
remove¶
- Find the sandbox to remove in following order:
specified in –path as absolute or relative.
current working directory.
installed directory.
Example:
traffic_layout remove (--path /path/to/sandbox/) (--force)
verify¶
Verify the permission of the sandbox. The permission issues can be fixed with --fix option.
--with-user option can be used to verify the permission of the runroot for specific user.
Example:
traffic_layout verify (--path /path/to/sandbox/) (--fix) (--with-user root)
Options¶
-
--run-root=[<path>]¶ Use the run root file at path.
-
-V,--version¶ Print version information and exit.
-
-h,--help¶ Print usage information and exit.
-
-p,--path¶ Specify the path of runroot for commands (init, remove, verify).
init¶
-
-f,--force¶ Force init will create sandbox even if the directory is not empty.
-
-a,--absolute¶ Put directories in the YAML file in the form of absolute paths when creating.
-
-c,--copy-style[HARD/SOFT/FULL]¶ Specify the way of copying executables when creating runroot. HARD means hard link. SOFT means symlink. FULL means full copy.
-
-l,--layout[<YAML file>]¶ Use specific layout (providing YAML file) to create runroot.