Adding a DGE

Prerequisites

• Ensure that the Traverse Web Application component is installed and operating correctly.
• Identify the host name and IP address of the system that will host the DGE.
• Review Using an Existing MySQL Database with a DGE if you intend on using an existing MySQL database with your new DGE.
• Review Disk Space Requirements for DGE Aggregation for guidelines on sizing the disk space for your new DGE.

Create a DGE Record in Traverse

1. Log in to the Traverse Web Application as superuser.
2. Navigate to Superuser > DGE Management.
3. Click Create a New DGE.

   

4. Fill in the Name field with a unique name to identify the DGE host. This name can be arbitrary, but should be unique as it is used by the DGE to identify itself to the Correlation & Summary Engine (BVE).
5. Fill in the Host field with the fully qualified domain name or IP address of the DGE host. At startup, the DGE verifies the hostname/IP in the Provisioning Database against its own IP address.
6. Select the DGE location from the drop-down list. There may often be multiple DGEs assigned to a single geographic location.
7. Set the Soft Limit and Hard Limit values. Accept the default values if you don't have a reason to change them. See Load Balancing, Soft Limits, Hard Limits in Adding a Location for more information.
8. Click Create DGE to save your changes.
9. Repeat steps 3-8 above as needed to create additional DGE hosts.

Installing the DGE

1. Locate the same installer you used to install the Business Visibility Engine (Correlation & Summary Engine), appropriate for Windows or UNIX.
2. Install the DGE software on a new DGE host and reboot the system.

   

3. Subsequent screens ask you to specify:
   • The IP Address of the Fully Qualified Domain Name (FQDN) or IP address of the system hosting the BVE/Provisioning Database.
   • The unique DGE Name of your new DGE. This should match the Name you entered in step 4 of the Create a DGE Record in Traverse procedure above.
   • The email address and SMTP mail server your new DGE will use to notify you.

After the Installation

1. Start the DGE if it is not already started.
2. Check the health of the DGE you have just installed by navigating to the SuperUser > Health page. Your DGE should be listed and show all components with an icon. See Monitoring DGE Operation and Capacity for more information.

• Log into the Traverse Web Application and run Network Discovery to add devices and tests to the new DGE.

Troubleshooting

If you encounter connection issues, verify on the system hosting the new DGE:

• The name of the DGE in the <TRAVERSE_HOME>/etc/dge.xml file. Locate the string <dge name. It should match the Name specified on the Superuser > DGE Management page.
• The Fully Qualified Domain Name (FQDN) or IP address of the system hosting the BVE/Provisioning Database. The host value is located in the <TRAVERSE_HOME>/etc/emerald.xml file. Locate multiple instances of the string host.

Restarting the DGE

If you make changes to either XML, the DGE service must be restarted. On the system hosting the DGE:

For Windows:

1. Use the Start menu to navigate to Traverse programs folder.
2. Click the Launch Travese Service Controller option.
3. Uncheck the Data Gathering Engine component
4. Check the Data Gathering Engine component to restart it.

   

For UNIX

• Run the following: <TRAVERSE_HOME>/etc/dge.init