AeroLab - v6.2.0

Upgrading

If using AWS or GCP backends, extra steps are required to migrate the firewalls from AeroLab versions 6.0 or below to a new system.

Follow this manual for upgrade instructions

Documentation and changelog

See the documentation for full installation and usage instructions.

Changelog

Latest changes:

• Add option to filter instance types by name.
• Add pricing information to inventory instance-types command.
• Sort options for inventory instance-types command.
• Add a 24-hour cache of inventory instance-types to allow for quick lookup.
• Add display of price information on cluster and client creation.
• Add option to only display price (without actually creating clusters or clients) using --price in the create commands.
• Add nodes count multiplier to inventory instance-types to allow for easy cost visualization.
• Track instance cost in instance tags/labels.
• Show instance running costs in list views.
• Parallelize the following commands (with thread limits):
  • aerospike start/stop/restart/status
  • roster show/apply
  • files upload/download/sync
  • tls generate/copy
  • conf fix-mesh/rack-id
  • cluster create/start/partition */add exporter
  • xdr connect/create-clusters
  • client create base/none/tools
  • client configure tools
• Some config parsing bugfixes for handling of accidentally saved aerolab config defaults values.
• Allow specifying not to configure TLS for mesh in tls generate command.
• Allow specifying multiple disks of same type in gcp backend; for example --disk local-ssd@5 will request 5 local SSDs and --disk pd-ssd:50@5 will request 5 pd-ssd of size 50GB.
• Improve feature key file version checking.
• Allow tagging by owner during cluster and client creation. Specify owner to always use with aerolab config defaults -k '*.Owner' -v owner-name-all-lowercase-no-spaces.
• Capture outcomes of run commands in internal user telemetry.
• Add telemetry version into output.
• Add conf adjust to allow for adjusting aerospike configuration on a deployed cluster on the fly.
• Move to using Makefiles for build and linux packaging process.
• Fix handling of extra docker flags in docker backend.

Download aerolab from Assets below

Head to the releases page and download one of the installers, depending on where you are intending to execute aerolab command itself.

Note that aerolab will still be able to deploy Aerospike on both arm and x64 architectures, regardless of which aerolab binary you are using.

Operating System	CPU	File	Comments
MacOS	ALL	aerolab-macos-VERSION.pkg	multi-arch AeroLab installer for MacOS
MacOS	arm	aerolab-macos-arm64-VERSION.zip	single executable binary in a zip file
MacOS	Intel/AMD	aerolab-macos-amd64-VERSION.zip	single executable binary in a zip file
Linux (generic)	arm	aerolab-linux-arm64-VERSION.zip	single executable binary in a zip file
Linux (generic)	Intel/AMD	aerolab-linux-amd64-VERSION.zip	single executable binary in a zip file
Linux (centos)	arm	aerolab-linux-arm64-VERSION.rpm	RPM for installing on centos/rhel-based distros
Linux (centos)	Intel/AMD	aerolab-linux-x86_64-VERSION.rpm	RPM for installing on centos/rhel-based distros
Linux (ubuntu)	arm	aerolab-linux-arm64-VERSION.deb	DEB for installing on ubuntu/debian-based distros
Linux (ubuntu)	Intel/AMD	aerolab-linux-amd64-VERSION.deb	DEB for installing on ubuntu/debian-based distros

Install

It is advisable to use the provided installer files for your distro. Upon download, run the installation and aerolab command will become available.

Alternatively, manual installation can be performed by downloading the relevant zip file, unpacking it, and then moving the unpacked aerolab binary to /usr/local/bin/ or /usr/bin/. Remember to chmod +x the binary too.

AeroLab - v6.1.0

Upgrading

If using AWS or GCP backends, extra steps are required to migrate the firewalls to a new system.

Follow this manual for upgrade instructions

Documentation and changelog

See the documentation for full installation and usage instructions.

Changelog

Latest changes:

• Add extra version check in client tools creator.
• Fix support for amazon:2 on arm discovery.
• Add option for logs get to download logs in parallel using the --threads X option.
• Symlink attach shell command to cluster attach command.
• Add option in tls generate to have different bit sizes.
• If -f force option is not specified in the destroy commands, ask for confirmation via stdin.
• Basic anonymous telemetry enabled by default for internal Aerospike users.
• Added inventory list command, which prints all of the inventory (clusters, clients, firewalls, templates) in table or json format.
• Standardize the list commands to the inventory list output for cloud backends.
• Added nano command to all distributions.
• Update API packages to latest as of June 28th, 2023.
• Add new command inventory instance-types to allow for quick lookup of instance types in AWS and GCP clouds.
• Move all aerolab files and config paths to ~/.aerolab.
• When creating firewalls/security groups, by default these will be locked to the caller's IP address.
• Allow to specify custom name for firewalls and security groups.
• Make the GCP backend disks use the NVME interface for disks.
• The client create none now supports backends other than Docker.

