FAQ & 트러블슈팅

연산 세션 리스트가 나타나지 않습니다

간헐적인 네트워크 문제나 기타 다양한 원인으로 인해 연산 세션 리스트가 정상적으로 표시되지 않을 수 있습니다. 대부분의 경우, 브라우저를 갱신하면 연산 세션이 정상적으로 보입니다.

갑자기 로그인이 안 됩니다

간혹 브라우저의 쿠키 문제 및 캐시된 데이터로 인해 로그인이 되지 않는 경우가 있습니다. 브라우저의 시크릿 모드에서 로그인을 시도 해보십시오. 만약 로그인이 된다면, 브라우저의 쿠키 및 애플리케이션 데이터를 삭제한 후 다시 로그인 해보시기 바랍니다.

apt 패키지를 설치하고 싶어요

보안 문제로 연산 세션 내부에서 사용자는 root 계정으로 전환하거나 sudo를 필요로 하는 명령을 실행할 수 없습니다. 따라서, apt, yum과 같이 sudo 권한을 요구하는 패키지 매니저를 통해서는 일반적으로 설치가 어렵습니다. 대신, brew <https://docs.brew.sh/Homebrew-on-Linux> 등과 같은 패키지 매니저를 활용할 수 있습니다.

brew 를 설치하고 사용하려면 다음 명령을 실행하십시오:

$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
$ test -d ~/.linuxbrew && eval $(~/.linuxbrew/bin/brew shellenv)
$ test -d /home/linuxbrew/.linuxbrew && eval $(/home/linuxbrew/.linuxbrew/bin/brew shellenv)
$ test -r ~/.bash_profile && echo "eval \$($(brew --prefix)/bin/brew shellenv)" >>~/.bash_profile
$ echo "eval \$($(brew --prefix)/bin/brew shellenv)" >>~/.profile

이제 brew 명령으로 패키지를 설치할 수 있습니다:

$ brew install hello

brew 는 패키지를 ~/.local 디렉토리 하위에 설치합니다. 따라서, .local 이라는 스토리지 폴더를 생성해두면 연산 세션을 삭제하고 새로운 연산 세션을 생성하더라도 기존에 설치했던 패키지를 다시 사용할 수 있습니다. . 으로 시작하는 스토리지 폴더는 별도로 마운트 하지 않아도 자동으로 마운트 됩니다.

pip 패키지를 설치하고 싶어요

brew 와 마찬가지로 pip 에는 ~/.local 하위에 패키지를 설치하는 옵션인 —user 가 있습니다.

$ pip install --user aiohttp

연산 세션을 생성했는데 Jupyter Notebook 을 열 수가 없습니다

WSProxy 서비스 접근에 문제가 있을 수 있습니다. WSProxy 서비스를 시작/중단/재시작 하는 항목을 참고하여 서비스를 중단하고 다시 시작해 봅시다.

표시되는 자원 양이 실제 할당된 양과 다릅니다

가끔 네트워크 연결이 튀거나 Docker 데몬의 컨테이너 관리 지연 등의 사유로 Backend.AI가 인식하는 자원의 할당양과 실제 컨테이너가 점유하고 있는 자원의 양이 달라질 수 있습니다. 이런 경우에는 다음 과정을 따라 하십시오.

  • 어드민 계정으로 로그인
  • Maintenance 페이지 방문.
  • RECALCULATE USAGE 버튼을 클릭하여 수동으로 자원 할당량 조정.

페이지가 이상하게 표시됩니다

Backend.AI Console은 최신 JavaScript와 브라우저의 기능을 적극 활용하고 있습니다. 가급적 최신 브라우저를 사용하십시오. 특히 Chrome에서 가장 안정적인 레이아웃을 보입니다.

서비스 접속 불가

일부 백엔드 서비스에 문제가 있을 수 있습니다. 각 서비스 시작/중단/재시작 가이드 항목을 참고하여 서비스를 중단하고 다시 시작해 봅시다.

Manager 서비스 시작/중단/재시작

Manager 노드로 SSH 접속 후 다음 명령을 실행하십시오.

systemctl start backendai-manager
systemctl stop backendai-manager
systemctl restart backendai-manager

Agent 서비스 시작/중단/재시작

Agent 노드로 SSH 접속 후 다음 명령을 실행하십시오.

systemctl start backendai-agent
systemctl stop backendai-agent
systemctl restart backendai-agent

Console-Server 서비스 시작/중단/재시작

Console-Server 노드로 SSH 접속 후 다음 명령을 실행하십시오.

systemctl start backendai-console-server
systemctl stop backendai-console-server
systemctl restart backendai-console-server

데이터베이스 서비스 시작/중단/재시작

DB 노드로 SSH 접속 후 다음 명령을 실행하십시오. <project> 부분은 수동으로 입력을 해야 한다는 점에 주의 하십시오. 서비스의 프로젝트 이름은 docker ps | grep postgres 명령의 출력 결과에서 해당 컨테이너의 이름 앞 부분을 보면 알 수 있습니다.

docker-compose -f docker-compose.hs.postgres.yaml -p <project> up -d
docker-compose -f docker-compose.hs.postgres.yaml -p <project> down
docker-compose -f docker-compose.hs.postgres.yaml -p <project> restart

Redis 서비스 시작/중단/재시작

Redis 노드로 SSH 접속 후 다음 명령을 실행하십시오. <project> 부분은 수동으로 입력을 해야 한다는 점에 주의 하십시오. 서비스의 프로젝트 이름은 docker ps | grep redis 명령의 출력 결과에서 해당 컨테이너의 이름 앞 부분을 보면 알 수 있습니다.

docker-compose -f docker-compose.hs.redis.yaml -p <project> up -d
docker-compose -f docker-compose.hs.redis.yaml -p <project> down
docker-compose -f docker-compose.hs.redis.yaml -p <project> restart

Etcd 서비스 시작/중단/재시작

Etcd 노드로 SSH 접속 후 다음 명령을 실행하십시오. <project> 부분은 수동으로 입력을 해야 한다는 점에 주의 하십시오. 서비스의 프로젝트 이름은 docker ps | grep etcd 명령의 출력 결과에서 해당 컨테이너의 이름 앞 부분을 보면 알 수 있습니다.

docker-compose -f docker-compose.hs.etcd.yaml -p <project> up -d
docker-compose -f docker-compose.hs.etcd.yaml -p <project> down
docker-compose -f docker-compose.hs.etcd.yaml -p <project> restart

WSProxy 서비스 시작/중단/재시작

WSProxy 노드로 SSH 접속 후 다음 명령을 실행하십시오. <project> 부분은 수동으로 입력을 해야 한다는 점에 주의 하십시오. 서비스의 프로젝트 이름은 docker ps | grep wsproxy 명령의 출력 결과에서 해당 컨테이너의 이름 앞 부분을 보면 알 수 있습니다.

docker-compose -f docker-compose.hs.wsproxy.simple.yaml -p <project> up -d
docker-compose -f docker-compose.hs.wsproxy.simple.yaml -p <project> down
docker-compose -f docker-compose.hs.wsproxy.simple.yaml -p <project> restart