OS 관리를 위한 명령

문서 참조: 링크

노토

원본 문서: commands_for_os_management.md

참고

이 문서는 여러분의 기여(문서화, 번역, 보고, 제안, 코딩)를 기다리고 있습니다.
할 일: 이 문서는 다른 CROS 파생 문서에서도 작동하는 것 같으므로 테스트 결과를 추가해야 합니다.
이 문서는 웨인OS를 관리하고자 하는 개발자에게 도움이 되고자 합니다.

요구 사항

wayne-os-dev_ 또는 wayne-os-test 버전

로컬 셸에서

웨인OS 기기에서 셸 열기를 실행한 후 다음 단계를 시도합니다.

파워워시

$ { sudo bash -c 'echo "fast safe" > /mnt/stateful_partition/factory_install_reset' ;} && sudo reboot

또는

$ { echo "fast safe" | sudo tee -a /mnt/stateful_partition/factory_install_reset ;} && sudo reboot

작업 제어

웨인OS 및 크롬 OS 파생 프로그램은 업스타트를 사용합니다. 작업 목록을 확인하려면.

sudo initctl list

작업을 제어하려면.

sudo initctl start/stop/restart/status ${JOB}

정보, 성능 확인에 사용할 수 있는 명령어

원격에서

ssh를 통해 원격 장치에서 웨인OS 장치로 셸 명령을 보낼 수 있습니다.

ssh chronos@${IP} -t "COMMAND" # 명령에 sudo가 포함되어 있는지 pw에게 다시 묻습니다.
ssh root@${IP} "COMMAND" # 이 명령은 Wayne OS 테스트 버전에서만 사용할 수 있습니다.

예제

  • 웨인OS 장치에 강제 파워워시.
$ ssh chronos@192.168.100.200 -t "{ echo "fast safe" | sudo tee -a /mnt/stateful_partition/factory_install_reset ;} && sudo reboot"
  • 웨인OS 장치에서 UI(로그아웃 사용자 그래픽 세션)를 강제로 다시 시작합니다.
$ ssh root@192.168.100.200 "initctl restart UI"
  • 웨인OS 장치에서 프로세스 정보를 가져옵니다.
$ ssh chronos@192.168.100.200 -t "top -n 1 -b" > proc_list.txt

모드 변경

문서 참조: 링크

노트

원본 문서: mode_change.md
이 문서는 당신의 기여(문서화, 번역, 신고, 제안, 코딩)를 기대합니다.
TO-DO: 이 문서는 유용한 Chromium flags 들에 대한 컨트리뷰션을 필요로 합니다.
wayne-os-dev-4q21 이후 버전들만 이 기능을 지원합니다.

chrome_dev.conf 에 접근하기

  • 콘솔 모드에 로그인하세요.
  • /usr/sbin/mode_change-wayneos 를 입력하세요 (sudo pw 필요)
  • chrome_dev.conf 수정 후 재부팅 하세요.

