Skip to main content

Aerospike Information Tool (asinfo)

asinfo is a command-line utility that provides an interface to Aerospike's cluster command and control functions. This includes the ability to change server configuration parameters while the Aerospike is running.

info

Configuration changes made by asinfo are not persisted to the Aerospike configuration file. If a change requires persistence it needs to be added to the configuration file.

Usage

This utility is packaged in the Aerospike Tools package and by default installs to /usr/bin/asinfo. To execute asinfo use the following format. Please remember to put the VALUE in quote ("").

asinfo [-V] [-E] [-v VALUE] [-l] [-h HOST] [-p PORT] [-U USER]
[-P [PASSWORD]] [--auth AUTH] [-t TLS_NAME] [--tls-enable]
[--tls-cafile TLS-CAFILE] [--tls-capath TLS-CAPATH]
[--tls-protocols TLS-PROTOCOLS]
[--tls-cipher-suite TLS-CIPHER-SUITE]
[--tls-keyfile TLS-KEYFILE]
[--tls-keyfile-password [TLS-KEYFILE-PASSWORD]]
[--tls-certfile TLS-CERTFILE]
[--tls-cert-blacklist TLS-CERT-BLACKLIST] [--tls-crl-check]
[--tls-crl-check-all] [--config-file CONFIG-FILE]
[--instance INSTANCE] [--no-config-file]
[--only-config-file ONLY-CONFIG-FILE] [--tls_name TLS_NAME]
[--tls_enable] [--tls_cafile TLS_CAFILE]
[--tls_capath TLS_CAPATH] [--tls_protocols TLS_PROTOCOLS]
[--tls_cipher_suite TLS_CIPHER_SUITE]
[--tls_keyfile TLS_KEYFILE] [--tls_certfile TLS_CERTFILE]
[--tls_cert_blacklist TLS_CERT_BLACKLIST] [--tls_crl_check]
[--tls_crl_check_all] [--timeout TIMEOUT]

asinfo can be configured by using tools configuration files. Following summary explains all configuration options. Please see Aerospike Tools Configuration for more details.

OptionDefaultDescription
-hlocalhostIP Address or FQDN of the target Aerospike server.
-p3000Service port of the target Aerospike server.
-tTLS name of host to verify for TLS connection.
-UAerospike user name.
-PAerospike user password.
--authINTERNALAuthentication mode. Values: ['EXTERNAL', 'EXTERNAL_INSECURE', 'INTERNAL', 'PKI'].
-vCommand to send to the target server. If not provided returns a default set of results. See Commands section below.
-ldisabledReplaced semicolons ';' in with line breaks in the response.
-VdisabledShow the version of asinfo and exit.
-Edisabledshow program usage.
--tls-enabledisabledEnable TLS on connections.
--tls-cafilePath to a trusted CA certificate file.
--tls-capathPath to a directory of trusted CA certificates.
--tls-protocols'-all +TLSv1.2'Set the TLS protocol selection criteria.
--tls-cipher-suiteSet the TLS cipher selection criteria.
--tls-keyfilePath to the key for mutual authentication.
--tls-keyfile-passwordnonePassword to load protected tls-keyfile. It can be one of the following: 1) Environment varaible: 'env:<VAR>' 2) File: 'file:<PATH>' 3) String: 'PASSWORD'. User will be prompted on command line if --tls-keyfile-password specified and no password is given.
--tls-certfilePath to the chain file for mutual authentication.
--tls-cert-blacklistPath to a certificate blacklist file.
--tls-crl-checkEnable CRL checking for leaf certificate.
--tls-crl-check-allEnable CRL checking for entire certificate chain.
--timeout5 secondsSet timeout value in seconds. TLS connection does not support timeout.
--config-fileRead this file after default configuration file.
--instanceSection with these instance is read. e.g in case instance a is specified section cluster_a is read.
--no-config-filedisabledDo not read any config file.
--only-config-fileRead only this configuration file.

Example:

$ asinfo -v "namespaces"
requested value namespaces
value is user_profile;test;bar

Aerospike's Telnet Port

Aerospike also provides a telnet service which is typically configured to port 3003. This service provides the same functionality as asinfo, once connected type the same commands you would normally pass to asinfo's -v option.

info

This option is not available for security enabled servers. This option can also be disabled by commenting out or removing the info stanza from aerospike.conf. It is also possible to bind this service to localhost by setting the address field to 127.0.0.1.

Example:

$ telnet 127.0.0.1 3003
Trying 127.0.0.1...
Connected to 127.0.0.1.
Escape character is '^]'.
namespaces
user_profile;test;bar

Commands

For a comprehensive list of commands see Info Command Reference