# 문제 해결 ## Docker - “docker: unix:///var/run/docker.sock의 Docker 데몬에 연결할 수 없습니다. Docker 데몬이 실행 중인가요?” Docker를 시작합니다. sudo systemctl start docker Copy to clipboard - “데몬의 오류 응답: “[https://registry-1.docker.io/v2/](https://registry-1.docker.io/v2/)” 가져오기: http: 서버가 HTTPS 클라이언트에 HTTP 응답을 제공했습니다” 1. 내부 Docker 레지스트리 미러(Qualcomm 네트워크의 내부 설정)를 추가하세요. JSON 구성 파일에 # 주석을 포함하지 마세요. 공백을 비롯한 기타 보이지 않는 공백 문자 대신 탭을 사용하면 JSON 구성 파일의 기능이 손상될 수 있으며 `docker.service` 가 시작되지 않을 수도 있습니다. sudo vim /etc/docker/daemon.json # Add an entry similar to the following in /etc/docker/daemon.json: { "registry-mirrors": ["https://docker-registry.qualcomm.com"] } Copy to clipboard 참고 대신 다음 항목을 `/etc/docker/daemon.json` 에 추가하는 방법이 있습니다. `"registry-mirrors": ["https://ccr.ccs.tencentyun.com"]` 2. Docker 서비스를 다시 시작하여 새로운 설정을 적용하세요. sudo systemctl restart docker Copy to clipboard - “[https://download.docker.com](https://download.docker.com) 에서 다운로드하지 못했습니다” > > > [https://download.docker.com](https://download.docker.com) 에 접근할 수 없거나 이 사이트에서 다운로드할 수 없는 경우 다음 명령어를 실행하여 docker를 설치하세요. > > > > > > > > > sudo apt update > > sudo apt install apt-transport-https ca-certificates curl gnupg lsb-release > > curl -fsSL http://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo apt-key add – > > sudo add-apt-repository "deb [arch=amd64] http://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable" > > Copy to clipboard - “가상화가 활성화되지 않아 Docker 오류 발생” 이 오류를 해결하려면 BIOS에서 가상화를 활성화하세요. 시스템 제공업체별 지침에 따라 가상화를 활성화하세요. 예를 들어 다음 단계에 따라 시스템 제공업체에서 제공하는 가상화를 활성화할 수 있습니다. 1. 시스템이 부팅되면 BIOS를 한 단계씩 실행합니다. BIOS 창이 표시됩니다. 2. Advanced 탭으로 전환합니다. 3. CPU Configuration 섹션에서 Virtualization Technology 를 활성화됨으로 설정합니다. 4. 저장하고 종료합니다. 5. 시스템을 다시 시작합니다. - “unix:///var/run/docker.sock에서 Docker 데몬 소켓에 연결하려 할 때 권한이 거부되었습니다” 이 오류는 `qsc-cli` 가 이미 컴퓨터에 설치되어 있고 사용자가 Docker 그룹에 속해 있지 않은 경우에 발생합니다. 1. Docker 그룹에 추가합니다. sudo groupadd docker sudo usermod -aG docker $USER newgrp docker Copy to clipboard 2. Docker 그룹에 속해 있는지 확인합니다. sudo grep /etc/group -e "docker" # This command shows a list of users who are part of the Docker group; must include your user ID Copy to clipboard 3. 접근 권한을 적용하려면 로그아웃했다가 다시 로그인합니다. # You can run the following command to check if you are part of the Docker group id -a # This command returns an output string which should include 'docker' Copy to clipboard ## 동기화 - “ManifestInvalidRevisionError 제외 repo 초기화 또는 동기화 오류, e:” 이 문제는 Repo 패키지를 설치한 후에 표시될 수 있습니다. - `/etc/gitconfig` 또는 `~/.gitconfig` 에 내부 미러에 대한 리디렉션이 있는 경우. - 미러링하는 동안 내부 미러에 분기에 대한 접두사가 있는 경우. 예를 들어 `/etc/gitconfig` 가 리디렉션되고 내부 미러에 `aosp/stable` 로 미러링된 업스트림 git의 안정적인 분기가 있는 경우 `repo init` 를 수행하는 동안 다음 오류가 표시됩니다. [url "ssh://:/tools/repo"] insteadOf = https://android.googlesource.com/tools/repo insteadOf = https://gerrit.googlesource.com/git-repo Copy to clipboard File "/local/mnt/workspace//test_repo/.repo/repo/main.py", line 126 except ManifestInvalidRevisionError, e: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ SyntaxError: multiple exception types must be parenthesized Copy to clipboard 이 오류를 해결하는 단계는 다음과 같습니다. 1. 오래된 `.repo` 폴더를 삭제합니다. 이 폴더는 이전에 `repo init` 명령을 실행했던 디렉토리에 있습니다. rm -rf .repo Copy to clipboard 2. repo 명령어를 내보낸 후 실행하여 repo 문제를 해결합니다. REPO\_REV는 [https://gerrit.googlesource.com/git-repo](https://gerrit.googlesource.com/git-repo) 의 업스트림 ‘안정형’ 분기에서 미러링된 분기를 가리켜야 합니다. export REPO_REV='aosp/stable' Copy to clipboard - “repo 설치 “서버 인증서 확인 실패”” - “서버 인증서 확인 실패. CAfile: 없음 CRLfile: 없음” 같은 인증서 오류가 표시되면 git 구성으로 SSL 인증서 확인을 비활성화하도록 git을 구성하세요. 추가 지침은 IT 관리 팀에 문의하세요. 다음 명령어 중 하나를 사용하여 SSL을 비활성화할 수 있습니다. export GIT_SSL_NO_VERIFY=1 git config --global http.sslverify false Copy to clipboard - 현재 지역에서 `android.googlesource` 에 대한 접근이 차단된 경우 다음 구성을 사용하여 CodeLinaro 미러에서 Repo를 페치하세요. git config --global url.https://git.codelinaro.org/clo/la/tools/repo.insteadOf https://android.googlesource.com/tools/repo Copy to clipboard - “error.GitError: git config (‘–replace-all’, ‘color.ui’, ‘auto’): error: could not write config file /home/$USER/.gitconfig: Device or resource busy” 이 오류는 gitconfig에서 UI 색상 구성을 설정하지 않은 경우에 발생합니다. 이 구성은 기본적으로 Git 1.8.4 이후 버전에서 설정되어 있습니다. 다음 명령어를 실행하여 계정에서 색상 디스플레이를 활성화하세요. git config --global color.ui auto Copy to clipboard - “[오류]: 컴파일할 빌드를 준비하지 못했습니다. 오류: Docker 자격 증명 설정 중 오류가 발생했습니다. 오류: “자격 증명 저장 중 오류 발생: 임시 파일 닫는 중 오류 발생: /usr2/<userid>/.docker/config.json3322274803 닫기: 디스크 할당량 초과됨\n”” QSC CLI에서 홈 디렉토리에 오직 몇 킬로바이트(kB)만 사용합니다. 홈 디렉토리에서 몇 MB 정도의 용량을 삭제하세요. - “[오류]: “path” 인자는 문자열 유형이어야 합니다. 정의되지 않은 인자를 수신” **오류 발췌 내용** qsc-cli chip-software download --workspace-path '/local/mnt/workspace//K2L/QSC_CLI_BUILD/build' --product 'QCM6490.LE.1.0' --release 'r00270.1' --distribution 'Qualcomm_Linux.SPF.1.0|TEST|DEVICE|PUBLIC' [Info]: Starting qsc-cli version 0.0.0.7 (node:2924765) ExperimentalWarning: The Fetch API is an experimental feature. This feature could change at any time (Use `qsc-cli --trace-warnings ...` to show where the warning was created) [Info]: Checking if Workspace already exists [Info]: Saved updated Workspace info [Info]: Workspace Setup Completed [Error]: The "path" argument must be of type string. Received undefined Copy to clipboard **해결방법** 이 오류는 QSC CLI가 Qlauncher와 호환되지 않는 경우에 발생합니다. Qlauncher는 더 이상 사용되지 않으며 QSC의 새로운 애플리케이션으로 대체될 예정입니다. 작업 영역에 Qlauncher가 있는 경우 다음 명령어를 실행할 수 있습니다. # Find your workspace within the Qlauncher UI # Take a backup of the following metadata file if you want to preserve the older workspace created with Qlauncher. # These will work only with Qlauncher app. You can reinstall the app at a later time again to access. If you don't # need the workspaces, you can delete this file using: mv /var/lib/qcom/data/qualcomm_launcher/workspaces2.json /var/lib/qcom/data/qualcomm_launcher/workspaces2.json.bak # Uninstall Qlauncher with the following command: qsc-cli tool uninstall qualcomm_launcher Copy to clipboard - “docker: Error response from daemon: error while creating mount source path ‘/usr2/<userid>/.netrc’: mkdir /usr2/<userid>/.netrc: permission denied” **오류 발췌 내용** Updating files: 100% (64/64), done. 2024-02-29T07:58:00: Sync Command Completed 2024-02-29T07:58:01: Finished setup. [Info]: Setting Docker Credential 2024-02-29T07:58:03: Authorization successful 2024-02-29T07:58:03: Sync Command Starting 2024-02-29T07:58:03: Running Sync Command for SyncOpenSourceCode - DownloadOpenSource docker: Error response from daemon: error while creating mount source path '/usr2/ramevelp/.netrc': mkdir /usr2/ramevelp/.netrc: permission denied. 2024-02-29T07:58:04: Sync Command Failed [Error]: Failed SP Download with error: 2024-02-29T07:58:04: Sp Download failed. ExitCode: 126 Signal: 0 with errorcode 4 [Error]: 2024-02-29T07:58:04: Sp Download failed. ExitCode: 126 Signal: 0 Copy to clipboard **해결방법** 이 오류는 IT에서 홈 디렉토리를 설정한 방식 때문에 발생할 수 있습니다. IT 관리자와 협력하여 홈 디렉토리를 추가로 변경할 사항이 있는지 확인하세요. - “fatal: couldn’t find remote ref refs/heads/qcom-linuxSTXscarthgap” PDF에서 명령어를 복사하는 동안 잘못된 문자가 표시되는 경우 잘못된 문자를 제거하거나 적절한 기호로 대체하고 명령어를 다시 실행하세요. **예시** # Replace the following command repo init -u https://github.com/quic-yocto/qcom-manifest -b qcom-linuxSTXscarthgap -m qcom-6.6.90-QLI.1.5-Ver.1.1.xml # with repo init -u https://github.com/quic-yocto/qcom-manifest -b qcom-linux-scarthgap -m qcom-6.6.90-QLI.1.5-Ver.1.1.xml Copy to clipboard - “pull access denied for 032693710300.dkr.ecr.us-west-2.amazonaws.com/stormchaser/ql-tool” 이 오류는 `qsc-cli` 다운로드 명령을 실행하는 동안 발생할 수 있습니다. **오류 발췌 내용** Unable to find image '032693710300.dkr.ecr.us-west-2.amazonaws.com/stormchaser/ql-tool:20.04.20231220102843864.9' locally docker: Error response from daemon: pull access denied for 032693710300.dkr.ecr.us-west-2.amazonaws.com/stormchaser/ql-tool, repository doesn't exist or may require 'docker login': denied: Your authorization token has expired. Reauthenticate and try again. Copy to clipboard **해결방법** rm -rf ~/.docker/config.json Copy to clipboard `qsc-cli` 명령어를 다시 실행하세요. ## 빌드 - “ERROR: linux-kernel-qcom-6.6-r0 do\_menuconfig: No valid terminal found, unable to open devshell” 이 오류는 `bitbake linux-kernel-qcom -c menuconfig` 명령어를 실행하는 동안 트리거될 수 있습니다. **오류 발췌 내용** ERROR: linux-kernel-qcom-6.6-r0 do_menuconfig: No valid terminal found, unable to open devshell. Tried the following commands: tmux split-window -c "{cwd}" "do_terminal" tmux new-window -c "{cwd}" -n "linux-kernel-qcom Configuration" "do_terminal" xfce4-terminal -T "linux-kernel-qcom Configuration" -e "do_terminal" terminology -T="linux-kernel-qcom Configuration" -e do_terminal Copy to clipboard **해결방법** sudo apt install screen sudo apt install tmux Copy to clipboard - “참고: 30초 동안 서버 응답 없음” 빌드 중 `qsc-cli chip-software compile` 또는 `bitbake` 명령어를 다시 실행할 때 이 오류가 표시되면, 부분적으로 빌드된 작업 영역에서 `bitbake.lock`, `bitbake.sock` 및 `hashserve.lock` 을 삭제하고 빌드를 다시 시도해 보세요. 예를 들어 `qsc-cli` 를 사용하여 빌드 중인 경우 이 파일은 `/DEV/LE.QCLINUX.1.0.r1/build-qcom-wayland` 에 있습니다. - “do\_fetch: BitBake 페처 오류: FetchError(‘소스에서 URL을 페치할 수 없음’)” 일시적인 페치 오류입니다. 사용자 측에 네트워크/호스트 문제가 있는지 확인하세요. 그렇지 않으면 이 문제는 서버에서 발생한 것일 수 있습니다. git 저장소를 페치하는 동안 오류가 발생하면 `.gitconfig` 파일에서 `postBuffer` 및 `maxRequestBuffer` 설정을 늘릴 수 있습니다. `qsc-cli` 를 사용 중이라면 `qsc-cli` 도구가 이미 이 구성을 관리하고 있습니다. git config --global http.postBuffer 1048576000 git config --global http.maxRequestBuffer 1048576000 Copy to clipboard 이러한 구성이 작동하지 않으면 최초로 발생하는 일시적 오류를 건너뛰도록 컴파일을 다시 시도해 보세요. 대규모 git 프로젝트 일부에서 이 오류가 생성될 수 있습니다. 이러한 시나리오의 경우, 프로젝트를 수동으로 복제하세요. cd /downloads/git2/ git clone --bare --mirror https:///.git /downloads/git2/.git touch /downloads/git2/.git.done Copy to clipboard 예를 들어 `qualcomm_linux-spf-1-0-le-qclinux-1-0-r1_api-linux_history_prebuilts.git` 에 대해 `do_fetch` 가 실패하면 다음 명령어를 실행하세요. git clone --bare --mirror https://qpm-git.qualcomm.com/home2/git/revision-history/qualcomm_linux-spf-1-0-le-qclinux-1-0-r1_api-linux_history_prebuilts.git /downloads/git2/qpm-git.qualcomm.com.home2.git.revision-history.qualcomm_linux-spf-1-0-le-qclinux-1-0-r1_api-linux_history_prebuilts.git touch /downloads/git2/qpm-git.qualcomm.com.home2.git.revision-history.qualcomm_linux-spf-1-0-le-qclinux-1-0-r1_api-linux_history_prebuilts.git.done Copy to clipboard `.done` 파일을 만든 후 `bitbake ` 명령어를 계속 진행하세요. 초기 빌드를 완료한 후에는 [다운로드 디렉토리](https://docs.yoctoproject.org/4.0.16/singleindex.html#term-DL_DIR) 를 직접 설정하는 것이 좋습니다. - “make[4]: /bin/sh: 인자 목록이 너무 깁니다” 이 오류는 작업 영역의 경로가 90자를 초과하는 경우에 발생합니다. 이 오류를 방지하려면 작업 영역 경로의 길이를 줄이세요. - “kernel-source/arch/arm64/boot/dts/qcom/qcm6490-idp.dts:8:10: 심각한 오류: dt-bindings/iio/qcom,spmi-adc7-pmk8350.h: 해당 파일 또는 디렉토리 없음” `qcom,spmi-adc7-pmk8350.h` 파일은 커널 소스 `/include/dt-bindings/iio/qcom,spmi-adc7-pmk8350.h` 의 일부입니다. 1. 작업 영역에서 이 파일을 확인하고 환경을 초기화하여 이 파일을 선택하세요. dtbs를 컴파일하는 동안 커널 빌드 시스템은 GCC 전처리기를 실행하여 dts 파일의 매크로를 해당 정의에 따라 대체합니다. 언급된 경로는 여러 `includes` 가 상주하는 장소입니다. 2. git 구성에서 `core.symlinks` 가 `false` 로 설정되었는지 확인하고, 그럴 경우 true로 설정하세요. git config --global core.symlinks true Copy to clipboard - “qpm-git.qualcomm.com.home2.git.revision-history.qualcomm\_linux-spf-1-0-le-qclinux-1-0-r1\_api-linux\_history\_prebuilts.git –progress가 실패함(종료 코드 128), 출력 없음” 128은 마스킹 오류이며 이 오류는 사용자 측의 네트워크 문제이거나 Qualcomm 또는 업스트림 미러에 접근하는 실제 문제일 수 있으므로 추가 심사가 필요합니다. 이 오류의 해결 방법은 [BitBake 페처 오류](https://docs.qualcomm.com/doc/80-70020-254K/topic/troubleshoot_sync_build_and_flash.html#do-fetch-error-1) 를 참조하세요. 후속 지침에 따라 페치 도중 자세한 로그(verbose log)를 덤프하여 오류를 추가로 심사할 수 있습니다. 기본적으로 Yocto git 페치의 경우 자세한 로깅이 활성화되지 않습니다. 모든 레시피에 대해 git 자세한 로깅을 활성화하면 빌드 시간이 상당히 늘어날 수 있습니다. 필요한 레시피에서만 활성화하는 것이 좋습니다. 모든 git 프로젝트에 동일하게 활성화하려면 `local.conf` 파일을 편집하고 `BB_GIT_VERBOSE_FETCH` 값을 **1** 로 변경하세요. 각 레시피에 대해 자세한 로깅을 활성화할 수도 있습니다. 예를 들어 자세한 로깅을 활성화하고 diag 레시피에서 `do_fetch()` 오류를 디버그하려면 다음 단계를 수행하세요. 1. `layers/meta-qcom-hwe/recipes-bsp/diag/daig_15.0.bb` 를 편집하고 `BB_GIT_VERBOSE_FETCH = "1"` 라인을 추가합니다. 2. `bitbake -fc cleanall diag` 를 사용하여 이전에 다운로드한 아티팩트를 정리합니다. 3. `bitbake -fc fetch diag` 를 사용하여 소스를 다시 페치합니다. 4. diag 레시피의 작업 디렉토리 `build-qcom-wayland/tmp-glibc/work/qcm6490-qcom-linux/diag/15.0-r0/temp` 에서 자세한 로깅을 사용할 수 있는 로그를 페치합니다. 5. 이 경로의 `log.do_fetch` 를 퀄컴 지원팀과 공유합니다. - “오류로 인해 SP 다운로드 실패: <> Sp 다운로드에 실패했습니다. ExitCode: 128 신호: 0 with errorcode 4” **오류 발췌 내용** warning: redirecting to https://git-na-ssl.chipcode.qti.qualcomm.com/57f0ec058e47f7a82b2de7b95111c74a/qualcomm/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem.git/ remote: Counting objects: 129803, done. remote: Compressing objects: 100% (114948/114948), done. fatal: write error: No space left on device5 GiB | 1.63 MiB/s fatal: fetch-pack: invalid index-pack output 2024-03-02T14:32:18: Sync Command Failed [Error]: Failed SP Download with error: 2024-03-02T14:32:18: Sp Download failed. ExitCode: 128 Signal: 0 with errorcode 4 [Error]: 2024-03-02T14:32:18: Sp Download failed. ExitCode: 128 Signal: 0 Copy to clipboard **해결방법** 오류 로그에 “fatal: write error: No space left on device” 같이 기기에 공간이 없다는 오류가 표시됩니다. 공간을 정리하고 다시 트리거하세요. - “File “/usr/lib/python3.10/locale.py”, line 620, in setlocale return \_setlocale(category, locale)locale.Error: unsupported locale setting” 이 오류를 해결하려면 다음 명령어를 실행하고 다시 컴파일하세요. sudo locale-gen en_US.UTF-8 sudo update-locale LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8 export LC_ALL=en_US.UTF-8 export LANG=en_US.UTF-8 Copy to clipboard - “layer directories do not exist build-qcom-wayland/conf/../../layers/meta-qcom-qim-product-sdk” 이 오류가 발생하는 원인은 다음 중 하나입니다. - `meta-qcom-qim-product-sdk` 의 Git 복제가 성공적으로 완료되지 않았습니다. - `meta-qcom-qim-product-sdk` 계층을 EXTRALAYERS로 내보내지 않았습니다. **오류 발췌 내용** xxxx@xxxx:~/github_un/build-qcom-wayland$ bitbake qcom-multimedia-image ERROR: The following layer directories do not exist: ERROR: /build-qcom-wayland/conf/../../layers/meta-qcom-qim-product-sdk ERROR: Please check BBLAYERS in /build-qcom-wayland/conf/bblayers.conf Copy to clipboard **해결방법** 1. `build-qcom-wayland` 디렉토리를 제거합니다. 2. [Qualcomm IM SDK 이미지 빌드](https://docs.qualcomm.com/doc/80-70020-254K/topic/github_workflow_unregistered_users.html#build-qimp-sdk-image-unreg) 의 명령어를 다시 실행합니다. - “failed: database disk image is malformed. abort()ing pseudo client by server request” 파일 시스템 작업을 처리할 때 의사 도구에서 경로 불일치 및 손상된 데이터베이스 문제가 발생합니다. 의사 도구가 Yocto 프로젝트에서 파일 시스템 작업을 시뮬레이션하는 경우 파일 경로 및 권한을 처리하는 동안 문제가 발생할 수 있습니다. 이는 [Yocto 커뮤니티](https://wiki.yoctoproject.org/wiki/Pseudo_Abort) 의 알려진 문제입니다. **해결방법** 다음 명령어를 실행하세요. rm -rf /build-qcom-robotics-ros2-humble/tmp-glibc bitbake -c cleanall pseudo-native & bitbake pseudo-native ../qirp-build qcom-robotics-full-image Copy to clipboard - “pyinotify.WatchManagerError: No space left on device (ENOSPC)” 컴파일에서 이 오류가 트리거됩니다. **해결방법** 다음 명령어를 실행하세요. sudo su echo 1048576 > /proc/sys/fs/inotify/max_user_watches Copy to clipboard ## 플래시 알려진 오류가 없습니다. Last Published: Dec 23, 2025 [Previous Topic 소프트웨어 이미지 플래시](https://docs.qualcomm.com/bundle/publicresource/80-70020-254K/topics/flash_images.md) [Next Topic 방법](https://docs.qualcomm.com/bundle/publicresource/80-70020-254K/topics/how_to.md)