Use AWS AMIs

Kaia offers an AWS AMI (Amazon Machine Image) for Kaia endpoint nodes (EN). These AMIs are pre-installed with both the EN software and the chaindata, enabling users to quickly and conveniently launch a fully operational node. With Kaia's AMI, setting up a new endpoint node on demand becomes seamless, allowing for simplifying the process of joining the Kaia network.

Why use AMI

AMI offers a convenient way to launch a new Kaia EN. Also, as its chaindata is already set, you don't need extra disk storage to download and extract compressed chaindata. Additionally, using AMI is the only option to operate a new EN without full sync for some sync modes, such as archive mode or full mode without state migration (we only provide snapshot download for pruned chaindata).

Types of EN AMIs

Kaia provides different types of AMIs, whose chaindata has been synced with different modes.

Type	Sync Mode	AMI Name
full	Full mode	kaia-xxxx-clean-full-en-xxxx
pruning	Full mode, live pruning enabled	kaia-xxxx-clean-pruning-en-xxxx
state-migrated	Full mode, state migrated (or state batch pruned)	kaia-xxxx-clean-en-xxxx
archive	Archive mode	kaia-xxxx-clean-archive-en-xxxx

Kaia provides these 4 types of AMIs for mainnet.

Note: The Kaia Foundation provided AWS AMIs for the Kairos testnet until October 29, 2024, and will cease to provide these after November 1, 2024

See State Batch Pruning for more details on state migrated chaindata. See Block Synchronization for more details on block sync modes.

AMI generation period

We generate the latest AMI every day around 6 pm KST. Once generated, the AMIs last for 3 days. The AMI has the date of creation appended in the name, such as kaia-mainnet-clean-en-20240926.

Launch new EC2 instance with AMI in Amazon console

When launching a new EC2 instance in the AWS console, you should select an AMI. Search for kaia-mainnet in the AMI search bar.

The page will bring you to the search results. Click "Community AMIs" tab in the search result page and select the AMI you want to use in the list.

Allow inbound connections

When launching a new EC2 instance in the AWS console, you can either create a new security group for the instance or choose existing security group. Either way, you must add inbound rules to allow connections to the ports that Kaia nodes use to communicate each other.

Navigate to the EC2 instance page in the AWS console, find associated security groups in the "Security" tab. You should add inbound rules for port 32323-32324.

IP version	Type	Protocol	Port range	Source
IPv4	Custom TCP	TCP	32323 - 32324	0.0.0.0/0
IPv4	Custom UDP	UDP	32323	0.0.0.0/0

Post-Launch Instance Preparation and Setup

Warmup Amazon EBS volumes

The Amazon EBS volumes that were created from snapshots (AMI would be one case), the storage blocks must be pulled down from Amazon S3 and written to the volume before they can be accessed. This causes a significant overhead for disk operations the first time each block is accessed. Volume performance is recovered after all blocks have been downloaded and written to the volume. For more details, see Initialize Amazon EBS volumes.

In order to get our volume ready, we can run a task to read all blocks.

$ sudo yum install -y fio

$ sudo fio --filename=/dev/nvme1n1 --rw=read --bs=128k --iodepth=32 --ioengine=libaio --direct=1 --name=volume-initialize

note

This task to warmup Amazon EBS volume would take a long time depending on the data size. Refer to fio output for the ETA.

Start kend service

In the EC2 instance, Kaia CLI client and the chaindata are installed. Also, kend, the script to start/terminate EN, is installed as a service. You can check the kend service's status by the following command.

$ sudo service kend status

If the service is not running, try to restart it.

$ sudo service kend restart

If the service restarted and the EN has started successfully, you can check its logs in the path /var/kend/logs/kend.out.

$ tail -f /var/kend/logs/kend.out

Kaia provides a CLI client ken console. You can interact with the Kaia node using the ken console via multiple endpoints, and one option is to use IPC (inter-process communication). The IPC file klay.ipc is located in the DATA_DIR path on an EN, in our case /var/kend/data. Thus in order to use ken console:

$ sudo ken attach --datadir /var/kend/data

Welcome to the Kaia JavaScript console!

instance: Kaia/vX.X.X/XXXX-XXXX/goX.X.X

datadir: /var/kend/data

modules: admin:1.0 debug:1.0 governance:1.0 istanbul:1.0 klay:1.0 miner:1.0 net:1.0 personal:1.0 rpc:1.0 txpool:1.0

>

Wait for block sync

Since the AMI was created hours ago, we need some time to sync to the latest block. You can check the currently synced block number and the sync progress in the ken console.

> klay.blockNumber

165227166

> klay.syncing

{

currentBlock: 165227166,

highestBlock: 165357203,

knownStates: 0,

pulledStates: 0,

startingBlock: 165222272

}

When the block sync is done, querying sync progress should return false.

> klay.syncing

false