Proxy Settings

Feature

How to configure proxy for Germain

Germain Engine

Windows - ‘Engine Manager’ Proxy Settings

Deploying a new Engine on Windows? Try using our Windows Installer

To set the proxy setting that the Windows Service will use

Launching Engine Manager Manually:

If you are manually launching the Engine Manager you will need to edit the startEngineManager.bat file located in the bin folder.

You will need to add one of the following to the VMARGS

HTTP: -Dhttp.proxyHost=proxy.host.name -Dhttp.proxyPort=PortNumber

HTTPS: -Dhttps.proxyHost=proxy.host.name -Dhttps.proxyPort=PortNumber

Example: (See line 16, you will need to scroll to the right)

@echo off
REM -------------------------------------------------
REM Copyright (C) 2014-2021 Germain Software
REM -------------------------------------------------
SET JAVA="%JAVA_HOME%\bin\java.exe"

REM Identify Germain home
IF NOT "%GERMAIN_HOME%" == "" GOTO start
SET GERMAIN_HOME=%cd%
IF EXIST "%GERMAIN_HOME%\bin\apm-engine-manager.jar" GOTO start
cd ..
SET GERMAIN_HOME=%cd%

:start
cd %GERMAIN_HOME%
SET VMARGS=-Dgermain.jvm=%JAVA% -Xms256m -Xmx512m -XX:+CrashOnOutOfMemoryError -Dhttps.proxyHost=proxy.https.example.com -Dhttps.proxyPort=8800
SET JAR=bin/apm-engine-manager.jar
echo Starting Germain Engine Manager...
%JAVA% %VMARGS% -jar %JAR%

CODE

Launching Engine Manager as a Service:

Linux - ‘Engine Manager’ Proxy Settings

You will need to edit startEngineManager.sh in the bin folder and add the following to the VMARGS:

HTTP: -Dhttp.proxyHost=proxy.host.name -Dhttp.proxyPort=PortNumber

HTTPS: -Dhttps.proxyHost=proxy.host.name -Dhttps.proxyPort=PortNumber

Example: (See line 22, you will need to scroll to the right)

#!/bin/sh
# -------------------------------------------------
# Copyright (C) 2014-2021 Germain Software
# -------------------------------------------------
JAVA_BIN=`which java`
if [ -z "$JAVA_BIN" ]; then
    if [ -n "$JAVA_HOME" ]; then
        JAVA_BIN="$JAVA_HOME/bin/java"
    else
        if [ -n "$JRE_HOME" ]; then
            JAVA_BIN="$JRE_HOME/bin/java"
        fi
    fi
fi

if [ -z "$JAVA_BIN" ]; then
    echo "Could not find java executable."
    exit 1
fi

export GERMAIN_HOME=$PWD
VMARGS="-Dgermain.jvm=$JAVA_BIN -Xms256m -Xmx512m -XX:+CrashOnOutOfMemoryError" -Dhttps.proxyHost=proxy.https.example.com -Dhttps.proxyPort=8800
JAR=bin/apm-engine-manager.jar
$JAVA_BIN $VMARGS -jar $JAR

BASH

All OS - ‘Engine’ Proxy Settings

In the ‘Germain State’ Screen (1):

Select the Engines Tab (2)
Select your Node and Engine (3)
Click “Show Advanced” (4)
Add Lines for, then enter your settings (5, 6, 7)

These are the settings to the Engines JVM Options:

HTTP:
- -Dhttp.proxyHost=proxy.host.name
- -Dhttp.proxyPort=PortNumber
HTTPS:
- -Dhttps.proxyHost=proxy.host.name
- -Dhttps.proxyPort=PortNumber

Example

Germain Agent

If you need Proxy Setting for an Agent, please contact support. We will help determine the correct configuration. Contact information is available here.

Germain JS script (UX Monitoring) and Browser Extensions (UX Monitoring, JavaScript Profiling, Synthetic Script Recording)

Germain’s UX Monitoring is using the same connection as the browser, so it only matters what proxy is setup on the OS.

These are official documents from Microsoft and Apply for Windows and Mac OS X
Windows:
https://docs.microsoft.com/en-us/troubleshoot/developer/browsers/connectivity-navigation/use-proxy-servers-with-ie#use-the-browser-settings
Mac OS:
https://support.apple.com/en-ca/guide/mac-help/mchlp2591/mac