This guide describes the recommended way to install Graylog on SUSE Linux Enterprise Server 12 and 15. All links and packages are present at the time of writing.
Prerequisites
Graylog 6.0 requires the following to maintain compatibility with its software dependencies:
| Graylog Version | Minimum MongoDB Version | Maximum MongoDB Version | Minimum OpenSearch Version | Maximum OpenSearch Version |
|---|---|---|---|---|
|
6.0.x |
5.0.7 |
7.x |
1.1.x (or 1.3.x for Graylog Security) |
2.15.x |
Additionally, we recommend you review the version notes specific to your preferred version of Graylog for guidance on installing and configuring your Graylog instance.
Server Timezone
To set a specific time zone on the Graylog server, you can use the following command. (For more information on setting a time zone, we recommend this blog post.)
sudo timedatectl set-timezone UTCNote the following patterns are required for a minimal setup (see SUSE 15 SP3 Deployment Guide):
- Base System
- Minimal System (Appliances)
- YaST configuration packagesMongoDB
Installing MongoDB on SUSE should follow the tutorial for SUSE from the MongoDB documentation.
1. Import the MongoDB public key.
sudo rpm --import https://www.mongodb.org/static/pgp/server-6.0.asc2. Add the MongoDB repository.
sudo zypper addrepo --gpgcheck "https://repo.mongodb.org/zypper/suse/15/mongodb-org/6.0/x86_64/" mongodb3. Install the MongoDB packages.
sudo zypper -n install mongodb-org4. Then, start the MongoDB instance.
sudo systemctl daemon-reload
sudo systemctl start mongod.service5. In order to automatically start MongoDB on system boot, you have to activate the MongoDB service by running the following command:
sudo systemctl enable mongod.service6. Hold the currently installed version of the MongoDB package to prevent it from being automatically upgraded to a newer version when updates are installed.
sudo zypper addlock mongodb-orgWhen you want to upgrade the package, be sure to remove the hold:
sudo zypper removelock <package-name>In the above code line, replace <package-name> with the correct package name.
OpenSearch
The following installation steps assume you are using Zypper as your package manager with SUSE.
1. You may prefer to disable transparent huge pages to improve performance before installing.
sudo su
cat > /etc/systemd/system/disable-transparent-huge-pages.service <<EOF
Description=Disable Transparent Huge Pages (THP)
DefaultDependencies=no
After=sysinit.target local-fs.target
[Service]
Type=oneshot
ExecStart=/bin/sh -c 'echo never | tee /sys/kernel/mm/transparent_hugepage/enabled > /dev/null'
[Install]
WantedBy=basic.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable disable-transparent-huge-pages.service
sudo systemctl start disable-transparent-huge-pages.service2. Install the OpenSearch GPG key.
sudo rpm --import https://artifacts.opensearch.org/publickeys/opensearch.pgp3. From the CLI, you can install the package.
sudo curl -SL https://artifacts.opensearch.org/releases/bundle/opensearch/2.x/opensearch-2.x.repo -o /etc/zypp/repos.d/opensearch-2.x.repo
sudo zypper update
sudo OPENSEARCH_INITIAL_ADMIN_PASSWORD=$(tr -dc A-Z-a-z-0-9_@#%^-_=+ < /dev/urandom | head -c${1:-32}) zypper install -y opensearch
OPENSEARCH_INITIAL_ADMIN_PASSWORD environment variable when installing. The password must be a minimum of eight characters with at least one uppercase letter, one lowercase letter, one number, and one special character.sudo OPENSEARCH_INITIAL_ADMIN_PASSWORD=$(tr -dc A-Z-a-z-0-9_@#%^-_=+ < /dev/urandom | head -c${1:-32}) apt-get -y install opensearch
4. Edit the opensearch.yml file.
sudo nano /etc/opensearch/opensearch.yml5. At a minimum the following changes are required (for a single instance install).
cluster.name:
path.data: /var/lib/opensearch
path.logs: /var/log/opensearch
action.auto_create_index: false
plugins.security.disabled: true
network.host: 0.0.0.0
discovery.type: single-node6. After the installation succeeds, enable the OpenSearch service.
sudo systemctl daemon-reload
sudo systemctl enable opensearch.service
sudo systemctl start opensearch.service7. Then, enable and start OpenSearch.
sudo systemctl start opensearch8. Hold the currently installed version of the OpenSearch package to prevent it from being automatically upgraded to a newer version when updates are installed.
sudo zypper addlock opensearchWhen you want to upgrade the package, be sure to remove the hold:
sudo zypper removelock <package-name>In the above code line, replace <package-name> with the correct package name.
9. Finally, verify that OpenSearch launched correctly.
sudo systemctl status opensearchGraylog
1. First install the Graylog GPG key with.
sudo wget https://downloads.graylog.org/repo/el/stable/GPG-KEY-graylog -O /etc/pki/GPG-KEY-graylog2. Then add the repository file /etc/zypp/repos.d/graylog.repo with the following content.
[graylog]
name=graylog
baseurl=https://packages.graylog2.org/repo/el/stable/6.0/$basearch/
gpgcheck=1
gpgkey=file:///etc/pki/GPG-KEY-graylog
repo_gpgcheck=03. Refresh zypper repositories:
sudo zypper --gpg-auto-import-keys ref4. After that, install the latest Graylog Open release with:
sudo zypper install graylog-serverIf you are installing Graylog Enterprise, then you will use the following command.
sudo zypper install graylog-enterprise5. Mark the package on-hold so that package updates do not accidentally upgrade the Graylog server.
For Graylog Open:
sudo zypper addlock graylog-serverFor Graylog Enterprise:
sudo zypper addlock graylog-enterpriseWhen you want to upgrade the package, be sure to remove the hold:
sudo zypper removelock <package-name>In the above code line, replace <package-name> with the correct package name.
Edit the Graylog Configuration File
1. Begin by opening the Graylog configuration file. Review the configuration file and edit as needed according to your preferences and environment.
sudo nano /etc/graylog/server/server.conf
password_secret and root_password_sha2 values to the configuration file as these are mandatory and Graylog will not start without them.
2. To create your password_secret, run the following command:
< /dev/urandom tr -dc A-Z-a-z-0-9 | head -c${1:-96};echo;3. Use the following command to create your root_password_sha2:
echo -n "Enter Password: " && head -1 </dev/stdin | tr -d '\n' | sha256sum | cut -d" " -f14. To be able to connect to Graylog, set the http_bind_address value in the configuration file to the public host name or a public IP address for the machine to which you can connect. More information about these settings can be found in Configuring the Web Interface. Alternatively, you can also set this configuration using this command:
sudo sed -i 's/#http_bind_address = 127.0.0.1.*/http_bind_address = 0.0.0.0:9000/g' /etc/graylog/server/server.conf
5. Edit the elasticsearch_hosts setting to include a list of comma-separated URIs to one or more valid OpenSearch nodes. A sample specification may look as follows:
elasticsearch_hosts = http://es-node-1.example.org:9200/foo,https://someuser:somepassword@es-node-2.example.org:9200
6. The last step is to enable Graylog during the operating system’s startup:
sudo systemctl daemon-reload
sudo systemctl enable graylog-server.service
sudo systemctl start graylog-server.service
sudo systemctl --type=service --state=active | grep graylogNow you can ingest messages into Graylog!
Getting Started
Now that you have installed Graylog, you can review your initial configuration settings and connect to the web interface!
Cluster Setup
If you plan to have multiple servers assuming different roles in your cluster like we have in this big production setup you need to modify only a few settings. This is covered in our multi-node setup guide. The default file location guide lists the locations of the files you need to modify.