Download aerolab from Assets below

Head to the releases page and download one of the installers, depending on where you are intending to execute aerolab command itself.

Note that aerolab will still be able to deploy Aerospike on both arm and x64 architectures, regardless of which aerolab binary you are using.

Operating System	CPU	File	Comments
MacOS	ALL	aerolab-macos-VERSION.pkg	multi-arch AeroLab installer for MacOS
MacOS	arm	aerolab-macos-arm64-VERSION.zip	single executable binary in a zip file
MacOS	Intel/AMD	aerolab-macos-amd64-VERSION.zip	single executable binary in a zip file
Linux (generic)	arm	aerolab-linux-arm64-VERSION.zip	single executable binary in a zip file
Linux (generic)	Intel/AMD	aerolab-linux-amd64-VERSION.zip	single executable binary in a zip file
Linux (centos)	arm	aerolab-linux-arm64-VERSION.rpm	RPM for installing on centos/rhel-based distros
Linux (centos)	Intel/AMD	aerolab-linux-x86_64-VERSION.rpm	RPM for installing on centos/rhel-based distros
Linux (ubuntu)	arm	aerolab-linux-arm64-VERSION.deb	DEB for installing on ubuntu/debian-based distros
Linux (ubuntu)	Intel/AMD	aerolab-linux-amd64-VERSION.deb	DEB for installing on ubuntu/debian-based distros

Install

It is advisable to use the provided installer files for your distro. Upon download, run the installation and aerolab command will become available.

Alternatively, manual installation can be performed by downloading the relevant zip file, unpacking it, and then moving the unpacked aerolab binary to /usr/local/bin/ or /usr/bin/. Remember to chmod +x the binary too.

AeroLab - v6.0.3

Instructions and changelog

See the documentation for full installation and usage instructions.

Changelog

Latest changes:

• Handle bug in IP discovery on docker backend with custom networks.

Download aerolab from Assets below

Head to the releases page and download one of the installers, depending on where you are intending to execute aerolab command itself.

Note that aerolab will still be able to deploy Aerospike on both arm and x64 architectures, regardless of which aerolab binary you are using.

Operating System	CPU	File	Comments
MacOS	ALL	aerolab-macos-VERSION.pkg	multi-arch AeroLab installer for MacOS
MacOS	arm	aerolab-macos-arm64-VERSION.zip	single executable binary in a zip file
MacOS	Intel/AMD	aerolab-macos-amd64-VERSION.zip	single executable binary in a zip file
Linux (generic)	arm	aerolab-linux-arm64-VERSION.zip	single executable binary in a zip file
Linux (generic)	Intel/AMD	aerolab-linux-amd64-VERSION.zip	single executable binary in a zip file
Linux (centos)	arm	aerolab-linux-arm64-VERSION.rpm	RPM for installing on centos/rhel-based distros
Linux (centos)	Intel/AMD	aerolab-linux-x86_64-VERSION.rpm	RPM for installing on centos/rhel-based distros
Linux (ubuntu)	arm	aerolab-linux-arm64-VERSION.deb	DEB for installing on ubuntu/debian-based distros
Linux (ubuntu)	Intel/AMD	aerolab-linux-amd64-VERSION.deb	DEB for installing on ubuntu/debian-based distros

Install

It is adviseable to use the provided installer files for your distro. Upon download, run the installation and aerolab command will become available.

Alternatively, manual installation can be performed by downloading the relevant zip file, unpacking it, and then moving the unpacked aerolab binary to /usr/local/bin/ or /usr/bin/. Remember to chmod +x the binary too.

AeroLab - v6.0.2

Instructions and changelog

See the documentation for full installation and usage instructions.

Changelog

Latest changes:

• Require GCP project when setting backend.
• Add handling for GCP local SSDs.

Download aerolab from Assets below

Head to the releases page and download one of the installers, depending on where you are intending to execute aerolab command itself.

Note that aerolab will still be able to deploy Aerospike on both arm and x64 architectures, regardless of which aerolab binary you are using.

