System requirements

Overview Copied

This page outlines the software requirements and other prerequisites before you run the Active Console.

Active Console is a standalone Java and C++ application. It uses its own JRE included on the binary package, which means that any Java versions can be used on the operating system.

Check that the Active Console can connect to the Gateway machines and port where the Gateway data is accessible.

Beginning Geneos version 5.0.0, this component is only compatible with other Geneos components that are version 3.6.0 or higher. For more information, see the Geneos Compatibility Matrix.

Minimum requirements Copied

The following minimum requirements must be met:

Expand table The Active Console does not support cross-platform functions and operations. Importing components, such as dashboards, workspaces, list view settings, customised dataviews, and dockables, from one supported platform to another, may be successful at first. However, the import is not expected to work properly.

For Linux Copied

When Security-Enhanced Linux (SELinux) is running in Enforcing mode, it may deny certain functions of Geneos depending on the implemented configurations and policies. To see which functions SELinux denies, check the audit log. The log is typically located in /var/log/audit.log, where the log type entry is AVC. The audit log provides the details of any denied access. For example, denied connection to the TCP port. If you experience issues related to this mode, you may opt to disable SELinux, or create policy modules to grant the required access. Please contact your administrator or security team for assistance.

Packaged version of Java Copied

Active Console is supplied with a Java version as part of the installation package, this is referred to as the packaged Java. This is independent of the native Java that you may already have installed on your local machine. The packaged Java with the Active Console binaries is installed into a separate subdirectory which means that the native and packaged Java versions are isolated from one another. Updating either one of the Java versions will have no impact on the other.

It is recommended that you use the packaged version of Java with Active Console for the following reasons:

• The packaged version of Java with Active Console is always tested and verified. We would not be able to perform adequate testing against all possible versions of Java.
• It reduces support complexity and helps resolve issues quickly, as there is a one-to-one relationship between the product version and the Java version.
• Not relying on the native Java installed on a machine means it is simpler to upgrade and maintain Active Console using a single package.

Database support Copied

The Active Console supports the following databases:

• MSSQL
• MySQL
• Oracle
• PostgreSQL
• Sybase

  Note

  The jConnect for JDBC driver by Sybase is not included in the Active Console package. If you are using Sybase for generating history charts, you must manually supply the jConnect for JDBC driver by following the steps outlined below.

To view the list of supported versions, see Database support.

For more information on setting up the databases for use within Geneos, see Databases.

Supplying the jConnect JDBC driver for Active Console Copied

1. Copy the jConnect driver from the jConnect-16_X > classes folder within your existing Sybase client or database installation. Alternatively, you can also download the jConnect driver from the SAP portal. Ensure that you use SAP ASE version 16.0 or up for compatibility.

   The filename may vary depending on the version, for example:

   • jconn4.jar for version 16.0
   • jconn42.jar for version 16.1

2. Place the jConnect driver in the jars > JDBC folder within your Active Console installation.

3. Delete the existing jConnect driver (jconn4-7.07-GA-26686.jar) from the same jars > JDBC folder.

4. If the Active Console is currently running, restart it to ensure the copied driver takes effect.

Success

Once the jConnect driver has been copied to the correct location within the Active Console installation, you should be able to successfully connect to Sybase to generate history charts.