Page History
...
| Code Block | ||||
|---|---|---|---|---|
| ||||
Usage: agent.sh command [options] [switches]
command:
start [options]
start-container [options]
stop [options]
restart [options]
status [options]
cancel [options]
switch-over [options]
cert [cert-options] | see https://kb.sos-berlin.com/x/jLbAAw
options:
--http-port=<[interface:]port> | http network interface and port, default: 4445
--https-port=<[interface:]port> | https network interface and port, default:
--data-directory=<directory> | default: /var/sos-berlin.com/js7/agent/var_4445
--config-directory=<directory> | default: /var/sos-berlin.com/js7/agent/var_4445/config
--sigkill-delay=<seconds> | send SIGTERM and delayed SIGKILL signal, default: 3
--timeout=<seconds> | timeout for terminating jobs on Agent stop
--java-options=<java options> | default: -Xms100m -Dfile.encoding=UTF-8; see https://kb.sos-berlin.com/x/uYo7B
switches:
-c | --curl | use curl instead of Java http client
see https://kb.sos-berlin.com/x/ZqrAAw for more information. |
...
| Code Block | ||||
|---|---|---|---|---|
| ||||
Usage: agent.cmd command [options] [switches]
command:
start [options]
stop start-service [options]
stop restart [options]
restartstatus [options]
statuscancel [options]
switch-over cancel [options]
start-service [options]
install-service [options]
certremove-service [options]
cert [cert-options] | see https://kb.sos-berlin.com/x/jLbAAw
options:
--http-port=<[interface:]port> | http network interface and port, default: 4445
--https-port=<[interface:]port> | https network interface and port, default:
--data-directory=<directory> | default: /var/sos-berlin.com/js7/agent/var_4445
--config-directory=<directory> | default: /var/sos-berlin.com/js7/agent/var_4445/config
--timeout=<seconds> | timeout for terminating jobs on Agent stop
--java-options=<java options> | default: -Xms100m -Dfile.encoding=UTF-8; see https://kb.sos-berlin.com/x/uYo7B
switches:
-c | --curl | use curl instead of Java http client
see https://kb.sos-berlin.com/x/ZqrAAw for more information. |
...
- Unix
- Job processes and child processes will be terminated and the Agent will terminate with exit code 0.
- collect PIDs of job processes,
- send SIGTERM signal to remaining job processes and child processes for which PIDs have been collected,
- wait for the grace timeout specified at with the job or for stdout/stderr to be released by processes whichever is earlier,
- send SIGKILL signal to job processes and child processes,
- terminate the Agent with exit code 0.
- Job processes and child processes will be terminated and the Agent will terminate with exit code 0.
- Windows
- Job processes and child processes will be forcibly terminated and the Agent will terminate with exit code 0.
- Using the
--timeoutoption will wait for the indicated timeout that the Agent terminates. If the timeout is exceeded and if the Agent is still running, then then Agent and jobs will be focibly terminated. The option accepts a number of seconds or thenevervalue that indicates that the Agent will wait endlessly until job processes and child processes will terminate.- Agent
- collect PIDs of job processes,
- terminate the Agent with exit code 143 for Unix and 99 for Windows.
- Watchdog
- Unix
- if the
--sigkill-delayoption is used- send SIGTERM signal to remaining job processes and child processes for which PIDs have been collected,
- wait for the indicated delay or for stdout/stderr to be released by processes whichever is earlier,
- send SIGKILL signal to remaining job processes and child processes.
- if the
- Windows
- forcibly terminate job processes and child processes.
- Unix
- Agent
...
| Code Block | ||
|---|---|---|
| ||
version: 2.0.0-alpha.20210722.2 (2021-07-22)
buildId: QQqWYNiJRbqcYqx4iiFWww
startedAt: 1626981330629
isTerminating: false
system:
hostname: agent-2-0-primary
distribution: Alpine Linux v3.13
cpuModel: Intel(R) Xeon(R) CPU E5-2630 v4 @ 2.20GHz
mxBeans:
operatingSystem:
availableProcessors: 8
systemLoadAverage: 0.0107421875
java:
version: 1.8.0_292
memory:
maximum: 954728448
total: 289931264
free: 87118936
systemProperties:
java.vendor: IcedTea
os.arch: amd64
java.runtime.name: OpenJDK Runtime Environment
os.version: 3.10.0-957.1.3.el7.x86_64
os.name: Linux
java.vm.name: OpenJDK 64-Bit Server VM
java.version: 1.8.0_292 |
Switching-over the Active Director Agent Instance
| Code Block | ||
|---|---|---|
| ||
agent_4445.sh|.cmd switch-over [options] |
If an Agent Cluster is operated then the command will switch the active role from the Active Director Agent instance to the Standby Director Agent instance. The command can be executed for the Active Director Agent .
After switch-over the Agent instance is restarted.
| Anchoranchor | ||||
|---|---|---|---|---|
|
...
- For general information see JS7 - Log Levels and Debug Options.
- The log level can be increased by using the Agent's Apache ProcRun Daemon Service Manager daemon/service. On Windows systems this is installed in the Agent's
servicedirectory with a name such asjs7_agent_<port>w.exewhere<port>is the Agent's HTTP port. - Users can start the ProcRun Manager, select the Logging tab in the user interface and set the log level to Debug.
- For the location of log files see JS7 - Log Files and Locations.
- Users should consider reverting the debug log level to its original value once they are finished with debugging.
Resources
Overview
Content Tools