---
title: "Configuring existing EC2 with Netprobe"
description: "Learn how to configure Netprobe on existing EC2 instances using CloudFormation and AWS Systems Manager with this comprehensive user guide."
url: "https://docs.itrsgroup.com/docs/geneos/7.11.0/collection/cloud-native-deployments/deploying-via-aws-cloudformation/existing-ec2-with-netprobe/index.html"
---
The `ExistingEC2withNetprobe.yaml` CloudFormation template configures Netprobe on existing EC2 instances using the AWS Systems Manager (SSM). It creates an SSM document and association to remotely install and configure Netprobe as a `systemd` service using IAM instance profile credentials.

## Prerequisites

- The target EC2 instances must have an [SSM Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-agent.html) installed and running.
- Target instances must have an IAM instance profile attached with the following permissions:
  - `AmazonSSMManagedInstanceCore` (for SSM communication)
  - S3 `read` access to the Netprobe artifacts bucket (and KMS decrypt if applicable)
- The Netprobe installation package, setup file, and systemd service files should be located in an accessible S3 bucket.

## Input parameters

### Target EC2 configuration

| Parameter | Description | Default | Required |
|-----------|-------------|---------|----------|
| `InstanceIds` | Comma-separated list of existing EC2 Instance IDs |  | Yes |

### Gateway configuration

| Parameter | Description | Default | Required |
|-----------|-------------|---------|----------|
| `GatewayHost` | Gateway host for Netprobe connection |  | Yes |
| `GatewayPort` | Gateway port for Netprobe connection | 7039 | No |

### Netprobe configuration

| Parameter | Description | Default | Required |
|-----------|-------------|---------|----------|
| `NetprobeInstallDirectory` | Directory where Netprobe will be installed | ~/geneos | No |
| `S3NetprobeURL` | S3 URL to the Netprobe tar.gz file |  | Yes |
| `NetprobePort` | Port number for Netprobe | 7036 | No |
| `S3NetprobeSetupURL` | S3 URL to the Netprobe setup XML file |  | Yes |
| `S3NetprobeServiceURL` | S3 URL to the Netprobe systemd service file |  | Yes |

## Verification and debugging

Run the following commands if you need to verify or debug your deployment.

### View template execution logs

```bash
ssh -i <privatekey> <user>@<host> "sudo cat /var/log/amazon/ssm/amazon-ssm-agent.log"
```

### Check the service status

```bash
ssh -i <privatekey> <user>@<host> "systemctl is-active <service>.service"
```

### Download the logs

```bash
ssh -i <privatekey> <user>@<host> "sudo tar -cvz -C "cd <install_dir> && find <service> -type f -name '*.log' -print0 | sudo tar --null -czf - --files-from -" > <service>-logs.tar.gz
```