Zum Hauptinhalt springen

Offline- / Air-Gap-Installation (Air-gap)

Dieses Verfahren gilt für die Installation eines Gateways an Standorten ohne Internetzugang (militärische Einrichtungen / Anlagen mit erhöhter Sicherheitsstufe / bestimmte Werke). Die standardmäßige Schnellinstallation benötigt Zugriff auf product.kopens.io; da dies im Air-Gap-Netzwerk nicht möglich ist, müssen die Artefakte extern bezogen, per USB / NAS übertragen und anschließend installiert werden.

Container-Modus (2026.05+, empfohlen)​

Es werden zwei Dinge übertragen: das install-Paket und das Container-Image als tar.zst. Erkennt install.sh ein benachbartes image/*.tar.zst, erfolgt der Import automatisch über docker load (Umgehung des Registry-Pull).

Vorbereitungs-PC (mit Internetzugang)​

Erstellen Sie das Export-Bundle nicht von Hand, sondern brennen Sie es mit airgap-bundle.sh. Dadurch werden Repository-Dateien und Container-Image zu einer Einheit zusammengefasst, sodass keine Versionsabweichungen auftreten. In GitLab können Sie alternativ den manuellen Job airgap:export ausführen und das Ergebnis als Artifacts herunterladen.

# 1) 저장소 받기
curl -fsSLO https://product.kopens.io/plantpulse-edge/plantpulse-edge-docker.tar.gz
mkdir -p plantpulse-edge-docker
tar xzf plantpulse-edge-docker.tar.gz -C plantpulse-edge-docker --strip-components=1

# 2) 반출 번들 굽기 — 저장소 + 이미지가 함께 들어간다
sudo bash plantpulse-edge-docker/bin/airgap-bundle.sh

# 3) USB / NAS 로 옮김 (파일명 예: plantpulse-edge-images-2026.07.tar.gz)
cp plantpulse-edge-images-*.tar.gz /media/usb/

Air-Gap-Box (ohne Internet)​

sudo -i
mkdir -p /opt/kopens/plantpulse-edge-docker
tar xzf /media/usb/plantpulse-edge-images-*.tar.gz \
    -C /opt/kopens/plantpulse-edge-docker --strip-components=1
cd /opt/kopens/plantpulse-edge-docker/repo/bin
# 필요하면 env.sh 에서 EDGE_ID / SITE_ID 를 박스별로 조정한 뒤 실행
sudo bash airgap-load.sh
# airgap-load.sh: 오프라인 Docker 설치 → 이미지 docker load → install.sh(SKIP_PULL=1)

Nach der Installation im Container-Modus verifizieren:

sudo bash /opt/kopens/install/bin/status.sh
sudo bash /opt/kopens/install/bin/health.sh
curl -ks https://127.0.0.1/api/v1/system/version | python3 -m json.tool
curl -ks https://127.0.0.1/api/v1/system/health  | python3 -m json.tool

Auch im Air-Gap-Netzwerk gelten dieselben Abnahmekriterien. Dokumentieren Sie vor der Inbetriebnahme gemäß Produktions-Abnahmekriterien Backup-Dateien, Acceptance Log, Image Tag und die Übergabe der Zugangsdaten.

(legacy) Air-Gap-Verfahren im Native-Modus​

Das folgende Verfahren gilt ausschließlich für Native-Boxen vor 2026.05. Verwenden Sie für Neuinstallationen den obigen Container-Modus.

1. Benötigte Materialien​

PositionBemerkung
Internetfähiger Vorbereitungs-PCZum Herunterladen der Artefakte (ein Büro-PC genügt)
USB-Datenträger (32 GB+ empfohlen)Transport von Artefakten + Abhängigkeits-RPMs
PlantPulse-ArtefakteKOPENS_EDGE_V<version>.tar.zstd (~1 GB)
Kopie von install.shErfordert Anpassungen für den Air-Gap-Betrieb (URL → lokaler Pfad)
OS-RPM-PaketeVorab beziehen, damit dnf ohne Internetzugang installieren kann

2. Auf dem Vorbereitungs-PC (mit Internetzugang)​

2.1 Artefakte + install.sh herunterladen​

# USB 마운트 위치
USB=/mnt/usb

# 산출물 (가장 최신 버전 — 약 1GB)
curl --proto =https --tlsv1.2 --fail \
  -o $USB/KOPENS_EDGE_V2026.tar.zstd \
  https://product.kopens.io/plantpulse-edge/KOPENS_EDGE_V2026.tar.zstd

# install.sh 도 같이 (참고용 — 폐쇄망에선 수정 후 사용)
curl --proto =https --tlsv1.2 --fail \
  -o $USB/install.sh \
  https://product.kopens.io/plantpulse-edge/install.sh

# (옵션) sha256 검증 파일
curl --proto =https --tlsv1.2 --fail \
  -o $USB/install.sh.sha256 \
  https://product.kopens.io/plantpulse-edge/install.sh.sha256 || true

2.2 OS-Abhängigkeits-RPMs herunterladen (Basis: Fedora 38)​

Die von setup.sh per dnf installierten Pakete werden vorab nur heruntergeladen und auf den USB-Datenträger kopiert:

# 빈 디렉토리
mkdir -p $USB/rpms
cd $USB/rpms

# setup.sh 의 dnf install 라인의 패키지 목록
PKGS="tar htop fping pv firefox java-17-openjdk-devel jna jemalloc \
      jemalloc-devel zstd curl-devel expat-devel uuid wget sysstat \
      chrony tuned net-tools numactl nodejs npm python3 fail2ban \
      gcc glibc-devel zlib-devel libstdc++-static NetworkManager-tui \
      docker-ce docker-ce-cli containerd.io \
      java-17-amazon-corretto-devel"

# 의존성 포함 다운로드 (--downloadonly + --resolve)
sudo dnf install --downloadonly --resolve --downloaddir=$USB/rpms $PKGS

2.3 install.sh anpassen (URL → lokaler Pfad)​

# install.sh 의 다운로드 부분을 USB 경로로
sed -i 's|https://download\.kopens\.[a-z]*\.com|file:///mnt/usb|g' $USB/install.sh
sed -i 's|https://download\.kopens\.[a-z]*\.io|file:///mnt/usb|g'  $USB/install.sh
# (혹은 install.sh 내부의 `curl ... KOPENS_EDGE_*.tar.zstd` 라인을 직접 편집해 USB 경로 사용)

USB-Datenträger sicher entfernen.

3. Auf dem Gateway im Air-Gap-Netzwerk​

3.1 USB einbinden + RPMs gesammelt installieren​

# USB 인식
sudo mount /dev/sdb1 /mnt/usb       # 디바이스 명은 환경마다 다름

# RPM 일괄 설치 (의존성 자동 해결)
sudo rpm -Uvh --force --replacepkgs /mnt/usb/rpms/*.rpm

# (옵션) tar 보관소가 있으면 dnf 로도 가능:
#   sudo dnf install --disablerepo=* --nogpgcheck /mnt/usb/rpms/*.rpm

3.2 Artefakte entpacken​

sudo mkdir -p /opt
cd /opt
sudo tar -I 'zstd -d' -xvf /mnt/usb/KOPENS_EDGE_V2026.tar.zstd
# /opt/kopens 에 풀림

3.3 H/W-Initialisierung (optional) — die Abhängigkeitsschritte von tools/setup.sh überspringen​

Da der Schritt dnf install bereits über die RPMs erledigt wurde, werden nur einzelne Schritte von setup.sh manuell ausgeführt:

sudo -i
cd /opt/kopens/tools

# 호스트명
hostnamectl set-hostname EDGE_<number>

# env.sh 생성
cat > /opt/kopens/plantpulse-edge/conf/env.sh << EOF
export KOPENS_HOME=/opt/kopens
export PE_HOME=/opt/kopens/plantpulse-edge
export PE_DATA_DIR=/data1
export JAVA_HOME=/usr/lib/jvm/java-17-amazon-corretto
export CLEAN_ON_STARTUP=true
EOF
mkdir -p /data1

# 네트워크 (대화형)
./net/set-1.sh
./net/set-2.sh
systemctl restart NetworkManager.service

# 로케일 + 타임존
localectl set-locale LANG=ko_KR.utf8
timedatectl set-timezone Asia/Seoul

# tuned + 방화벽 + sysctl + chrony + ssl + vpn
systemctl enable --now tuned
tuned-adm profile throughput-performance
./firewall/open.sh
./file/run.sh
./ssl/gen.sh
# ./vpn/setup.sh   # 폐쇄망에선 보통 미사용

# CPU governor + hugepages
for f in /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor; do echo performance > $f; done
echo 9216 > /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages

# systemd 서비스 등록
cp /opt/kopens/tools/service/plantpulse.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable plantpulse

3.4 Start​

sudo systemctl start plantpulse
sleep 60          # 풀스택 부팅 대기
/opt/kopens/plantpulse-edge/bin/ps.sh
curl -s http://127.0.0.1/api/v1/system/health | jq

4. Upgrade (Air-Gap-Netzwerk)​

Der automatische Download von upgrade.sh benötigt Internet und ist daher nicht nutzbar. Manuelles Vorgehen:

# 1. 준비 PC 에서 새 산출물 USB 로 옮김 (위 2.1 동일)
# 2. 폐쇄망 게이트웨이에서:
sudo /opt/kopens/plantpulse-edge/bin/backup.sh

sudo /opt/kopens/plantpulse-edge/bin/stop.sh
cd /opt
sudo mv kopens kopens.old.$(date +%Y%m%d-%H%M%S)
sudo tar -I 'zstd -d' -xvf /mnt/usb/KOPENS_EDGE_V<new-version>.tar.zstd
sudo /opt/kopens/plantpulse-edge/bin/start.sh

Nach der Verifizierung das Verzeichnis kopens.old.* aufbewahren (oder bei Speicherplatzmangel löschen).

5. Häufige Stolperfallen​

SymptomUrsache / Abhilfe
dnf install hängt, weil kein Internet gefunden wirdOption --disablerepo=* vergessen. Genau die Option aus 3.1 verwenden
tar: Error opening archiveDie Artefakte auf dem USB-Datenträger wurden nur teilweise kopiert. Auf dem Vorbereitungs-PC sha256 vergleichen und erneut kopieren
systemctl status plantpulse → activatingHängt in einem der Schritte von bin/start.sh. Live-Verfolgung mit journalctl -u plantpulse -f
Uhrzeit falsch (1970)Kein NTP-Zugang im Air-Gap-Netzwerk. IP des internen NTP-Servers in /etc/chrony.conf eintragen
docker wird nicht installiertdocker-ce beim RPM-Download nicht enthalten. Docker-Repo von Fedora hinzufügen und erneut herunterladen
install.sh ruft die Download-URL aufAnpassung von sed vergessen — alle URLs in install.sh auf file:///mnt/usb/... umstellen

6. Weiterführende Informationen​