Property

Host Lookup

Attribute

connector.host.lookup.script.timeout

Description

The timeout (in milliseconds) to wait for the host lookup script to run and return the host info.

Default Value

5000

Property

Host Lookup

Attribute

connector.host.lookup.scripts

Description

List of comma-separated key-value pairs, where key and value are separated by an equals sign.

·         Key is any name given to a host lookup script.

Used inside connectors UI as Host Lookup Script.

NOTE:  The Host Lookup Script value can be parameterized.

When a key is used in the connector, it is searched in the Panopticon.properties file and the corresponding shell script is run to get the host information.

An exception is thrown if the key used in the connector is not configured in the Panopticon.properties file.

·         Value is the full path of the shell script that is accessible on the server.

Examples:

·         For Windows

connector. host.lookup.scripts=local=E://Data/host.bat,formatted=E://Data/hostFormatted.bat

There are two keys specified in this property which are local and formatted.

The shell script for the local key is host.bat  which is:

@echo  off

echo  %1

After executing the host lookup script, the received connection details are the values entered in the connector UI.

{ "host": "localhost", "port": 5001, "username": "", "password": "" }

NOTES:

·         The port should be a number and has no double quotes. This is done to avoid unwanted casts.

·         Only host and port are mandatory.

The shell script for the formatted key is hostFormatted.bat  which is:

@echo  off

echo {

echo   "host":"localhost",

echo   "port":5001,

echo   "username":"john",

echo   "password":"  Pass1w0rd"

echo }

Specifying the formatted key as the Host Lookup Script value, the Host, Port, User Id, and Password entries will be disregarded.

The connection details from the host lookup script will be used instead.

{ "host": "localhost", "port": 5001, "username": "john", "password": "●●●●" }

·         For Linux

connector.host.lookup.scripts=local=/etc/panopticon/appdata/host.sh,formatted=/etc/panopticon/appdata/hostFormatted.sh

There are two keys specified in this property which are local and formatted.

The shell script for the local key is host.sh  which is:

echo  $@

After executing the host lookup script, the received connection details will be the values entered in the connector UI.

{ "host": "localhost", "port": 5001, "username": "", "password": "" }

The shell script for the formatted key is hostFormatted.sh  which is:

echo {

echo   \"host\":\"192.168.1.172\",

echo   \"port\":5001,

echo   \"username\":\"john\",

echo   \"password\":\"Pass1w0rd\"

echo }

Specifying the formatted key as the Host Lookup Script value, the Host, Port, User Id, and Password entries will be disregarded.

The connection details from the host lookup script will be used instead.

{ "host": "localhost", "port": 5001, "username": "john", "password": "●●●●" }

NOTE: Backslash is not supported in the Panopticon.properties file. Forward slash is used instead in the path of the scripts.

Default Value