Quickstart Guide

Overview Copied

Geneos can be deployed in a variety of ways to meet your specific business needs. Here are the basic steps to get started with Geneos in any environment.

Standard environment (Linux and Windows) Copied

To install Geneos on a Linux or Windows environment, please follow these steps.

1. Verify that you have met all of the prerequisites listed below. Then, check your License Daemon to make sure that you have the appropriate licenses for the Geneos components that you want to use.

   • Operating System support
   • Installation considerations
   • Required libraries

2. Download and install the Licence Daemon.

   • Extracting files
   • Providing the Licence File

3. Run your Licence Daemon.

   • Executing
   • Required libraries

4. Ensure that the Gateway prerequisites are met, then run the Gateway setup.

   • Gateway System Requirements
   • How to download and unpack Gateway
   • How to create a start script for Gateway
   • How to start and configure the Gateway

5. Ensure that the Active Console prerequisites are met, then run the Active Console setup.

   • System Requirements
   • Download binaries
   • Connect to a Gateway

6. Connect the Active Console to the Gateway.

7. Run your Netprobe.

8. Connect your Netprobe to your Gateway.

   • Download and install the Netprobe.
     • For Linux, Download the Netprobe files and Install a new Netprobe.
     • For Windows, Download the Netprobe files and Install a new Netprobe.
   • In the Active Console, open the Gateway Setup Editor of your running Gateway.
   • Navigate to Probes > New Probe.
   • Supply the Netprobe name.
   • Supply the host and port from the previous step, and then apply the changes.

9. Add samplers. For more information, see Samplers.

10. Add Managed Entities. For more information, see Managed Entities and Managed Entity Groups.

11. View your metrics in the metrics dockables. For more information, see Metrics Dockable.

Amazon Web Services Cloud Copied

If you want to deploy the Geneos binaries on AWS, do the following:

1. Verify that all Geneos prerequisites are met.
2. Verify that all Amazon Web Services EC2 system requirements are met.
3. Deploy an EC2 instance. Geneos supports the Operating Systems found in the Compatibility Matrix.
4. Download and transfer the Geneos binaries to the running EC2 instance through SSH.
5. Perform the Install, Run, and Connect steps found in the Standard Environment section.

Alternately, you can deploy an EC2 instance that contains a Netprobe with an AWS plugin by launching the ITRS Geneos EC2 instance. This deployment also allows you to gather and monitor metrics through AWS Cloudwatch. For more information, see AWS.

Azure Copied

You can deploy the pre-configured ITRS virtual machine through the Azure Marketplace.

1. Verify that all Geneos prerequisites are met.
2. Verify that all Azure prerequisites are met.
3. Create a virtual machine in the Azure Marketplace.
4. Download and transfer the Geneos binaries to the running virtual machine.
5. Perform the installation steps found in the Standard Environment section.

Alternately, you can deploy an Azure virtual machine that has the Azure Monitor plugin and the Azure Event Hub plugin by following Deploy Azure through the Azure Marketplace.

Docker containers Copied

Gateways and Netprobes are also available as Docker images that can be run as containers. To do this:

1. Verify that all prerequisites are met.
2. Download the Docker images from the ITRS Docker registry. See Docker available versions for more information.

By default, these images will use an example configuration stored at /gateway/config/gateway.gci and /netprobe/config/netprobe.gci. If you want to start the containers with an alternative configuration, see:

• Gateway: Alternative Gateway configuration and setup files
• Netprobe: Alternative Netprobe configuration and setup files

Kubernetes using Helm Copied

1. Verify that all Helm prerequisites are met.

2. Create a namespace and Install a Helm chart.

3. If you want to deploy your Netprobe via Helm, follow any of these steps:

   • DaemonSet deployment — to monitor full metrics and events in all namespaces using a DaemonSet.
   • Installation using Helm — to monitor full metrics and events in all namespaces without using a DaemonSet.

4. If you want to deploy your Gateway via Helm, follow any of these steps:

• Insecure installation — install Gateway in your cluster without TLS security.

• Secure installation — install Gateway in your cluster with TLS security.

  You can also connect your Gateway to Obcerv, see Connecting to Obcerv.