> For the complete documentation index, see [llms.txt](https://docs.hamonikr.org/hamonikr-6.0/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hamonikr.org/hamonikr-6.0/install/6.0upgrade.md).

# 6.0 업그레이드 가이드

하모니카 5.0에서 6.0으로 업그레이드 하는 방법입니다.

<mark style="color:red;">**반드시 중요한 파일들은 다른 저장 장치나 웹하드에 백업을 해두시기 바랍니다.**</mark>

<mark style="color:red;">**컴퓨터의 사양과 인터넷의 속도에 따라 30분 \~ 1시간의 시간이 소요됩니다.**</mark>

## 하모니카 5.0 패키지 최신버전으로 업그레이드

6.0으로 업그레이드 하기 위해서는 하모니카 5.0의 패키지를 최신버전으로 모두 업그레이드 해야합니다.

먼저 저장소 리스트를 최신화 합니다.

```bash
sudo apt update
```

<figure><img src="/files/DfR8bRTb65QJEQmxMzKM" alt=""><figcaption></figcaption></figure>

일부 저장소를 찾지 못해 다음과 같은 에러 메세지가 발생하는 경우가 있습니다.

루트리스 저장소의 경우 최근에 없어져서 다음과 같은 오류가 발생합니다.

저장소 리스트 정보 파일을 제거 해주어야 합니다.

<figure><img src="/files/1lMB52SRs7WrCfTPpqGN" alt=""><figcaption></figcaption></figure>

/etc/apt/sources.list.d 경로로 이동합니다.

```bash
cd /etc/apt/sources.list.d
```

문제가 있었던 리스트 파일을 제거합니다.

```bash
sudo rm lutris-team-lutris-focal.list
```

다시 저장소를 업데이트 해줍니다.

```bash
sudo apt update
```

<figure><img src="/files/Yfz3TGn0MkEBS1xysHkW" alt=""><figcaption></figcaption></figure>

다음과 같이 업데이트과 완료되었다면 업그레이드 명령어를 입력합니다.

```bash
sudo apt upgrade
```

<figure><img src="/files/ZxvyZuSywGlpXx59T8DZ" alt=""><figcaption></figcaption></figure>

다음과 같이 업그레이드 할 리스트 목록이 나타나며 진행할지 여부를 물어봅니다.

Y를 입력해줍니다.

<figure><img src="/files/aD4dvMacaqQhY9tROyhP" alt=""><figcaption></figcaption></figure>

업그레이드가 완료되면 6.0 업그레이드 정보가 있는 핵심 패키지가 정상적으로 설치되어 있는지 확인합니다.

hamonikr-upgrade-info는 2.0.5 버전 이상 hamonikr-update는 2.0.2 버전 이상이어야 합니다.

```bash
dpkg -l | grep hamonikr-upgrade-info
dpkg -l | grep hamonikr-update
```

<figure><img src="/files/SQidd4L0DPcJAt2IM2nZ" alt=""><figcaption></figcaption></figure>

모두 완료하였다면 시스템 트레이 아이콘에 ! 모양의 버튼을 클릭합니다.

<figure><img src="/files/mFlHUg1NlRBkjM0bvzlQ" alt=""><figcaption></figcaption></figure>

만약 보이지 않는다면 시작 메뉴에서 시스템 리포트를 검색해서 실행합니다.

<figure><img src="/files/n4zKvGSC6UOHv2L5gwTy" alt=""><figcaption></figcaption></figure>

다음과 같은 창이 생겼다면 "HamoniKR 6.0 LTS"로 업그레이드를 클릭합니다.

<figure><img src="/files/QRhAAfegeWra0Cws113Q" alt=""><figcaption></figcaption></figure>

새로운 창에서 다음을 계속 누르면 다음과 같은 진행 창이 나옵니다.

체크박스에 체크를 하고 적용 버튼을 누릅니다.

업그레이드가 진행되며 상당한 시간이 소요됩니다.

<figure><img src="/files/cQ2yApOMtvuAlRBbiX9v" alt=""><figcaption></figcaption></figure>

먼저 충돌이 나는 패키지를 선행으로 제거합니다.

<figure><img src="/files/K4EwEYYy3PctNrM2zV5G" alt=""><figcaption></figcaption></figure>

그 이후 6.0에서 버전이 올라간 패키지 업그레이드와 신규로 설치될 패키지들이 설치됩니다.

<figure><img src="/files/3Py13GLmZcaqULZt338i" alt=""><figcaption></figcaption></figure>

설치가 완료되면 재부팅이 필요합니다.

재부팅이 되면 서비스가 올라오면서 추가적인 설정이 진행되기 때문에 <mark style="color:red;">**반드시 재부팅을 해주시기 바랍니다.**</mark>

<figure><img src="/files/Y6GG0BYONswC2l31Zxpy" alt=""><figcaption></figcaption></figure>

재부팅을 하고 릴리즈 이름과 패키지 버전을 확인하는 방법입니다.

만약 5.15 보다 높은 커널을 사용하시는 경우 커널 버전이 다를 수 있습니다.

```bash
# 릴리즈 이름 확인
lsb_release -a

# 커널 버전 확인
uname -a
```

<figure><img src="/files/dLSRl3OMtmJjpEbVgOPU" alt=""><figcaption></figcaption></figure>
