목적
이 글에서는 윈도우에서 갈라 노드 소프트웨어를 운영할 때 일반적으로 발생하는 이슈와 그 해결책에 대해 설명합니다.
참고 정보
이 글에서는 여러분이 아래 글에 기술된 내용을 이해하고 있다고 가정합니다.
내용
우선, 갈라 노드 소프트웨어의 최신 버전을 운영 중인지 확인해 주세요. 갈라 노드 소프트웨어를 업데이트하거나 설치하는 방법은 윈도우에 갈라 노드 소프트웨어 설치하기를 참고하세요.
아래 안내에 따라 문제 해결을 진행하기 전에, 우선 갈라 노드 소프트웨어가 운영되고 있는 컴퓨터에 VPN이 활성화되어 있지 않은지 확인하세요. (연결 문제를 일으킬 수 있기 때문입니다.) 컴퓨터의 안티바이러스 프로그램이나 방화벽이 소프트웨어가 제대로 작동하는데 방해가 되지는 않는지도 확인해 주세요.
1) 갈라 노드 소프트웨어가 돌아가지 않아요.
갈라게임즈 & 엔터테인먼트의 이용약관 동의
갈라 노드 소프트웨어를 실행하려면 계정에 로그인하여 이용약관에 동의해야 합니다. 이에 동의하지 않아 소프트웨어에 문제가 발생하는 경우, 계정에 로그인하고 업데이트된 이용약관에 동의하면 문제가 해결됩니다.
운영 시스템 미지원
윈도우 10 홈, 윈도우 서버 2019, 그리고 그 이상 버전은 지원되지 않습니다. 갈라 노드 소프트웨어를 운영하려면 윈도우 11 홈을 사용해야 합니다.
하드웨어 가상화
갈라 노드 소프트웨어를 운영하는 데 필요한 가상화 기능이 여러분의 컴퓨터에서 지원되는지 확인하세요. 내 컴퓨터가 가상화 기능을 지원하는지 확인이 필요하다면 윈도우11 가상화 확인 및 활성화시키기를 확인하세요.
2) 갈라 노드가 자꾸 오프라인으로 바뀌어요.
컴퓨터의 파워 부족
소프트웨어를 운영하는 컴퓨터의 파워가 부족한 경우, 이러한 문제가 발생할 수 있습니다. 갈라 노드 소프트웨어 운영에 필요한 사항에서 여러분의 컴퓨터가 필수 사양을 충족하는지 확인하세요.
오래된 소프트웨어 버전
오래된 소프트웨어 버전을 운영하는 경우, 노드가 지속적으로 오프라인 상태가 될 수 있습니다. 소프트웨어 버그 수정과 새로운 기능이 포함되기 때문에 소프트웨어를 항상 업그레이드하여 최신 버전으로 유지하는 것이 중요합니다.
불안정한 도커 버전
최신 버전의 도커에 버그가 있어 도커 충돌을 일으킬 수 있습니다. 이 문제를 겪는 경우, 현재 도커 버전을 제거하고, 최신 버전 수정 사항이 적용될 때까지 도커 버전 4.1.2을 설치해 주세요.
3) API 키가 잘못되었다고 나와요.
갈라 노드 소프트웨어에서 Wrong API Key (잘못된 API 키)라는 메시지가 나오면, 기존 API 키가 오래되었거나 더 이상 작동하지 않는 것입니다. 이러한 경우, 새로운 API 키를 생성하고 노드 소프트웨어에서 API 키를 업데이트해 줘야 합니다.
4) 갈라 노드 소프트웨어를 V2에서 V3로 업그레이드하라고 나와요.
갈라 노드 소프트웨어 V2를 삭제하고 윈도우에 갈라 노드 소프트웨어 설치하기에 따라 V3을 설치해 주세요.
5) 도커가 실행되지 않아요.
유저가 갈라 노드 소프트웨어를 시작할 때는 도커도 실행되고 있는지 확인해야 합니다. 일반적으로 도커는 사용자가 컴퓨터를 시작할 때 항상 열리도록 기본 설정되어 있지만, 도커가 열리지 않는 경우 Settings(설정) > General(일반)으로 이동하여 Start Docker Desktop when you log in(로그인 시 도커 데스크톱 시작) 옵션을 선택해 주세요.
6) 워크로드에 이슈가 있어요.
소프트웨어는 실행되고 있는데 워크로드가 온라인이 아니라고 나와요.
소프트웨어를 실행할 때, 갈라 노드 소프트웨어에서 워크로드를 활성화해야 합니다. 오른쪽 하단의 갈라게임즈 & 엔터테인먼트 아이콘을 우클릭하고, Select Workloads(워크로드 선택)을 클릭한 다음, 워크로드를 활성화할 수 있습니다. 자세한 내용은 윈도우에 갈라 노드 소프트웨어 설치하기 도움글을 참고하세요
워크로드를 활성화했는데도 워크로드가 온라인이 아니라고 나와요.
워크로드를 활성화한지 10분이 지나도 워크로드가 온라인 상태로 바뀌지 않는 경우, 새로운 API 키를 생성하면 문제 해결에 도움이 될 수 있습니다. 갈라 노드 소프트웨어에서 새로운 API 키를 생성하고 기존의 키를 교체할 수 있습니다. 자세한 내용은 다음 도움글을 참고하세요.
API 키가 바뀌면, 갈라 노드 소프트웨어를 다시 시작할 수 있습니다.
이중화(redundancy)를 위해 플레이어 노드 워크로드를 추가로 돌리는데요, 계정이 가지고 있는 것보다 더 많은 플레이어 노드(주크박스 노드)를 실행할 때마다 계속 오프라인 상태가 됩니다. 왜 그런가요?
플레이어 노드 워크로드는 구매한 만큼만 실행하면 됩니다. 두 개의 플레이어 노드 라이선스를 구매한 경우, 세 번째 워크로드는 강제로 오프라인 상태가 되면서 실행되지 못합니다. 왜냐하면 각각의 고유한 라이선스가 그에 해당하는 플레이어 노드에 연결되어 있기 때문입니다.
7) 127.0.0.1:6443 Bind address already in use라는 에러 메시지가 떠요.
다른 프로그램이 6443 포트를 이미 사용하고 있기 때문에 갈라 노드 소프트웨어가 구동되지 못하는 에러입니다. 다음 방법을 통해 이러한 문제를 해결할 수 있습니다.
- 운영체제(OS)가 업데이트되었는지 확인하세요. 그렇지 않은 경우 최신 버전으로 업데이트하세요.
- VPN이 활성화되어 있는지 확인하세요. VPN으로 인해 워크로드가 노드 서버에 연결되지 않을 수 있습니다.
여전히 문제가 해결되지 않는 경우, 6443 포트를 사용하는 프로그램이 없는지 다시 한번 확인해 주세요.
8) 노드 시작 오류(Error Starting Node; EOF)
아래와 같은 오류 메시지가 뜨는 경우, 노드 시작 오류가 발생한 것일 수 있습니다.
이러한 경우, 도커를 최신 빌드로 업데이트해야 합니다. 도커가 최신 상태가 되면, 윈도우 기기를 다시 시작합니다. 그런 다음, 윈도우 업데이트로 이동하여 컴퓨터가 최신 버전의 윈도우 운영체제를 실행 중인지 확인합니다.
9) TCP 에러
이 오류는 특정 애플리케이션이 도커가 필요로 하거나 요구하는 특정 포트를 사용하거나 점유하고 있는 경우에 발생합니다. 이를 해결하려면 다음과 같은 방법을 시도해 보세요.
1번 방법:
파워셸(Powershell)을 열어 아래와 같이 입력합니다.
Get-Process -Id (Get-NetTCPConnection -LocalPort 8080).OwningProcess
(이는 예시용 포트로, 다른 포트에 문제가 있는 경우 Port 8080 대신 문제가 있는 포트 번호를 입력하세요.)
그러면 해당 특정 포트를 사용하고 있는 프로세스가 표시됩니다. 여기서 필요한 것은 해당 프로세스의 ID입니다.
이번에는 아래와 같이 입력합니다.
Stop-Process -ID -Force
ID 자리에는 아까 첫 번째 명령어를 입력하여 나온 위 이미지에서 표시된 Id를 입력합니다.
그런 다음 갈라 노드 소프트웨어를 다시 시작합니다.
2번 방법:
파워셸(Powershell)을 열어 아래와 같이 입력합니다.
netstat -aon | findstr '5938'
이는 예시용 포트로, 다른 포트에 문제가 있는 경우 5938 대신 문제가 있는 포트 번호를 입력하세요. 이 명령어를 입력하면 프로세스 ID(Process ID)가 나옵니다. 이 ID를 다음 명령어에 사용합니다.
Tasklist | findstr "6380"
위 명령어를 입력하면 여러분의 컴퓨터에서 해당 특정 포트를 사용하고 있는 프로세스의 이름이 표시됩니다. 이 예시에서는 TeamViewer가 해당 포트를 사용하고 있습니다.
아래 명령어에 프로그램의 프로세스 ID를 입력하여 프로세스를 종료합니다.
taskkill /F /PID 6380