본문으로 건너뛰기
sstreamzet/docs
xSpan SDK 0.2.1콘솔 열기
개발자 문서 / xSpan SDK
R660 실기 검증 · 수정 2026-09-21

빠른 시작: 장비 테스트

전용 컴퓨터에서 기기별 설치 디렉터리를 준비하고, 한 대의 xSpan에 설치해 연결을 확인합니다.

1. 준비 사항

  • 지원 환경의 xSpan R660, 승인된 SSH 또는 OEM 공장 프로비저닝 접근.
  • 테스트 설치 ZIP, 별도로 받은 등록 키 파일과 StreamZet 운영 계정.
  • 준비 컴퓨터의 Python 3, 장비의 정확한 시간·DNS·외부 TCP 443 연결. 장비에는 Python이 필요하지 않습니다.

2. 압축 해제와 무결성 확인

sh
shasum -a 256 -c streamzet-xspan-evaluation-0.2.1-20260921.zip.sha256
unzip streamzet-xspan-evaluation-0.2.1-20260921.zip -d xspan-evaluation
cd xspan-evaluation
shasum -a 256 -c SHA256SUMS

Linux에서는 shasum 대신 sha256sum -c를 사용할 수 있습니다. 체크섬 파일도 ZIP과 함께 전달받으세요.

3. 기기별 설치 디렉터리 생성

sh
umask 077
mkdir -p ./provisioning
python3 device/prepare-device.py \
  --registration-key /secure/JCI-production-key.txt \
  --output ./provisioning/reader-001 \
  --name 'xSpan R660 001'

새 디렉터리에 실행 엔진, CA 파일, 시작/종료 스크립트, 등록 키와 고유한 64바이트 엔트로피 시드가 생성됩니다. 기존 출력 디렉터리를 재사용하면 도구가 거부합니다. 최초 실행 후 state/identity에 기기 UUID와 비밀정보가 저장됩니다.

4. 장비로 전송하고 시작

SSH 호스트 키를 검증한 연결 또는 승인된 공장 프로비저닝 경로를 사용하세요. 다음 예시는 아직 /mnt/spp/streamzet-jci가 없는 테스트 장비를 가정합니다. 설치 위치는 OEM의 영구 저장소 정책에 맞게 조정하세요.

sh
# On the provisioning computer
scp -pr ./provisioning/reader-001 root@READER_HOST:/mnt/spp/streamzet-jci

# In the reader's authorized shell
cd /mnt/spp/streamzet-jci
chmod 700 . state streamzet-embedded start.sh stop.sh
chmod 600 registration.key cacert.pem device-name state/entropy.seed
./start.sh

5. 연결 확인

  1. StreamZet에 로그인하고 Devices에서 지정한 이름의 장비가 온라인으로 나타나는지 확인합니다.
  2. 터미널을 열어 아래 읽기 전용 명령을 실행합니다. 출력이 실제 장비와 일치해야 합니다.
  3. Fleet → Linux → sh · xSpan / embedded에서 이번 테스트 장비 한 대만 선택하고 같은 명령을 실행합니다. 장비별 결과와 종료 코드를 확인합니다.
sh
printf 'STREAMZET_TEST_OK\n'
uname -m
uptime

일괄명령 큐는 약 30초 간격으로 확인합니다. 최초 등록은 비동기이므로 설치 명령의 성공만으로 온라인 상태가 보장되지는 않습니다.