Operating System	CPU	File	Comments
MacOS	ALL	aerolab-macos-VERSION.pkg	multi-arch AeroLab installer for MacOS
MacOS	arm	aerolab-macos-arm64-VERSION.zip	single executable binary in a zip file
MacOS	Intel/AMD	aerolab-macos-amd64-VERSION.zip	single executable binary in a zip file
Linux (generic)	arm	aerolab-linux-arm64-VERSION.zip	single executable binary in a zip file
Linux (generic)	Intel/AMD	aerolab-linux-amd64-VERSION.zip	single executable binary in a zip file
Linux (centos)	arm	aerolab-linux-arm64-VERSION.rpm	RPM for installing on centos/rhel-based distros
Linux (centos)	Intel/AMD	aerolab-linux-x86_64-VERSION.rpm	RPM for installing on centos/rhel-based distros
Linux (ubuntu)	arm	aerolab-linux-arm64-VERSION.deb	DEB for installing on ubuntu/debian-based distros
Linux (ubuntu)	Intel/AMD	aerolab-linux-amd64-VERSION.deb	DEB for installing on ubuntu/debian-based distros

Install

It is adviseable to use the provided installer files for your distro. Upon download, run the installation and aerolab command will become available.

Alternatively, manual installation can be performed by downloading the relevant zip file, unpacking it, and then moving the unpacked aerolab binary to /usr/local/bin/ or /usr/bin/. Remember to chmod +x the binary too.

AeroLab - v6.0.1

Instructions and changelog

See the documentation for full installation and usage instructions.

Changelog

Latest changes:

• Support for gcp backend.
• Add node exporter to the prometheus exporter setup.
• If feature file is not provided and cluster size is larger than 1, bail with critical error.
• Add legacy option to files upload and download functions.
• Partitioner conf command now requires a namespace before continuing.
• The net block command's speed greatly improved - changed execution logic.
• Allow to disable colors in conf generate command for some terminals.
• Add support for centos 9.
• Move to official quay repositories for centos version 8 and above.
• Move from centos 8 onwards to the stream edition.
• Multiple functional and OS-support bugfixes.
• Add client create none option for creating vanilla instances and containers.
• Check and confirm if docker is in use and clients are being deployed without forwarded ports.
• Deprecated jupyter client.

Download aerolab from Assets below

Head to the releases page and download one of the installers, depending on where you are intending to execute aerolab command itself.

Note that aerolab will still be able to deploy Aerospike on both arm and x64 architectures, regardless of which aerolab binary you are using.

Operating System	CPU	File	Comments
MacOS	ALL	aerolab-macos-VERSION.pkg	multi-arch AeroLab installer for MacOS
MacOS	arm	aerolab-macos-arm64-VERSION.zip	single executable binary in a zip file
MacOS	Intel/AMD	aerolab-macos-amd64-VERSION.zip	single executable binary in a zip file
Linux (generic)	arm	aerolab-linux-arm64-VERSION.zip	single executable binary in a zip file
Linux (generic)	Intel/AMD	aerolab-linux-amd64-VERSION.zip	single executable binary in a zip file
Linux (centos)	arm	aerolab-linux-arm64-VERSION.rpm	RPM for installing on centos/rhel-based distros
Linux (centos)	Intel/AMD	aerolab-linux-x86_64-VERSION.rpm	RPM for installing on centos/rhel-based distros
Linux (ubuntu)	arm	aerolab-linux-arm64-VERSION.deb	DEB for installing on ubuntu/debian-based distros
Linux (ubuntu)	Intel/AMD	aerolab-linux-amd64-VERSION.deb	DEB for installing on ubuntu/debian-based distros

Install

It is adviseable to use the provided installer files for your distro. Upon download, run the installation and aerolab command will become available.

Alternatively, manual installation can be performed by downloading the relevant zip file, unpacking it, and then moving the unpacked aerolab binary to /usr/local/bin/ or /usr/bin/. Remember to chmod +x the binary too.

AeroLab - v5.4.6

Instructions and changelog

See the documentation for full installation and usage instructions.

Changelog

Latest changes:

• Upgrade dependencies.
• Improve AWS security group locking for server groups.

Download aerolab from Assets below

Head to the releases page and download one of the installers, depending on where you are intending to execute aerolab command itself.

Note that aerolab will still be able to deploy Aerospike on both arm and x64 architectures, regardless of which aerolab binary you are using.

