Deploy on linux
Prerequisites
You will need:
- A DNS name that resolves to all nodes of the Enterprise Logs cluster. This guide uses
enterprise-logs.local
in the following examples. - To configure the replication factor in the
enterprise-logs.yaml
configuration file. For a cluster of less than three nodes,lifecycler.ring.kvstore
should be set to1
. Otherwise, the default value of3
should be used.
Install Enterprise Logs
Run the following commands on every node as the root user:
# # Add dedicated user and group
# groupadd --system enterprise-logs
# useradd --system --home-dir /var/lib/enterprise-logs -g enterprise-logs enterprise-logs
# # Create directories
# mkdir -p /etc/enterprise-logs /var/lib/enterprise-logs
# chown root:enterprise-logs /etc/enterprise-logs
# chown enterprise-logs:enterprise-logs /var/lib/enterprise-logs
# chmod 0750 /etc/enterprise-logs /var/lib/enterprise-logs
# # Download enterprise-logs binary
# curl -Lo /usr/local/bin/enterprise-logs \
https://storage.googleapis.com/grafana-enterprise-logs/releases/enterprise-logs-v1.0.0-linux-amd64
# echo "d123d211d40ebbf41af9d7e6c87030bacdc6b62e8490b872aef970a22bb44b04" \
"/usr/local/bin/enterprise-logs" | sha256sum -c
# chmod 0755 /usr/local/bin/enterprise-logs
# setcap 'cap_net_bind_service=+ep' /usr/local/bin/enterprise-logs
# # Set up systemd unit and enable startup on boot
# cat > /etc/systemd/system/enterprise-logs.service <<EOF
[Unit]
After=network.target
[Service]
User=enterprise-logs
Group=enterprise-logs
WorkingDirectory=/var/lib/enterprise-logs
ExecStart=/usr/local/bin/enterprise-logs \
-config.file=/etc/enterprise-logs/enterprise-logs.yaml \
-log.level=warn \
-memberlist.join=enterprise-logs.local:7946 \
-querier.frontend-address=enterprise-logs.local:9095
[Install]
WantedBy=default.target
EOF
# systemctl daemon-reload
# systemctl enable enterprise-logs.service
Copy configuration and license
Copy the configuration and the license files to all nodes in the Enterprise Logs cluster:
enterprise-logs.yaml
should be copied to/etc/enterprise-logs/enterprise-logs.yaml
license.jwt
should be copied to/etc/enterprise-logs/license.jwt
Generate an admin token
Generate an admin token by running the following on a single node in the cluster:
# su enterprise-logs -c "/usr/local/bin/enterprise-logs \
--config.file=/etc/enterprise-logs/enterprise-logs.yaml \
--bootstrap.license.path=/etc/enterprise-logs/license.jwt \
--log.level=warn \
--target=tokengen
Token created: YWRtaW4tcG9saWN5LWJvb3RzdHJhcC10b2tlbjo8Ujc1IzQyfXBfMjd7fDIwMDRdYVxgeXw=
Start all Enterprise Logs replicas
Start the enterprise-logs service on each node:
# systemctl start enterprise-logs.service
Next: Set up an instance.