arm4_control(1)

1arm4_control(1)              ARM 4 System Commands             arm4_control(1)
2
3
4

NAME

6       arm4_control - ARM 4 agent control program
7

SYNOPSIS

9       arm4_control --help|-h
10       arm4_control --version|-V
11       arm4_control [--config|-C config_file] [commands...]
12

DESCRIPTION

14       The arm4_control program controls the arm4_daemon program.
15

OPTIONS

17       -h, --help
18              display the command line options.
19
20       -V, --Version
21              display the program version and exit.
22
23       -C, --Config config_file
24              specifies  a  configuration  file  for  this instance instead of
25              using the default configuration file. The default  configuration
26              file /etc/arm4.conf is used if none is specified.
27

COMMANDS

29       help, help commands
30              show all available commands.
31
32       help <command>
33              show options for the command.
34
35       archive
36              backup  the  current  database  to  the backup directory. Unless
37              specified in the configuration file, the main  backup  directory
38              is /var/lib/arm4/data/backup.
39
40       collect, collect status
41              show the current collection state.
42
43       collect yes, collect on
44              turn collection on.
45
46       collect no, collect off
47              turn collection off.
48
49       checkpoint
50              perform a database checkpoint operation
51
52       remove remove  the  shared memory regions and semaphores, but leave the
53              databases intact.  This is normally done  when  recovering  from
54              catastrophic failures.
55
56       status show if an instance of the arm4_daemon is running.
57
58       stop   stop the current arm4_daemon instance.
59
60       wipe   remove  the  current  database, shared memory regions, and sema‐
61              phores. This is normally done when upgrading versions.
62
63       application
64              display currently defined applications  with  their  application
65              ids.
66
67       application app_id
68              display collection parameters for the specified application.
69
70       application app_id transactions
71              displays the transactions definitions and corresponding transac‐
72              tion ids associated with the specified application.
73
74       transaction
75              displays the current transaction definitions.
76
77       transaction tran_id
78              displays the configuration for a specific transaction id.
79
80       transaction tran_id trace all
81              trace all transaction instances.
82
83       transaction tran_id trace none
84              turn tracing off.
85
86       transaction tran_id trace n
87              trace every nth transaction instance.
88
89       transaction tran_id trace n[s|S]
90              trace one transaction instance every n tenths of seconds.
91
92       transaction tran_id trace application
93              honor application trace requests.
94
95       transaction tran_id trace noapplication
96              ignore application trace requests.
97
98       transaction tran_id trace default
99              use application default settings.
100
101       export definitions
102              exports application, metric, and transaction definitions in  xml
103              format to stdout.
104
105       export all
106              exports  the  full  database  including definitions and instance
107              data in xml format to stdout.
108
109       import filename
110              imports an exported database in xml format from the file.
111

REPORTING BUGS

113       Report bugs at <http://www.arm4.org>
114

COPYRIGHT

116       Copyright © 2005-2008 David Carter <dcarter@arm4.org> and others.
117
118       All rights reserved.   This program and the accompanying materials  are
119       made available under the terms of the Eclipse Public License v1.0 which
120       accompanies    this    distribution,    and     is     available     at
121       http://www.eclipse.org/legal/epl-v10.html
122