---
title: "Aerospike Info (asinfo)"
description: "Guide to asinfo: Aerospike's CLI tool for managing cluster functions and changing server configurations at runtime."
---

# Aerospike Info (asinfo)

> For the complete documentation index see: [llms.txt](https://aerospike.com/docs/llms.txt)
> 
> All documentation pages available in markdown.

**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 Aerospike is running.

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

## Usage

`asinfo` is included in the Aerospike Tools package, and by default installs to `/usr/bin/asinfo`. Use the `--help` option to view `asinfo` syntax and commands:

```plaintext
asinfo --help
```

`asinfo` can be configured with the tools configuration files. The following summary explains all configuration options. Refer to [Aerospike Tools Configuration](https://aerospike.com/docs/database/tools/conffile) for more details.

| Option | Default | Description |
| --- | --- | --- |
| \-h | localhost | IP Address or FQDN of the target Aerospike server. |
| \-p | 3000 | Service port of the target Aerospike server. |
| \-t |  | TLS name of host to verify for TLS connection. |
| \-U |  | Aerospike user name. |
| \-P |  | Aerospike user password. |
| —auth | INTERNAL | Authentication mode. Values: \[‘EXTERNAL’, ‘EXTERNAL\_INSECURE’, ‘INTERNAL’, ‘PKI’\]. |
| \-v |  | Command to send to the target server. If not provided returns a default set of results. See [Commands section](#commands) below. |
| \-l | disabled | Replaced semicolons ’;’ in with line breaks in the response. |
| \-V | disabled | Show the version of asinfo and exit. |
| \-E | disabled | show program usage. |
| —tls-enable | disabled | Enable TLS on connections. |
| —tls-cafile |  | Path to a trusted CA certificate file. |
| —tls-capath |  | Path to a directory of trusted CA certificates. |
| —tls-protocols | ’-all +TLSv1.2’ | Set the TLS protocol selection criteria. |
| —tls-cipher-suite |  | Set the TLS cipher selection criteria. |
| —tls-keyfile |  | Path to the key for mutual authentication. |
| —tls-keyfile-password | none | Password to load protected tls-keyfile. It can be one of the following: 1) Environment variable: ‘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-certfile |  | Path to the chain file for mutual authentication. |
| —tls-cert-blacklist |  | Path to a certificate blacklist file. |
| —tls-crl-check |  | Enable CRL checking for leaf certificate. |
| —tls-crl-check-all |  | Enable CRL checking for entire certificate chain. |
| —timeout | 5 seconds | Set timeout value in seconds. TLS connection does not support timeout. |
| —config-file |  | Read this file after default configuration file. |
| —instance |  | Section with this instance is read. For example, if instance `a` is specified, then section `cluster_a` is read. |
| —no-config-file | disabled | Do not read any config file. |
| —only-config-file |  | Read only this configuration file. |

**Example:**

```plaintext
asinfo -v "namespaces"

requested value  namespaces

value is user_profile;test;bar
```

## Aerospike’s telnet port

In Database 8.0 and earlier, Aerospike provided a telnet service that was typically configured to port 3003. This service provided the same functionality as **asinfo**. After connecting, type the same commands you would normally pass to **asinfo’s** **\-v** option.

The telnet-compatible info port was removed in Database 8.1.0. For current Database versions, use `asinfo` over the service port or, when configured, the [admin port](https://aerospike.com/docs/database/manage/network#admin-section).

::: note
This option is not available for [security](https://aerospike.com/docs/database/manage/security/rbac) enabled servers. This option can also be disabled by commenting out or removing the `info` section from `aerospike.conf`. It is also possible to bind this service to localhost by setting the address field to 127.0.0.1.
:::

**Example:**

```plaintext
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 the [Info Command Reference](https://aerospike.com/docs/database/reference/info)