SYNOPSIS
- AMinerRemoteControl --ControlSocket socket [--Exec code] [--Data data]
DESCRIPTION
Example usecases:
Just a test: /usr/lib/aminer/AMinerRemoteControl --Data '["Some text", 123]' --Exec 'remoteControlResponse="It works! Data %s" % repr(remoteControlData)'
Query remote module configuration: /usr/lib/aminer/AMinerRemoteControl --Exec 'remoteControlResponse=analysisContext.getRegisteredComponentIds()'
OPTIONS
with long options starting with two dashes (`-'). A summary of options is included below. For a complete description, see the info(1) files.
--ControlSocket socket
- Specify the Unix domain remote control socket path, otherwise /var/run/aminer-remote.socket is used. The socket is opened by AMiner when 'RemoteControlSocket' feature is enabled in configuration. As the socket is of SOCK_STREAM type, it may also be forwarded via any other stream forwarders, e.g. socat (see UNIX-CONNECT and UNIX-LISTEN) and SSH (see LocalForward, DynamicForward). Access control is only done by file system permissions (DAC) of the socket, so make sure not to widen the access on error.
--Exec code
- For each --Exec option, the next argument is sent in a separate remote execution request using additional execution data (see --Data). The code is executed in a separate separate execution namespace with only some variables added to the local namespace, e.g. execution data is available as 'remoteControlData'. When setting the local variable 'remoteControlResponse' within the executed code, the object is serialized using json and sent back in the response.
--Data data
- This parameter defines a json string defining Python objects, that will be sent with all subsequent --Exec operations until changed again using another --Data option. Take into account, that there are size limits for the request, very large data objects may exceed those limits.
FILES
/var/run/aminer-remote.socket
- This is the default remote control socket used when not changed using the --ControlSocket option.
BUGS
Report bugs via your distribution's bug tracking system. For bugs in the the software trunk, report via at m[blue]https://bugs.launchpad.net/logdata-anomaly-miner/+filebugm[].
COPYRIGHT
Copyright © 2016 Roman Fiedler
This manual page was written for the Debian system (and may be used by others).
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3 or (at your option) any later version published by the Free Software Foundation.
On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.