Hub Agent options#

Cegal Hub Agent runs as a standalone executable.

To run a simple stand-alone Hub Agent connecting to a remote Cegal Hub Server. In this scenario the Agent has the least privilege possible.

cegalhub agent --address=cegalhub.demo1-ispace.cegal-geo.com --port=443 --tls
../../../_images/hub_agent_least_privilege.png

In a production setting and depending on your deployment scenario it is likely further options will be supplied. See below for the options available when running a stand-alone Cegal Hub Agent.

Flags#

Agent options#

option (flag)

description

–address value, -a value

host address where Hub Server is running (default: localhost)

–port value, –po value

GRPC port Hub Server listens on (default: 9595)

–tls

use transport layer security for the connection (default: false)

–connector-join-token value, –cjt value

connector join token allowing the Connector to join Hub Server (not available for client requests)

–allow-public, –ap

allow the Hub Connector to be publicly available (only applies for connector usage) (default: false)

–remote, -r

use remote connection configuration settings (alternative to specifying address, port, tls etc individually) (default: false)

–use-device-flow, –device

specify no local browser is available for login on the local machine and device flow login should be used (default: false)

–profile value

launch an application(s) with specified profile(s) name (multiple profiles can be specified comma-separated) (default: <profile_name>)

–env-var-override value, –env value, -e value

override the environment variable(s) in the launch profile (multiple overrides can be specified comma-separated) (default: <env_var_name>)

–auth-user-identity, –aui

use the user Keystone identity to authenticate (default: true)

–allow-scripts, –as

allow the Cegal Hub Agent to execute scripts (default: false)

–allow-launch-profiles, –alp

allow the Cegal Hub Agent to launch wellknown application profiles (default: false)

–no-log-file

dont create a log file (default: false)

–pretty-print, –pp

pretty print to console (default: true)

–debug

set logging level to debug (default: false)

–file-list-path value, –flp value

allow clients to list files recursively from the given directory. A value of ‘*’ means all paths are accessible. A value of ‘.’ means the current working directory. An empty value will use the default files path.

–file-download-path value, –fdp value

make the specified directory path available to clients. A value of ‘*’ means all paths are accessible. A value of ‘.’ means the current working directory. An empty value will use the default files path.

–file-upload-path value, –fup value

set the default file upload directory path available to clients. A value of ‘.’ will use the current working directory. An empty value will use the default files path. (default: <path to file>)

–file-upload-allow-overwrite, –fuao

allow files to be overwritten when uploading. (default: false)

–file-upload-extra-path value, –fuep value

specify additional file upload directory paths to make available to clients. * means all paths are accessible.

–help, -h

show help (default: false)