Operating System	CPU	File	Comments
MacOS	ALL	aerolab-macos-VERSION.pkg	multi-arch AeroLab installer for MacOS
MacOS	arm	aerolab-macos-arm64-VERSION.zip	single executable binary in a zip file
MacOS	Intel/AMD	aerolab-macos-amd64-VERSION.zip	single executable binary in a zip file
Linux (generic)	arm	aerolab-linux-arm64-VERSION.zip	single executable binary in a zip file
Linux (generic)	Intel/AMD	aerolab-linux-amd64-VERSION.zip	single executable binary in a zip file
Linux (centos)	arm	aerolab-linux-arm64-VERSION.rpm	RPM for installing on centos/rhel-based distros
Linux (centos)	Intel/AMD	aerolab-linux-x86_64-VERSION.rpm	RPM for installing on centos/rhel-based distros
Linux (ubuntu)	arm	aerolab-linux-arm64-VERSION.deb	DEB for installing on ubuntu/debian-based distros
Linux (ubuntu)	Intel/AMD	aerolab-linux-amd64-VERSION.deb	DEB for installing on ubuntu/debian-based distros

Install

It is adviseable to use the provided installer files for your distro. Upon download, run the installation and aerolab command will become available.

Alternatively, manual installation can be performed by downloading the relevant zip file, unpacking it, and then moving the unpacked aerolab binary to /usr/local/bin/ or /usr/bin/. Remember to chmod +x the binary too.

AeroLab - v5.4.5

Instructions and changelog

See the documentation for full installation and usage instructions.

Changelog

Latest changes:

• Fix duplicate switch problem when creating clusters.
• Add support for specifying a directory for feature file path to allow multiple feature file versions.

Download aerolab from Assets below

Head to the releases page and download one of the installers, depending on where you are intending to execute aerolab command itself.

Note that aerolab will still be able to deploy Aerospike on both arm and x64 architectures, regardless of which aerolab binary you are using.

Operating System	CPU	File	Comments
MacOS	ALL	aerolab-macos-VERSION.pkg	multi-arch AeroLab installer for MacOS
MacOS	arm	aerolab-macos-arm64-VERSION.zip	single executable binary in a zip file
MacOS	Intel/AMD	aerolab-macos-amd64-VERSION.zip	single executable binary in a zip file
Linux (generic)	arm	aerolab-linux-arm64-VERSION.zip	single executable binary in a zip file
Linux (generic)	Intel/AMD	aerolab-linux-amd64-VERSION.zip	single executable binary in a zip file
Linux (centos)	arm	aerolab-linux-arm64-VERSION.rpm	RPM for installing on centos/rhel-based distros
Linux (centos)	Intel/AMD	aerolab-linux-x86_64-VERSION.rpm	RPM for installing on centos/rhel-based distros
Linux (ubuntu)	arm	aerolab-linux-arm64-VERSION.deb	DEB for installing on ubuntu/debian-based distros
Linux (ubuntu)	Intel/AMD	aerolab-linux-amd64-VERSION.deb	DEB for installing on ubuntu/debian-based distros

Install

It is adviseable to use the provided installer files for your distro. Upon download, run the installation and aerolab command will become available.

Alternatively, manual installation can be performed by downloading the relevant zip file, unpacking it, and then moving the unpacked aerolab binary to /usr/local/bin/ or /usr/bin/. Remember to chmod +x the binary too.

AeroLab - v5.4.4

Instructions and changelog

See the documentation for full installation and usage instructions.

Changelog

Latest changes:

• Try to adjust vm.max_map_count=262144 on each client start for elasticsearch needs.
• Make promtail stack optional when launching run_asbench on the client machines.

Download aerolab from Assets below

Head to the releases page and download one of the installers, depending on where you are intending to execute aerolab command itself.

Note that aerolab will still be able to deploy Aerospike on both arm and x64 architectures, regardless of which aerolab binary you are using.

Operating System	CPU	File	Comments
MacOS	ALL	aerolab-macos-VERSION.pkg	multi-arch AeroLab installer for MacOS
MacOS	arm	aerolab-macos-arm64-VERSION.zip	single executable binary in a zip file
MacOS	Intel/AMD	aerolab-macos-amd64-VERSION.zip	single executable binary in a zip file
Linux (generic)	arm	aerolab-linux-arm64-VERSION.zip	single executable binary in a zip file
Linux (generic)	Intel/AMD	aerolab-linux-amd64-VERSION.zip	single executable binary in a zip file
Linux (centos)	arm	aerolab-linux-arm64-VERSION.rpm	RPM for installing on centos/rhel-based distros
Linux (centos)	Intel/AMD	aerolab-linux-x86_64-VERSION.rpm	RPM for installing on centos/rhel-based distros
Linux (ubuntu)	arm	aerolab-linux-arm64-VERSION.deb	DEB for installing on ubuntu/debian-based distros
Linux (ubuntu)	Intel/AMD	aerolab-linux-amd64-VERSION.deb	DEB for installing on ubuntu/debian-based distros

