chore: Update doc about how to install Acosail.
|
@ -3,4 +3,38 @@
|
||||||
|
|
||||||
## 常见安装问题
|
## 常见安装问题
|
||||||
|
|
||||||
TO be add...
|
1. Q : UEFI 模式下安装成功后,重启后如图所示,无法进入系统?
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../images/acosail_install_question_01.PNG"/>
|
||||||
|
|
||||||
|
A : 这种情况是进入了 UEFI Shell,需要手动设置之后即可正常进入系统。
|
||||||
|
|
||||||
|
``` shell
|
||||||
|
Shell> FS0:
|
||||||
|
FS0:\> cd EFI\debian\
|
||||||
|
FS0:\EFI\debian\> grubx64.efi
|
||||||
|
```
|
||||||
|
|
||||||
|
> **说明**
|
||||||
|
>
|
||||||
|
> * 一般情况下是 FS0,当出现特殊情况时,需要根据提示来确认。
|
||||||
|
>
|
||||||
|
> * 不同架构下,执行的 grubXXX.efi 不一样,需要根据架构来区分。
|
||||||
|
|
||||||
|
2. Q : 如果等待时间超过1分钟也没有进入如下界面?
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../images/acosail_install_01.PNG"/>
|
||||||
|
|
||||||
|
A : 强制关机,并回到此界面,选择 **Advanced options -> Print mode**,同时拍摄视频或者保存串口信息并发送给翼辉 Acosail 团队,团队将会给出问题答复。
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../images/acosail_install_00.PNG"/>
|
||||||
|
|
||||||
|
3. Q : 配置完安装选项之后,执行 **Install**,最后并没有显示 `Install finished`?
|
||||||
|
|
||||||
|
A : 请提供如下页面的截图或者拍照给翼辉 Acosail 团队,团队将会给出问题答复。
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../images/acosail_install_09.PNG"/>
|
||||||
|
|
||||||
|
4. Q : 安装之后重启超过10分钟都没有启动成功?
|
||||||
|
|
||||||
|
A : 请提供相关的串口信息给翼辉 Acosail 团队,团队将会给出问题答复。
|
||||||
|
|
61
docs/guide/install/drive/custom-drive.md
Normal file
|
@ -0,0 +1,61 @@
|
||||||
|
# 欢迎使用 Acosail
|
||||||
|
|
||||||
|
## 自定义磁盘分区设置步骤
|
||||||
|
|
||||||
|
### 步骤 1:进入自定义磁盘分区界面
|
||||||
|
|
||||||
|
在配置磁盘分区界面选择自定义磁盘分区,然后进入如下界面。
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../../images/acosail_install_custom_drive_01.PNG"/>
|
||||||
|
|
||||||
|
> **说明**
|
||||||
|
>
|
||||||
|
> * Create a new partition : 自定义划分每个分区的大小。
|
||||||
|
>
|
||||||
|
> * Suggest partition layout : 使用建议的分区计划(128M efi 分区,512M boot 分区,剩余的都划分给 根分区 )。
|
||||||
|
>
|
||||||
|
> * Mark/Unmark full disk as lvm partition : 将全部磁盘标记/取消标记为 lvm 分区。
|
||||||
|
|
||||||
|
#### 自定义划分每个分区大小
|
||||||
|
|
||||||
|
1. 选择磁盘文件系统
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../../images/acosail_install_custom_drive_02.PNG"/>
|
||||||
|
|
||||||
|
> **说明**
|
||||||
|
>
|
||||||
|
> 建议选择 ext4 格式的文件系统
|
||||||
|
|
||||||
|
2. 设置分区的起始位置和大小。
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../../images/acosail_install_custom_drive_03.PNG"/>
|
||||||
|
|
||||||
|
> **说明**
|
||||||
|
>
|
||||||
|
> 首先添加的是 efi 分区,该分区起始位置为 **3MB**,大小为 **128MB**(如果觉得小,可以设置大一些)。
|
||||||
|
|
||||||
|
3. 设置新添加分区的挂载点。
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../../images/acosail_install_custom_drive_04.PNG"/>
|
||||||
|
|
||||||
|
选中之后,进入设置界面,在该界面中,选择刚刚新增的分区:
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../../images/acosail_install_custom_drive_05.PNG"/>
|
||||||
|
|
||||||
|
在该界面中,输入分区需要挂载的位置(此例中为 **/boot/efi**):
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../../images/acosail_install_custom_drive_06.PNG"/>
|
||||||
|
|
||||||
|
4. 继续新增分区。
|
||||||
|
|
||||||
|
> **说明**
|
||||||
|
>
|
||||||
|
> * 需要至少三个分区(efi,boot,根分区)
|
||||||
|
> * efi 分区大小一般在 500MB 左右。
|
||||||
|
> * boot 分区大小一般在 512M ~ 1GB 左右。
|
||||||
|
|
||||||
|
5. 保存并退出分区设置
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../../images/acosail_install_custom_drive_07.PNG"/>
|
||||||
|
|
||||||
|
|
25
docs/guide/install/drive/default-drive.md
Normal file
|
@ -0,0 +1,25 @@
|
||||||
|
# 欢迎使用 Acosail
|
||||||
|
|
||||||
|
## 默认磁盘分区设置步骤
|
||||||
|
|
||||||
|
### 步骤 1:进入默认磁盘分区界面
|
||||||
|
|
||||||
|
选择默认磁盘分支之后,直接进入到分区文件系统选择界面。
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../../images/acosail_install_default_drive_01.PNG"/>
|
||||||
|
|
||||||
|
> **说明**
|
||||||
|
>
|
||||||
|
> * 推荐使用 ext4 文件系统。
|
||||||
|
|
||||||
|
### 步骤 2:保存并退出磁盘分区界面
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../../images/acosail_install_default_drive_02.PNG"/>
|
||||||
|
|
||||||
|
> **说明**
|
||||||
|
>
|
||||||
|
> * 默认三个分区(efi,boot,根分区)。
|
||||||
|
> * efi 分区默认大小 128MB。
|
||||||
|
> * boot 分区默认大小 512MB。
|
||||||
|
> * 默认剩余划分给根分区。
|
||||||
|
> * 大小可以根据自己需要调整。同时也能新增分区。参照[自定义磁盘分区设置步骤](./custom-drive.md)。
|
|
@ -1,6 +1,20 @@
|
||||||
|
|
||||||
# 欢迎使用AcoSail
|
# 欢迎使用AcoSail
|
||||||
|
|
||||||
## ASInstaller
|
## 启动盘制作
|
||||||
|
|
||||||
TO be add...
|
目前仅支持 **ventory** 或者 **etcher** 制作的启动盘,暂不支持包括**软碟通**在内的其他启动盘制作方式。
|
||||||
|
|
||||||
|
## 安装说明
|
||||||
|
|
||||||
|
目前 Acosail 提供两个版本(不同版本的安装步骤请参照对应版本),分别是:
|
||||||
|
|
||||||
|
- [基础版本](./install-dev.md):基础内核的镜像版本。
|
||||||
|
|
||||||
|
- [开发版本](./install-dev.md):预装了 Vscode 等开发套件的基础版本。
|
||||||
|
|
||||||
|
> 说明
|
||||||
|
>
|
||||||
|
> 1. 不管是基础版本还是开发版本,都可以在安装的时候选装 KDE 桌面环境。
|
||||||
|
>
|
||||||
|
> 2. 基础版本和开发版本,都可以在安装之后将基础内核升级到 RT 内核。
|
||||||
|
|
|
@ -1,6 +0,0 @@
|
||||||
|
|
||||||
# 欢迎使用AcoSail
|
|
||||||
|
|
||||||
## 开发版 with KDE 安装教程
|
|
||||||
|
|
||||||
TO be add...
|
|
|
@ -1,6 +1,70 @@
|
||||||
|
|
||||||
# 欢迎使用AcoSail
|
# 欢迎使用AcoSail
|
||||||
|
|
||||||
## 开发版安装教程
|
## 安装教程
|
||||||
|
|
||||||
TO be add...
|
### 步骤 1:使用 U 盘启动进入安装引导
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../images/acosail_install_00.PNG"/>
|
||||||
|
|
||||||
|
### 步骤 2:选择 Install 选项进入安装菜单
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../images/acosail_install_01.PNG"/>
|
||||||
|
|
||||||
|
> **说明:**
|
||||||
|
>
|
||||||
|
> * Locale language、Locale encoding、Hostname、Root password、User account 这五项建议不要修改。
|
||||||
|
>
|
||||||
|
> * Drive(s) 可以设置系统的安装位置。
|
||||||
|
>
|
||||||
|
> * Base Image 可以设置系统的镜像版本。
|
||||||
|
>
|
||||||
|
> * 当最后的 Install 后面显示 config(s) missing 时,则说明有一项没有配置导致无法正常安装。
|
||||||
|
|
||||||
|
### 步骤 3:设置安装磁盘
|
||||||
|
|
||||||
|
进入 Drive(s) 菜单,选择系统安装磁盘,按 **TAB** 或**空格**选中,按**回车**保存并返回上级安装菜单。
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../images/acosail_install_02.PNG"/>
|
||||||
|
|
||||||
|
### 步骤 4:设置磁盘分区
|
||||||
|
|
||||||
|
1. 当设置完安装磁盘之后,顶级安装菜单会多出一项设置 **Disk layout**,这个设置是用来设置磁盘分区的。
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../images/acosail_install_03.PNG"/>
|
||||||
|
|
||||||
|
2. 选择 **Disk layout** 进入磁盘分区界面后,没有特殊需求,可以选择推荐的磁盘分区方案,根据引导,一键设置。有特定需求的,可以选择自定义方案。
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../images/acosail_install_04.PNG"/>
|
||||||
|
|
||||||
|
> **说明**
|
||||||
|
>
|
||||||
|
> 默认磁盘分区设置方式可参照[设置默认磁盘分区](./drive/default-drive.md),自定义磁盘分区设置方式可参照[设置自定义磁盘分区](./drive/custom-drive.md)。
|
||||||
|
|
||||||
|
3. 选择 **Base Image** 版本。
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../images/acosail_install_05.PNG"/>
|
||||||
|
|
||||||
|
> **说明**
|
||||||
|
>
|
||||||
|
> 默认是 runtime,提供两种版本: runtime 和 develop。runtime 是基础镜像,develop 则是在 runtime 的基础上增加了一些常见的开发套件。
|
||||||
|
|
||||||
|
在 ARM64 环境中,如果选择 develop 版本时,会有额外的安装包菜单,提供 KDE 桌面环境(默认采用的是 DWM 桌面)。
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../images/acosail_install_06.PNG"/>
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../images/acosail_install_07.PNG"/>
|
||||||
|
|
||||||
|
4. 选择 **Install** 进行系统安装。
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../images/acosail_install_08.PNG"/>
|
||||||
|
|
||||||
|
当终端打印如下信息的时候,说明安装成功。
|
||||||
|
|
||||||
|
<img style="display: block; border: 1px solid #eeeeee" src="../../images/acosail_install_09.PNG"/>
|
||||||
|
|
||||||
|
此时可以按 **Enter** 重启进入 Acosail 系统,需要拔掉 U 盘。
|
||||||
|
|
||||||
|
> **说明**
|
||||||
|
>
|
||||||
|
> 第一次启动会有较长时间的黑屏,此为正常现象!之后将保持正常水平(9-10s)!
|
|
@ -1,6 +0,0 @@
|
||||||
|
|
||||||
# 欢迎使用AcoSail
|
|
||||||
|
|
||||||
## runtime版安装教程
|
|
||||||
|
|
||||||
TO be add...
|
|
BIN
docs/images/acosail_install_00.PNG
Normal file
After Width: | Height: | Size: 473 KiB |
BIN
docs/images/acosail_install_01.PNG
Normal file
After Width: | Height: | Size: 48 KiB |
BIN
docs/images/acosail_install_02.PNG
Normal file
After Width: | Height: | Size: 44 KiB |
BIN
docs/images/acosail_install_03.PNG
Normal file
After Width: | Height: | Size: 52 KiB |
BIN
docs/images/acosail_install_04.PNG
Normal file
After Width: | Height: | Size: 43 KiB |
BIN
docs/images/acosail_install_05.png
Normal file
After Width: | Height: | Size: 48 KiB |
BIN
docs/images/acosail_install_06.png
Normal file
After Width: | Height: | Size: 17 KiB |
BIN
docs/images/acosail_install_07.png
Normal file
After Width: | Height: | Size: 8.0 KiB |
BIN
docs/images/acosail_install_08.png
Normal file
After Width: | Height: | Size: 51 KiB |
BIN
docs/images/acosail_install_09.png
Normal file
After Width: | Height: | Size: 135 KiB |
BIN
docs/images/acosail_install_custom_drive_01.png
Normal file
After Width: | Height: | Size: 32 KiB |
BIN
docs/images/acosail_install_custom_drive_02.png
Normal file
After Width: | Height: | Size: 26 KiB |
BIN
docs/images/acosail_install_custom_drive_03.png
Normal file
After Width: | Height: | Size: 25 KiB |
BIN
docs/images/acosail_install_custom_drive_04.png
Normal file
After Width: | Height: | Size: 38 KiB |
BIN
docs/images/acosail_install_custom_drive_05.png
Normal file
After Width: | Height: | Size: 34 KiB |
BIN
docs/images/acosail_install_custom_drive_06.png
Normal file
After Width: | Height: | Size: 28 KiB |
BIN
docs/images/acosail_install_custom_drive_07.png
Normal file
After Width: | Height: | Size: 46 KiB |
BIN
docs/images/acosail_install_default_drive_01.png
Normal file
After Width: | Height: | Size: 20 KiB |
BIN
docs/images/acosail_install_default_drive_02.png
Normal file
After Width: | Height: | Size: 52 KiB |
BIN
docs/images/acosail_install_question_01.png
Normal file
After Width: | Height: | Size: 51 KiB |