Troubleshooting

업그레이드 후 웹 UI에 접근할 수 없음~

업그레이드 후 웹 UI에 접근할 수 없게 되는 데에는 여러 원인이 있을 수 있습니다. 버그는 발견되는 대로 지속적으로 수정되고 있습니다. 따라서 비슷한 증상에 대한 해결책이 담긴 오래된 GitHub 이슈나 포럼 게시물에 의존하지 마세요. 증상의 원인이 완전히 다른 것일 수 있기 때문입니다. 가장 먼저 해야 할 일은 업그레이드 로그(/var/log/aot/aotupgrade.log)에서 오류가 있는지 검토하는 것입니다. 다음으로, 아래 명령을 실행하여 업그레이드를 다시 시도해 볼 수 있습니다.

sudo /opt/AoT/aot/scripts/upgrade_post.sh

데몬이 실행되지 않음~

• 왼쪽 상단 시간/버전 텍스트의 색상을 확인하세요. 초록색은 데몬이 실행 중임을 나타내고, 주황색이나 빨간색은 문제가 있음을 나타낼 수 있습니다.
• 데몬 실행 여부 확인: 터미널에서 ps aux | grep aot_daemon.py 를 실행하고 반환되는 항목이 있는지 확인하세요.
• 로그 확인: [톱니바퀴 아이콘] -> AoT Logs 페이지나 /var/log/aot/ 에서 데몬 로그에 오류가 있는지 확인하세요. 문제가 업그레이드 이후에 시작되었다면 업그레이드 로그에서도 문제의 징후가 있는지 확인하세요.
• 위 제안들을 조사한 후에도 해결책을 찾지 못했다면 GitHub 이슈에서 열려 있는 이슈를 검색하거나 포럼에서 최근 이슈를 검색해 보세요.

잘못된 데이터베이스 버전~

• [톱니바퀴 아이콘] -> System Information 페이지를 확인하세요.
• "Database Version"이 초록색이면 올바른 버전입니다. 잘못된 버전은 빨간색으로 표시되어 버전이 올바르지 않음을 나타냅니다.
• 잘못된 데이터베이스 버전이란 AoT 설정 데이터베이스(/opt/AoT/databases/aot.db)에 저장된 버전이 AoT 설정 파일(/opt/AoT/aot/config.py)에서 정해진 최신 AoT 버전에 맞지 않는다는 것을 의미합니다.
• 이는 이전 데이터베이스 버전에서 새 버전으로 업그레이드하는 과정에서 발생한 오류나, AoT 업그레이드 과정에서 데이터베이스가 업그레이드되지 않은 경우로 인해 발생할 수 있습니다.
• 발생했을 수 있는 문제에 대해 업그레이드 로그를 확인하세요. 로그는 /var/log/aot/aotupgrade.log 에 있으며, (가능하다면) 웹 UI에서도 접근할 수 있습니다: [톱니바퀴 아이콘] -> AoT Logs -> Upgrade Log 를 선택하세요.
• 때로는 문제가 즉시 나타나지 않을 수 있습니다. 최신 업그레이드 이전, 실제로는 여러 AoT 버전 전에 발생한 데이터베이스 문제를 겪고 있는 경우도 드물지 않습니다.
• 데이터베이스가 얼마나 많은 버전 상태에 있을 수 있는지의 특성상, 데이터베이스 문제를 바로잡는 것은 매우 어려울 수 있습니다.

기존 설정 없이 데이터베이스를 삭제하고 새로 시작하는 것이 훨씬 쉬울 수 있습니다. 다음 명령을 사용하여 데이터베이스 이름을 변경하고 웹 UI를 재시작하세요. 두 명령이 모두 성공하면 브라우저에서 웹 UI 페이지를 새로고침하여 새 데이터베이스를 생성하고 새 Admin 사용자를 만드세요.

mv /opt/AoT/databases/aot.db /opt/AoT/databases/aot.db.backup
sudo service aotflask restart

UI 없이 백업 복원하기~

예를 들어 오류로 인해 웹 UI에 접근할 수 없는 경우 명령줄에서 백업을 복원할 수 있습니다. 자세한 내용은 백업 및 복원을 참조하세요.

문제 진단에 대한 추가 정보~

문제 진단에 대한 자세한 내용은 문제 진단을 확인하세요.