Nodes/solana/localhost/updates

solana

Solana / Agave 노드 업데이트 로그

3분 읽기 · localhost/updates

list목차(7)

Solana / Agave 노드 업데이트 로그

Solana 메인 클라이언트는 2024년부터 Agave(Anza)로 이름이 바뀌었습니다. 기존 solana-validatoragave-validator로 계승되었으며, CLI는 solana / agave-install이 함께 사용됩니다.

업데이트 체크리스트

  • 현재 버전: agave-validator --version
  • Cluster 요구 버전 확인: https://docs.anza.xyz/clusters/available 의 Required software version
  • Voting 계정 정상 상태 확인(skip rate, credit)
  • Snapshot 디렉토리 여유 공간 확보
  • Restart window(내 리더 슬롯이 멀리 떨어진 시점) 계산
  • agave-install update 실행 후 대기
  • 재기동 후 delinquent 상태에서 벗어났는지 확인

최근 메이저 릴리스

버전 요약 주의
v2.1.x (2024-Q4 ~ 2025-Q1) Turbine QUIC 안정화, SIMD 스케줄러, Access-List 중간 준비 하드웨어 요구 상승(256 GB RAM 권장)
v2.0.x (2024-Q3) Agave 리브랜딩 완료, Alt Bn128 precompile 안정화 구 solana-validator 중단
v1.18.x (2024-Q1) Jito-style tip 지원, Accounts DB 개선

업데이트 방법 (agave-install)

# agave-install 또는 solana-install 도구 사용
agave-install update

# 설치 확인
agave-validator --version

# 재시작 (심볼릭 링크가 업데이트된 후)
# 리더 슬롯이 멀리 떨어진 시점에 실행
agave-validator exit --wait-for-restart-window
sudo systemctl restart solana-validator

수동 릴리스 설치

VERSION=2.1.13
curl -L -o agave-${VERSION}.tar.bz2 \
  https://github.com/anza-xyz/agave/releases/download/v${VERSION}/solana-release-x86_64-unknown-linux-gnu.tar.bz2

tar -xjf agave-${VERSION}.tar.bz2
sudo cp -r solana-release/bin/* /usr/local/bin/
agave-validator --version

Firedancer (베타) 도입 시 주의

  • 2025년부터 Frankendancer(Agave + Firedancer 네트워크 스택) 하이브리드로 프로덕션 배포 가능
  • Full Firedancer는 완전 교체 — 설정 파일 포맷·RPC 동작이 다르므로 메인넷 도입 시 상세 검증 필수
  • 스냅샷/Ledger 호환은 유지되지만, 운영 스크립트 변경 폭이 큼

롤백

# 이전 버전 release 다운로드 후 동일 설치 절차
# delinquent가 지속되면 스냅샷 재다운로드가 가장 빠른 복구
solana catchup --our-localhost

참고

solana 다른 챕터