flag 켜기:

  1. chrome_dev.conf 에서 flag를 선택하세요.
  2. Delete the sharp 샵 (#) which is ahead of the flag (Don't remove the sharp which is ahead of explanation).
  3. 해당 flag 앞에 있는 샵 (#) 기호를 지우세요 (설명문 앞에 있는 샵 기호는 지우지 마세요).
  4. 해당 flag가 필요로 하는 경우, argument를 추가하세요.

flag 끄기:

  1. flag 앞에 샵 (#) 기호를 써넣으세요.

유용한 flag set

키오스크

  • --kiosk: 웹 브라우저를 제외한 UI가 잠김.
  • --start-fullscreen: 웹 브라우저가 전체화면으로 실행.
  • --enable-virtual-keyboard: 터치스크린용.

공용 PC

  • --incognito: 웹브라우저가 익명 모드로 실행.

자동 로그인

문서 참조: 링크

노토

원본 문서: auto_login.md
이 문서는 당신의 기여(문서화, 번역, 신고, 제안, 코딩)를 기대합니다.
이 문서의 기능은 아직 출시되지 않았습니다. (2022-03-17)

참고

이 문서는 진행 중입니다.
이 문서는 여러분의 기여(문서 작성, 번역, 보고, 제안, 코딩)를 기다리고 있습니다.
이 문서에 포함된 기능은 아직 출시되지 않았습니다. (2022-03-17)

요구 사항

  • 서버: test_버전을 실행하는 웨인OS PC
  • 클라이언트: ssh 클라이언트 기능이 있는 PC(모든 OS가 가능하지만 이 문서에서는 Linux 셸로 설명합니다.)
  • 서버의 IP 주소를 확인하고 클라이언트에서 해당 IP에 연결할 수 있는지 확인합니다(예: ping ${SERVER_IP}).

1. 준비

SSH

설정 및 확인SSH 연결.

구글 아이디

자동 로그인 기능은 안전하지 않으므로 임시 구글 아이디를 사용하는 것을 권장하며, 구글 아이디의 2단계 인증을 해제하면 자동 로그인을 편리하게 사용할 수 있습니다.

GCP

서버

웨인 OS 테스트 버전_을 켜고 초기 설정(언어/네트워크 등)을 설정합니다.

2. 원격 로그인

클라이언트에서 서버로 ssh를 연결합니다.

sudo ssh ${SERVER_IP} "/usr/local/autotest/bin/autologin.py -u '${USER_ID}'"
비밀번호:

...

경고: 암호 입력이 에코될 수 있습니다.
비밀번호:
  • ${SERVER_IP}: Wayne OS 디바이스의 IP 주소(예: 192.168.0.100)
  • ${USER_ID}: 로그인을 위한 Google ID
  • 첫 번째 비밀번호 프롬프트: Wayne OS 테스트_ 버전의 셸 비밀번호
  • 2번째 비밀번호 프롬프트: Google ID의 비밀번호

예제 옵션

sudo ssh 192.168.0.100 "/usr/local/autotest/bin/autologin.py --help"
비밀번호

...

사용법: autologin.py [-h] [-a] [--arc_timeout ARC_TIMEOUT] [-d] [-u USERNAME]
                    [--enable_default_apps] [-p PASSWORD] [-w]
                    [--no-arc-syncs] [--toggle_ndk] [--nativebridge64]
                    [-f FEATURE] [--url URL]


Chrome이 자동으로 로그인하도록 설정합니다.

선택적 인수를 사용할 수 있습니다:
  -h, --help            이 도움말 메시지를 표시하고 종료합니다.
  -a, --arc            ARC를 활성화하고 시작될 때까지 기다립니다.
  --arc_timeout            ARC_TIMEOUT
                        ARC를 활성화하고 시작될 때까지 기다립니다.
  -d, --dont_override_profile
                        이전 세션의 파일을 유지합니다.
  -u USERNAME, --사용자 이름 사용자 이름
                        제공된 사용자 이름으로 로그인합니다.
  --enable_default_apps
                        기본 애플리케이션을 활성화합니다.
-p PASSWORD, --password PASSWORD
                        제공된 암호로 로그인합니다.
  -w, --no-startup-window
                        시작 창이 열리지 않도록 합니다(낙서 없음).
  --no-arc-syncs        ARC 동기화 동작을 최대한 방지합니다.
  --toggle_ndk        후디니에서 ndk로 변환을 토글합니다.
--naivebridge64        64비트 네이티브 브릿지에 대한 실험을 활성화합니다.
-f FEATURE, --feature FEATURE
                        지정된 크롬 기능 플래그를 활성화합니다.
  --url URL        URL로 이동합니다.

sudo ssh 192.168.140.172 "/usr/local/autotest/bin/autologin.py --url 'https://wayne-os.com' -u 'seongbin@wayne-inc.com' -p 'my_private_pw'"

참조

https://chromium.googlesource.com/chromiumos/docs/+/main/tips-and-tricks.md#how-to-enable-a-local-user-account

BI 변경

문서 참조: 링크

노트

원본 문서: bi_change.md
이 문서는 당신의 기여(문서화, 번역, 신고, 제안, 코딩)를 기대합니다.
웨인 OS 라이선스하에, 웨인OS는 유저/고객들이 BI (brand idendity: 로고, 이름)를 어떤 목적으로든 (ex: 내부사용, 배포, 판매) 변경하는 것을 허가합니다.

준비

  • chromiumos-assets 패키지를 참고하여 png 이미지 파일을 준비하세요.
  • png 파일의 픽셀 사이즈와 파일명이 참고자료와 동일한 지 확인하세요.

Putting your BI in Wayne OS

  • 콘솔 모드에 로그인하세요.
  • 다음 경로에 존재하는 파일들을 삭제하세요.
    /usr/share/chromeos-assets/images
    /usr/share/chromeos-assets/images_100_percent
    /usr/share/chromeos-assets/images_200_percent
  • Put your image files in above path (via USB flash drive or ssh)
  • 당신의 이미지 파일들을 상기 경로에 넣으세요 (USB flash drive 혹은 ssh 이용).
  • 재부팅 후 새로운 BI를 확인하세요.

원격에서 SSH 연결

문서 참조: 링크

노토

원본 문서: ssh_connection_from_remote.md

참고

이 문서는 여러분의 기여(문서 작성, 번역, 보고, 제안, 코딩)를 기다리고 있습니다.

요구 사항

  • 서버: dev 또는 test 버전을 실행하는 웨인OS PC
  • 클라이언트: ssh 클라이언트 기능이 있는 PC (모든 OS 괜찮지만, 이 문서에서는 리눅스 셸로 설명합니다.)
  • 서버의 IP 주소를 확인하고 클라이언트에서 해당 IP에 연결할 수 있는지 확인합니다(예: ping ${SERVER_IP}).

웨인OS 개발 버전

클라이언트에서 서버에 연결

ID: chronos
PW: wayne-os-dev 버전의 비밀번호

  • 예시
$ ssh chronos@192.168.140.172
Password:

비밀번호 생략

TODO: write

웨인OS 테스트 버전

1. 클라이언트에서 설정

먼저, 테스트 RSA 키와 구성 파일을 ~/.ssh/에 다운로드합니다.

$ cd ~/.ssh && wget \
https://gitlab.com/wayne-inc/wayne_os/-/raw/master/cros-src/cros_sdk/src/scripts/mod_for_test_scripts/ssh_keys/testing_rsa \
https://gitlab.com/wayne-inc/wayne_os/-/raw/master/cros-src/cros_sdk/src/scripts/mod_for_test_scripts/ssh_keys/testing_rsa.pub \
https://gitlab.com/wayne-inc/wayne_os/-/raw/master/cros-src/cros_sdk/src/scripts/mod_for_test_scripts/ssh_keys/config

그런 다음 ~/.ssh/testing_rsa에 대한 권한을 제한합니다.

chmod 0600 ~/.ssh/testing_rsa

그리고 _000.000.000.000_을 편집기로 config 파일에서 클라이언트의 IP 주소로 바꿉니다.

$ vim ~/.ssh/config

예제

호스트 wayne-os CheckHostIP no StrictHostKeyChecking 아니요 IdentityFile %d/.ssh/testing_rsa 프로토콜 2 사용자 루트 호스트 이름 000.000.000.000 # 여기서 서버 IP로 바꾸기


#### 2. 클라이언트에서 서버에 연결

$ ssh wayne-os

그러면 비밀번호가 없는 루트 셸이 나타납니다.
<br>여러 서버에 연결할 경우 ~/.ssh/config에서 공통 구성 옵션을 공유할 수 있습니다.

예시

Host 172.22.168.* # 서버가 포함된 서브넷 CheckHostIP 없음 StrictHostKeyChecking 없음 IdentityFile %d/.ssh/testing_rsa Protocol 2 User root

Host wayne-os1 호스트 이름 172.22.168.233 #여기에 서버 IP 쓰기

Host wayne-os2 호스트 이름 172.22.168.234 #여기에 서버 IP 쓰기


## 참조
https://www.chromium.org/chromium-os/testing/autotest-developer-faq/ssh-test-keys-setup

PC에 웨인OS 설치하기

문서 참조: 링크

노트

원본 문서: installing_wayne_os_on_a_pc.md
이 문서는 당신의 기여(문서화, 번역, 신고, 제안, 코딩)를 기대합니다.
wayne-os-devwayne-os-test 버전만 PC설치를 지원하며, wayne-os-base 버전은 PC 설치를 지원하지 않습니다.

1. 준비

  • wayne-os-dev 혹은 wayne-os-test 버전을 USB flash drive에 설치하세요.
  • 설치할 PC에서 USB flash drive를 통해 웨인 OS를 부팅하신 후, 올바른 작동 여부를 확인하세요 (HW 호환성, 기능, 알려진 문제점).

이 때 에러가 발생하면, PC에 설치 후에도 같은 에러가 발생합니다. 이 경우 PC 설치를 재고 하시는 것이 좋습니다.
참고로 PC설치 후, 웨인OS의 STATE 파티션 용량은 로컬 디스크 용량만큼 늘어납니다.

2. 설치

  • 콘솔 모드에 로그인하세요.
  • lsblk를 통해 디스크 이름 확인을 하세요.
    lsblk화면에서 SIZETYPE 열을 확인 후 신중히 디스크를 선택하세요
    파티션 이름 (ex: sda1 8:1 0 55.3G 0 part) 이 아닌, 정확한 디스크명 (ex: sda 8:0 0 59.6G 0 disk) 을 선택하세요.
    웨인OS를 설치할 디스크와 다른 로컬/이동식 디스크를 혼동하지 마세요. 웨인OS 설치 후 해당 디스크의 모든 데이터는 사라집니다.
  • sudo /usr/sbin/chromeos-install --dst /dev/${TARGET_DISK} 를 입력하세요.
    (ex: sudo /usr/sbin/chromeos-install --dst /dev/sda)
  • 콘솔이 비밀번호를 물어보면 입력하세요.
  • 십여분 후 설치가 성공하면 Installation to /dev/${TARGET_DISK} complete. Please shutdown, remove the USB device, cross your fingers, and reboot. 메시지를 볼 수 있습니다.
  • sudo poweroff 를 통해 PC 전원을 끄고, USB flash drive를 제거하세요, 그리고 설치된 디스크로 웨인OS를 부팅하세요.

3. 문제 해결

  • 이동식 디스크에 웨인 OS를 설치하려면, --skip_dst_removable 를 추가하세요.
    (ex: sudo /usr/sbin/chromeos-install --skip_dst_removable --dst /dev/sda)
  • sudo /usr/sbin/chromeos-install --help 는 더 많은 옵션들을 보여줍니다.
  • sudo dd if=/dev/zero bs=512 count=4096 of=/dev/${TARGET_DISK} 는 파티션 구조를 삭제하고 타깃 디스크를 초기화합니다.

웨인OS에서 Google 계정 로그인

문서 참조: 링크

노토

원본 문서: signing_in_google_account_in_wayne_os.md

참고

이 문서는 여러분의 기여(문서 작성, 번역, 보고, 제안, 코딩)를 기다리고 있습니다.

구글 그룹 가입하기

구글 계정으로 웨인OS에 로그인하려면 해당 계정을 구글의 화이트리스트에 추가해야 합니다.

  1. 구글 계정에 로그인합니다.
  2. 방문 https://groups.google.com/u/0/a/chromium.org/g/google-browser-signin-testaccounts
  3. 그룹 가입_ 버튼을 누릅니다.
  4. 웨인OS에서 구글 계정으로 로그인합니다.

참고

위 방법은 테스트용이며 구글에서 공식적으로 관리하는 방법입니다.
단, 구글이 서드파티의 오픈소스를 제한/통제하고 있기 때문에 모든 구글 서비스를 이용할 수 있는 것은 아닙니다.

참조

https://wayne-os.com/googles-restriction-for-chromium-chromium-os
https://www.chromium.org/developers/how-tos/api-keys

셸 사용하기

문서 참조: 링크

노토

원본 문서: using_shell.md

참고

이 문서는 여러분의 기여(문서 작성, 번역, 보고, 제안, 코딩)를 기다리고 있습니다.

요구사항

셸은 wayne-os-devwayne-os-test 버전에서만 사용할 수 있으며 wayne-os-base 버전은 지원하지 않습니다.

콘솔

콘솔 모드로 전환합니다: ctrl+alt+f2
GUI 모드로 전환합니다: ctrl+alt+f1

터미널

먼저 GUI로 로그인하거나 게스트 모드로 전환해야 합니다.
터미널 열기: ctrl+alt+t
여는 셸: crosh> shell

ID & PW

  • 개발 버전
    • ID: chronos
    • 크로노스/수도의 PW: 호스트 이름과 동일 (예: wayne-os-1q21)
  • 테스트 버전
    • ID: chronos
    • 크로노스/sudo의 PW: test0000

PW 변경하기

TODO: 쓰기

웨인OS 부팅

문서 참조: 링크

노토

원본 문서: booting_wayne_os.md

참고

이 문서는 여러분의 기여(문서 작성, 번역, 보고, 제안, 코딩)를 기다리고 있습니다.

1. BIOS/UEFI로 들어가려면

  • PC가 꺼져 있을 때 웨인OS가 설치된 로컬 디스크 또는 USB 플래시 드라이브의 연결을 확인합니다.
  • PC가 켜지면 아래 예시와 같이 PC 모델 및 제조업체에 따라 다른 BIOS/UEFI 진입 키를 반복해서 누릅니다.
제조업체
HP F1 / F2 / F6 / F10 / F11 / F12 / ESC
Dell F1 / F2 / F3 / F12 / DEL / CTRL+ALT+ENTER / DEL+ESC / Fn+ESC / Fn+F1
Lenovo F1 / F2 / F12 / Fn+F2 / Enter-F1 / CTRL+ALT+F3 / CTRL+ALT+INC / Fn+F1
Acer F1 / F2 / F10 / DEL / CTRL+ALT+ESC
Asus F2 / F10 / DEL / INSERT
Toshiba F1 / F2 / F12 / ESC
Samsung F2
Sony F1 / F2 / F3 / ASSIST
MSI F2 / DEL
ASRock F2 / DEL
ECS DEL
Gigatbyte/Aorus F2 / DEL
MS Surface Tablets 볼륨 높이기 버튼을 길게 누릅니다.
Origin F2
Zorac DEL

Windows10에서 BIOS/UEFI로 들어가는 다른 방법

  • Windows 10 시작 메뉴에서 설정으로 이동합니다.

  • Windows 설정에서 업데이트 및 보안을 클릭합니다.

  • 왼쪽 창에서 복구를 선택합니다.

  • 고급 시작 헤더 아래의 지금 다시 시작을 클릭합니다(컴퓨터가 재부팅됩니다).

  • 블루 스크린이 있는 옵션 선택에서 문제 해결을 클릭합니다.

  • 고급 옵션 클릭

  • UEFI 펌웨어 설정을 클릭합니다.

  • 재시작을 클릭하여 확인

2. BIOS/UEFI 설정

  • BIOS/UEFI 메뉴에 들어가면 USB 플래시 드라이브를 부팅 순서 1번으로 설정합니다.

  • 보안 부팅 및 빠른 부팅 끄기
  • 설정을 저장하고 재부팅

3. OS 시작

  • 웨인OS 스플래시 화면이 표시됩니다.
  • 부팅 후 언어, 접근성, 네트워크를 구성합니다.
  • 구글 계정 또는 게스트 모드로 로그인

4. 문제 해결

  • BIOS/UEFI를 업데이트합니다.
  • 그래도 OS를 부팅할 수 없는 경우 알려진_문제.md에 신고하세요.

USB 플래시 드라이브에 웨인OS 설치하기

문서 참조: 링크

노토

원본 문서: installing_wayne_os_on_a_usb_flash_drive.md

참고

이 문서는 여러분의 기여(문서 작성, 번역, 보고, 제안, 코딩)를 기다리고 있습니다.

1. 준비 사항

  • OS 이미지 파일과 동일한 디스크 여유 공간이 있는 Windows/Linux/Chromebook PC
  • USB 플래시 드라이브

2. 웨인OS 바이너리 다운로드

3. USB 플래시 드라이브 초기화 (선택 사항)

  • USB 플래시 드라이브에 오류/손상이 있는 경우 설치 프로세스가 실패할 수 있습니다.
  • USB 초기화

4. 이미지 라이터 도구로 USB 플래시 드라이브에 .bin 파일 쓰기 ### Windows 사용자

  • USBWriter-1.3: download
  • win32diskimager-binary: download
  • Chromebook recovery utility: download
    우측 상단의 톱니바퀴 아이콘/설정 > 로컬 이미지 사용을 클릭합니다.
  • balenaEtcher-Portable-1.5.109: 웨인OS 설치에서 완벽하게 작동하지 않는 것 같습니다.
  • rufus-3.11: 웨인OS를 정확히 설치할 수 없음

크롬북사용자

리눅스 사용자

$ sudo dd if=${BIN_FILE} of=/dev/${USB_FLASH_DRIVE}
${BIN_FILE} 은 wayne-os-usb16g-1q21.bin과 같은 .bin 파일 이름이어야 합니다.
${USB_FLASH_DRIVE} 는 sdx1과 같은 파티션 이름이 아니라 sdx와 같은 장치 이름이어야 합니다.
경고: 로컬 저장소(예: HDD/SSD) 이름을 실수로 쓰면 로컬 저장소의 데이터가 손실되므로 lsblk로 장치 이름을 주의 깊게 확인하시기 바랍니다.

5. 확인

-wayne-os-portable_ 버전을 설치한 경우, 설치에 성공하면 Windows/macOS에서 STORAGE 파티션만 확인할 수 있습니다.

  • Try to boot the USB flash drive on your computer via USB booting from BIOS/UEFI setting