...
Table of Contents | ||
---|---|---|
|
Installing TD Toolbelt
You can install the TD Toolbelt to set up your local workstation with td
, the Treasure Data command-line (CLI) client.
...
Windows and Mac OSX as a prepackaged installer called the Toolbelt.
Linux (Ubuntu Precise and Lucid, RedHat, CentOS) as part of the Treasure Agent (
td-agent
) package.A Ruby 'gem' on any system.
Use the Ruby option if you are already familiar with Ruby and already have it installed in your system.
Windows 64-bit
...
This package contains all the necessary dependencies to allow TD Toolbelt to run on a Windows system and therefore includes a v1.9.3 version of the Ruby environment which will be installed on the system as part of the process.
Navigate to the TD Toolbelt download page.
Select Windows.
Mac OSX v10.8.5 - Mountain Lion
...
Release or
...
Later
This package contains all the necessary dependencies to allow TD Toolbelt to run on a Mac system and therefore includes a v2.0 version of the Ruby environment which will be installed on the system as part of the process.
Navigate to the TD Toolbelt download page.
Select OSx.
Select the downloaded package to install it.
If you receive an error "package can't be opened.." when you try to install the package, select control + mouse click (right-click) and select Open to continue the installation.
Ubuntu and Debian
The TD Toolbelt is distributed on Linux as part of the td-agent
package.
This package contains all the necessary dependencies to allow the td-agent and td on the CLI to run on a Linux system, including the version of Ruby these tools are guaranteed to work with.
The TD Toolbelt is distributed on Linux as part of the td-agent
package. For more information about td-agent
, our streaming log collector, refer to Overview of Server Side Agent (td-agent).
Ubuntu 14.04 reached End of Life in 2019. Use the new version of Ubuntu.
...
Code Block | ||
---|---|---|
| ||
# 20.4 Focal $ curl -L https://toolbelt.treasuredata.com/sh/install-ubuntu-focal-td-agent4.sh | sh # 18.04 Bionic $ curl -L https://toolbelt.treasuredata.com/sh/install-ubuntu-bionic-td-agent3agent4.sh | sh # Debian Bullseye $ curl -L https://toolbelt.treasuredata.com//sh/install-debian-bullseye-td-agent4.sh | sh # 16.04 Xenial (64bit only) $ curl -L https://toolbelt.treasuredata.com/sh/install-ubuntu-xenial-td-agent3agent4.sh | sh |
Legacy support for EOL versions is still available
Code Block |
---|
# 14.04 Trusty # Debian Buster $ curl -L https://toolbelt.treasuredata.com/sh/install-ubuntudebian-trustybuster-td-agent3agent4.sh | sh |
Legacy support for EOL versions is still available
Code Block | ||
---|---|---|
| ||
# 1214.04 PreciseTrusty $ curl -L https://toolbelt.treasuredata.com/sh/install-ubuntu-precisetrusty-td-agent3.sh | sh # Debian Stretch (64-bit only) 12.04 Precise $ curl -L https://toolbelt.treasuredata.com/sh/install-debianubuntu-stretchprecise-td-agent3.sh | sh # Debian JessieStretch (64-bit only) $ curl -L https://toolbelt.treasuredata.com/sh/install-debian-jessiestretch-td-agent3.sh | sh # Debian SqueezeJessie (64-bit only) $ curl -L https://toolbelt.treasuredata.com/sh/install-debian-squeezejessie-td-agent2agent3.sh | sh |
RedHat
...
and CentOS
The TD Toolbelt is distributed on Linux RedHat and CentOS as part of the td-agent package. For more information about td-agent
, TD Agent is our streaming log collector, refer to the Overview of Server Side Agent (td-agent) page.
Code Block |
---|
# Redhat/CentOS 7/8 td-agent4 $ curl -L https://toolbelt.treasuredata.com/sh/install-redhat-td-agent3agent4.sh | sh |
This package contains all the necessary dependencies to allow the td-agent and td on the CLI to run on a Linux system, including the version of Ruby these tools are guaranteed to work with.
Legacy support for EOL versions is still available.
Code Block | ||
---|---|---|
| ||
# Redhat/CentOS 6 td-agent3 $ curl -L https://toolbelt.treasuredata.com/sh/install-redhat-td-agent3.sh | sh |
Amazon Linux
The TD Toolbelt is distributed on Linux as part of the td-agent
package. For more information about td-agent
, TD Agent is our streaming log collector, refer to the Overview of Server Side Agent (td-agent) page.
Code Block | ||
---|---|---|
| ||
# Amazon Linux 2$ 2 td-agent4 $ curl -L https://toolbelt.treasuredata.com/sh/install-amazon2-td-agent3agent4.sh | sh#sh |
Legacy support for EOL versions is still available.
Code Block |
---|
# Amazon Linux 1$ 1 td-agent3 $ curl -L https://toolbelt.treasuredata.com/sh/install-amazon1-td-agent3.sh | sh |
Install Treasure Data's Server-Side Agent
This package contains all the necessary dependencies to allow the td-agent
and td on the CLI
to run on a Linux system, including the version of Ruby these tools are guaranteed to work with.
Ruby Gem
If you are familiar with Ruby, you can opt to install and maintain the td on the CLI
as a gem. To install TD Toolbelt and its dependencies, simply run this command:
...
If you are using a Ruby environment manager such as rbevn
or rvm
, different versions of the TD Toolbelt can be confined within each project, environment or ruby version in use and you might need to install the td gem multiple times. Refer to the Upgrading, Ruby Gem section below for more information.
Confirm Installation
Open your terminal, and make sure you have the td
command available.
Code Block |
---|
$ td --version 0.1116.X $ td usage: td [options] COMMAND [args] ... |
...
Check Installed Versions
TD Toolbelt should be at version 0.16.79.
Mac OSX or Windows
Code Block |
---|
$ td --version |
Redhat/CentOS
Code Block |
---|
$ rpm -q td-agent |
Ubuntu
Code Block |
---|
$ dpkg - l | grep td-agent |
...