Install

It is adviseable to use the provided installer files for your distro. Upon download, run the installation and aerolab command will become available.

Alternatively, manual installation can be performed by downloading the relevant zip file, unpacking it, and then moving the unpacked aerolab binary to /usr/local/bin/ or /usr/bin/. Remember to chmod +x the binary too.

AeroLab - v5.4.3

Instructions and changelog

See the documentation for full installation and usage instructions.

Changelog

Latest changes:

• Handle malformed output from asinfo on error.
• Add backend option to specify non-standard temporary directory.
• Fix ulimits for linux docker desktop.
• Add auto-discovery of WSL2 for temp dir creation.

Download aerolab from Assets below

Head to the releases page and download one of the installers, depending on where you are intending to execute aerolab command itself.

Note that aerolab will still be able to deploy Aerospike on both arm and x64 architectures, regardless of which aerolab binary you are using.

Operating System	CPU	File	Comments
MacOS	ALL	aerolab-macos-VERSION.pkg	multi-arch AeroLab installer for MacOS
MacOS	arm	aerolab-macos-arm64-VERSION.zip	single executable binary in a zip file
MacOS	Intel/AMD	aerolab-macos-amd64-VERSION.zip	single executable binary in a zip file
Linux (generic)	arm	aerolab-linux-arm64-VERSION.zip	single executable binary in a zip file
Linux (generic)	Intel/AMD	aerolab-linux-amd64-VERSION.zip	single executable binary in a zip file
Linux (centos)	arm	aerolab-linux-arm64-VERSION.rpm	RPM for installing on centos/rhel-based distros
Linux (centos)	Intel/AMD	aerolab-linux-x86_64-VERSION.rpm	RPM for installing on centos/rhel-based distros
Linux (ubuntu)	arm	aerolab-linux-arm64-VERSION.deb	DEB for installing on ubuntu/debian-based distros
Linux (ubuntu)	Intel/AMD	aerolab-linux-amd64-VERSION.deb	DEB for installing on ubuntu/debian-based distros

Install

It is adviseable to use the provided installer files for your distro. Upon download, run the installation and aerolab command will become available.

Alternatively, manual installation can be performed by downloading the relevant zip file, unpacking it, and then moving the unpacked aerolab binary to /usr/local/bin/ or /usr/bin/. Remember to chmod +x the binary too.

AeroLab - v5.4.2

Instructions and changelog

See the documentation for full installation and usage instructions.

Changelog

Latest changes:

• Add nodes switch to add exporter command.
• Send a reload command on configure ams instead of restarting the service.
• Disable service update prompts for apt on ubuntu:22.04 in AWS.

Download aerolab from Assets below

Head to the releases page and download one of the installers, depending on where you are intending to execute aerolab command itself.

Note that aerolab will still be able to deploy Aerospike on both arm and x64 architectures, regardless of which aerolab binary you are using.

Operating System	CPU	File	Comments
MacOS	ALL	aerolab-macos-VERSION.pkg	multi-arch AeroLab installer for MacOS
MacOS	arm	aerolab-macos-arm64-VERSION.zip	single executable binary in a zip file
MacOS	Intel/AMD	aerolab-macos-amd64-VERSION.zip	single executable binary in a zip file
Linux (generic)	arm	aerolab-linux-arm64-VERSION.zip	single executable binary in a zip file
Linux (generic)	Intel/AMD	aerolab-linux-amd64-VERSION.zip	single executable binary in a zip file
Linux (centos)	arm	aerolab-linux-arm64-VERSION.rpm	RPM for installing on centos/rhel-based distros
Linux (centos)	Intel/AMD	aerolab-linux-x86_64-VERSION.rpm	RPM for installing on centos/rhel-based distros
Linux (ubuntu)	arm	aerolab-linux-arm64-VERSION.deb	DEB for installing on ubuntu/debian-based distros
Linux (ubuntu)	Intel/AMD	aerolab-linux-amd64-VERSION.deb	DEB for installing on ubuntu/debian-based distros

Install

It is adviseable to use the provided installer files for your distro. Upon download, run the installation and aerolab command will become available.

Alternatively, manual installation can be performed by downloading the relevant zip file, unpacking it, and then moving the unpacked aerolab binary to /usr/local/bin/ or /usr/bin/. Remember to chmod +x the binary too.