diff --git a/calamares.spec b/calamares.spec index 6a5139791aaa7d65cc2ad4497623c3a8186e4eee..4ae664d6cdc7d5ae9f9952e538428e197ac85f25 100644 --- a/calamares.spec +++ b/calamares.spec @@ -2,7 +2,7 @@ Name: calamares Version: 3.3.7 -Release: 14 +Release: 15 Summary: Installer from a live CD/DVD/USB to disk License: GPL-3.0-or-later @@ -358,6 +358,9 @@ cd %{_builddir} || exit 0 rm -rf %{buildroot} %changelog +* Thu May 29 2025 Liu Wang <1823363429@qq.com> - 3.3.7-15 +- Add DevStation install guide docs + * Fri Apr 18 2025 Liu Wang <1823363429@qq.com> - 3.3.7-14 - Add roo-code, uv, python3-mcp dependency for mcp server diff --git a/docs/zh/_toc.yaml b/docs/zh/_toc.yaml new file mode 100644 index 0000000000000000000000000000000000000000..cbf1fba3726014517403c9bfe440359a1f96adc2 --- /dev/null +++ b/docs/zh/_toc.yaml @@ -0,0 +1,20 @@ +label: Devstation安装指南 +isManual: true +description: calamares为DevStation客户端安装工具， 帮助用户顺利完成 openEuler DevStation 安装。 +sections: + - label: calamares简介 + href: ./index.md + - label: DevStation安装指南 + href: ./install/DevStation安装指南.md + - label: 在VirtualBox上安装 + href: ./install/在VirtualBox上安装DevStation.md + - label: 安装准备 + href: ./install/安装准备.md + - label: 安装指导 + href: ./install/安装指导.md + - label: 在个人PC上双系统安装 + href: ./install/在个人PC上双系统安装DevStation.md + - label: 安装准备-1 + href: ./install/安装准备-1.md + - label: 安装指导-1 + href: ./install/安装指导-1.md diff --git a/docs/zh/index.md b/docs/zh/index.md new file mode 100644 index 0000000000000000000000000000000000000000..6ab5aa8d5f4ab1f31630b0f7b4c031f19cf6dcbc --- /dev/null +++ b/docs/zh/index.md @@ -0,0 +1,4 @@ +# calamares安装工具简介 + +calamares为安装DevStation客户端工具, 帮助用户顺利完成 openEuler DevStation 安装。 + diff --git "a/docs/zh/install/DevStation\345\256\211\350\243\205\346\214\207\345\215\227.md" "b/docs/zh/install/DevStation\345\256\211\350\243\205\346\214\207\345\215\227.md" new file mode 100644 index 0000000000000000000000000000000000000000..c36e82ce87bcf221ef3ad178dbda4d4bde1245c6 --- /dev/null +++ "b/docs/zh/install/DevStation\345\256\211\350\243\205\346\214\207\345\215\227.md" @@ -0,0 +1,5 @@ +# 安装指南 + +本文档主要介绍 openEuler DevStation 安装方法，以指导用户顺利完成 openEuler DevStation 安装。 + +本文档适用于所有使用 openEuler DevStation 的用户，特别是初次使用或想了解 openEuler DevStation 的用户，包括社区开发者、高校师生、系统工程师、管理员及维护人员等。 diff --git a/docs/zh/install/figures/1-createvm.png b/docs/zh/install/figures/1-createvm.png new file mode 100644 index 0000000000000000000000000000000000000000..77a914f27d02915b3c738a00e4affac5983733d8 Binary files /dev/null and b/docs/zh/install/figures/1-createvm.png differ diff --git a/docs/zh/install/figures/1-welcome.png b/docs/zh/install/figures/1-welcome.png new file mode 100644 index 0000000000000000000000000000000000000000..9e334ad3e6d2ec868440ecffed7cd1bba4e1507d Binary files /dev/null and b/docs/zh/install/figures/1-welcome.png differ diff --git a/docs/zh/install/figures/10-startinstall.jpg b/docs/zh/install/figures/10-startinstall.jpg new file mode 100644 index 0000000000000000000000000000000000000000..88717541c1a34177c1d7ff6096d0438e2851cfe8 Binary files /dev/null and b/docs/zh/install/figures/10-startinstall.jpg differ diff --git a/docs/zh/install/figures/10-username.png b/docs/zh/install/figures/10-username.png new file mode 100644 index 0000000000000000000000000000000000000000..b1d54f3e1d1da1f509fd0345e4fe510e3a634918 Binary files /dev/null and b/docs/zh/install/figures/10-username.png differ diff --git a/docs/zh/install/figures/11-packages.png b/docs/zh/install/figures/11-packages.png new file mode 100644 index 0000000000000000000000000000000000000000..22bfd691206514b9f31e1d6001de4db9dcd615cb Binary files /dev/null and b/docs/zh/install/figures/11-packages.png differ diff --git a/docs/zh/install/figures/11-summary.png b/docs/zh/install/figures/11-summary.png new file mode 100644 index 0000000000000000000000000000000000000000..2c84402f4f33857ee372c7b2bb9974e899c91338 Binary files /dev/null and b/docs/zh/install/figures/11-summary.png differ diff --git a/docs/zh/install/figures/12-disk.png b/docs/zh/install/figures/12-disk.png new file mode 100644 index 0000000000000000000000000000000000000000..8cc380b4b66814bb71ee58a6881dad5158bb235c Binary files /dev/null and b/docs/zh/install/figures/12-disk.png differ diff --git a/docs/zh/install/figures/12-installing.jpg b/docs/zh/install/figures/12-installing.jpg new file mode 100644 index 0000000000000000000000000000000000000000..f0379b7a7497d7e35bc6568033bc19198f3a49d5 Binary files /dev/null and b/docs/zh/install/figures/12-installing.jpg differ diff --git a/docs/zh/install/figures/13-grub.png b/docs/zh/install/figures/13-grub.png new file mode 100644 index 0000000000000000000000000000000000000000..24acc5e44d0ac8a643c0d3cb82de81eda539ac01 Binary files /dev/null and b/docs/zh/install/figures/13-grub.png differ diff --git a/docs/zh/install/figures/13-install.png b/docs/zh/install/figures/13-install.png new file mode 100644 index 0000000000000000000000000000000000000000..830fddc6927af0f10191b297d1333fc91bdf443b Binary files /dev/null and b/docs/zh/install/figures/13-install.png differ diff --git a/docs/zh/install/figures/14-install-sure.png b/docs/zh/install/figures/14-install-sure.png new file mode 100644 index 0000000000000000000000000000000000000000..7f74989bea5817b392f364ebdd6bc1b79848e717 Binary files /dev/null and b/docs/zh/install/figures/14-install-sure.png differ diff --git a/docs/zh/install/figures/2-create_dialog_box.png b/docs/zh/install/figures/2-create_dialog_box.png new file mode 100644 index 0000000000000000000000000000000000000000..8a7a0351a354d6015dbfec14502bef027cae58cf Binary files /dev/null and b/docs/zh/install/figures/2-create_dialog_box.png differ diff --git a/docs/zh/install/figures/2-timezone.jpg b/docs/zh/install/figures/2-timezone.jpg new file mode 100644 index 0000000000000000000000000000000000000000..ad0313e5e643f5d7d69deef1476b37386ddc8693 Binary files /dev/null and b/docs/zh/install/figures/2-timezone.jpg differ diff --git a/docs/zh/install/figures/3-installation.png b/docs/zh/install/figures/3-installation.png new file mode 100644 index 0000000000000000000000000000000000000000..24acc5e44d0ac8a643c0d3cb82de81eda539ac01 Binary files /dev/null and b/docs/zh/install/figures/3-installation.png differ diff --git a/docs/zh/install/figures/3-username.jpg b/docs/zh/install/figures/3-username.jpg new file mode 100644 index 0000000000000000000000000000000000000000..13120dbbb338f7e04cb5dd452250a68ec413a8a8 Binary files /dev/null and b/docs/zh/install/figures/3-username.jpg differ diff --git a/docs/zh/install/figures/4-packages.png b/docs/zh/install/figures/4-packages.png new file mode 100644 index 0000000000000000000000000000000000000000..e0d92f0f6623f9cf2fd7a0de008e924411b4cf1b Binary files /dev/null and b/docs/zh/install/figures/4-packages.png differ diff --git a/docs/zh/install/figures/5-manifast.png b/docs/zh/install/figures/5-manifast.png new file mode 100644 index 0000000000000000000000000000000000000000..76fabe3706ffd940c57d40ccb5c6c60b6543dd40 Binary files /dev/null and b/docs/zh/install/figures/5-manifast.png differ diff --git a/docs/zh/install/figures/6-fat32.jpg b/docs/zh/install/figures/6-fat32.jpg new file mode 100644 index 0000000000000000000000000000000000000000..b27d813ba49cf0122162f07f130bf1f45d3307f3 Binary files /dev/null and b/docs/zh/install/figures/6-fat32.jpg differ diff --git a/docs/zh/install/figures/7-apps.png b/docs/zh/install/figures/7-apps.png new file mode 100644 index 0000000000000000000000000000000000000000..9cbe689b72b2159f9297c5494b538d7151c790f7 Binary files /dev/null and b/docs/zh/install/figures/7-apps.png differ diff --git a/docs/zh/install/figures/7-bootefi.png b/docs/zh/install/figures/7-bootefi.png new file mode 100644 index 0000000000000000000000000000000000000000..e0bbe0b14abb0f08372ef18cd6d9c9932061b4c7 Binary files /dev/null and b/docs/zh/install/figures/7-bootefi.png differ diff --git a/docs/zh/install/figures/8-devstation.jpg b/docs/zh/install/figures/8-devstation.jpg new file mode 100644 index 0000000000000000000000000000000000000000..36ab625e4a8de71c3f2ee86fe490cea3725c9ddb Binary files /dev/null and b/docs/zh/install/figures/8-devstation.jpg differ diff --git a/docs/zh/install/figures/8-selectlanguage.png b/docs/zh/install/figures/8-selectlanguage.png new file mode 100644 index 0000000000000000000000000000000000000000..9e334ad3e6d2ec868440ecffed7cd1bba4e1507d Binary files /dev/null and b/docs/zh/install/figures/8-selectlanguage.png differ diff --git a/docs/zh/install/figures/9-boot.png b/docs/zh/install/figures/9-boot.png new file mode 100644 index 0000000000000000000000000000000000000000..480732f3c2aaae94c69cfab22764d4361879f73e Binary files /dev/null and b/docs/zh/install/figures/9-boot.png differ diff --git a/docs/zh/install/figures/9-timezone.png b/docs/zh/install/figures/9-timezone.png new file mode 100644 index 0000000000000000000000000000000000000000..f8fd638b7a2a0aeb86dbb1bea3463eccea6d282c Binary files /dev/null and b/docs/zh/install/figures/9-timezone.png differ diff --git a/docs/zh/install/figures/compress.png b/docs/zh/install/figures/compress.png new file mode 100644 index 0000000000000000000000000000000000000000..869553e97cd8d63bba6efb3d096a91af26e97c53 Binary files /dev/null and b/docs/zh/install/figures/compress.png differ diff --git a/docs/zh/install/public_sys-resources/icon-caution.gif b/docs/zh/install/public_sys-resources/icon-caution.gif new file mode 100644 index 0000000000000000000000000000000000000000..6e90d7cfc2193e39e10bb58c38d01a23f045d571 Binary files /dev/null and b/docs/zh/install/public_sys-resources/icon-caution.gif differ diff --git a/docs/zh/install/public_sys-resources/icon-danger.gif b/docs/zh/install/public_sys-resources/icon-danger.gif new file mode 100644 index 0000000000000000000000000000000000000000..6e90d7cfc2193e39e10bb58c38d01a23f045d571 Binary files /dev/null and b/docs/zh/install/public_sys-resources/icon-danger.gif differ diff --git a/docs/zh/install/public_sys-resources/icon-note.gif b/docs/zh/install/public_sys-resources/icon-note.gif new file mode 100644 index 0000000000000000000000000000000000000000..6314297e45c1de184204098efd4814d6dc8b1cda Binary files /dev/null and b/docs/zh/install/public_sys-resources/icon-note.gif differ diff --git a/docs/zh/install/public_sys-resources/icon-notice.gif b/docs/zh/install/public_sys-resources/icon-notice.gif new file mode 100644 index 0000000000000000000000000000000000000000..86024f61b691400bea99e5b1f506d9d9aef36e27 Binary files /dev/null and b/docs/zh/install/public_sys-resources/icon-notice.gif differ diff --git a/docs/zh/install/public_sys-resources/icon-tip.gif b/docs/zh/install/public_sys-resources/icon-tip.gif new file mode 100644 index 0000000000000000000000000000000000000000..93aa72053b510e456b149f36a0972703ea9999b7 Binary files /dev/null and b/docs/zh/install/public_sys-resources/icon-tip.gif differ diff --git a/docs/zh/install/public_sys-resources/icon-warning.gif b/docs/zh/install/public_sys-resources/icon-warning.gif new file mode 100644 index 0000000000000000000000000000000000000000..6e90d7cfc2193e39e10bb58c38d01a23f045d571 Binary files /dev/null and b/docs/zh/install/public_sys-resources/icon-warning.gif differ diff --git "a/docs/zh/install/\345\234\250VirtualBox\344\270\212\345\256\211\350\243\205DevStation.md" "b/docs/zh/install/\345\234\250VirtualBox\344\270\212\345\256\211\350\243\205DevStation.md" new file mode 100644 index 0000000000000000000000000000000000000000..32652b722e49980923a2f91aa3f82e6187198865 --- /dev/null +++ "b/docs/zh/install/\345\234\250VirtualBox\344\270\212\345\256\211\350\243\205DevStation.md" @@ -0,0 +1,3 @@ +# 在 VirtualBox 上安装 DevStation + +本文是介绍在 VirtualBox 上安装 openEuler Devstation 的步骤方法。 diff --git "a/docs/zh/install/\345\234\250\344\270\252\344\272\272PC\344\270\212\345\217\214\347\263\273\347\273\237\345\256\211\350\243\205DevStation.md" "b/docs/zh/install/\345\234\250\344\270\252\344\272\272PC\344\270\212\345\217\214\347\263\273\347\273\237\345\256\211\350\243\205DevStation.md" new file mode 100644 index 0000000000000000000000000000000000000000..c0949db9a5a36d36661c8cef0c43fe37499e6096 --- /dev/null +++ "b/docs/zh/install/\345\234\250\344\270\252\344\272\272PC\344\270\212\345\217\214\347\263\273\347\273\237\345\256\211\350\243\205DevStation.md" @@ -0,0 +1,5 @@ +# 在个人PC上双系统安装 DevStation + +前提：请先安装 windows 系统，再进行 openEuler DevStation 系统安装，不要将两者顺序颠倒，否则安装完成后无法引导 openEuler DevStation 系统。 + +本文是介绍在个人PC上安装 openEuler Devstation 的步骤方法，使用本手册需要具备基本的 Linux 系统管理知识。 diff --git "a/docs/zh/install/\345\256\211\350\243\205\345\207\206\345\244\207-1.md" "b/docs/zh/install/\345\256\211\350\243\205\345\207\206\345\244\207-1.md" new file mode 100644 index 0000000000000000000000000000000000000000..4507447730bde594468aed85ef33c429a52c01c5 --- /dev/null +++ "b/docs/zh/install/\345\256\211\350\243\205\345\207\206\345\244\207-1.md" @@ -0,0 +1,156 @@ +# 安装准备 + +在安装前，需要考虑软硬件的兼容性问题，并评估相关配置和准备工作，确保安装过程顺利进行。 + +## 系统要求 + +### 1️⃣ **存储空间** + +| 项目 | 说明 | +| -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | +| **最低要求（Windows保留）** | Windows系统盘至少保留100GB可用空间（仅Windows系统+基本软件占用的空间） | +| **双系统推荐配置（DevStation）** | 需单独分出一个**空闲分区**(未使用的磁盘空间)，大小至少40GB（建议80GB），这个空间将专门用于安装openEuler DevStation系统 | + +**举个🌰**： + +如果你的硬盘是500GB，典型分区建议： + +- Windows系统盘：150GB（实际Windows 11安装需约40GB，预留常用软件空间） +- 数据盘（D盘）：300GB （存放个人文件） +- **空闲分区**：50GB（专门留给openEuler DevStation） + +> ⚠️ 注意：这里的"空闲分区"必须处于**未格式化状态**，安装系统时会自动格式化！ + +### 2️⃣ **内存** + +| 项目 | 说明 | 对双系统的影响 | +| ------------------------------- | ---------------------------------------- | ----------------------------------------------------------------------- | +| **最低要求（4GB）** | 只要满足任一系统单独运行的最基本内存需求 | 当运行Windows或DevStation时，电脑能勉强启动使用（但无法同时运行双系统） | +| **推荐配置（8GB DDR4+）** | 现代操作系统的流畅运行基础 | 可让双系统中的任一系统运行时流畅开启开发工具（如VSCode、Docker等） | + +> 🤔 **常见误区**：双系统不是同时运行的！**同一时间只能使用一个系统**，内存需求是针对每个系统独立计算的。 + +### 3️⃣ **UEFI支持** + +**什么是UEFI？**：现代电脑的**新型启动模式**（相比传统的Legacy BIOS），提供更安全的启动环境和支持大容量硬盘。 + +| 关键项 | 要求说明 | 失败案例 | +| ----------------- | -------------------------------------------------------------------------------- | ------------------------------------ | +| **必需** | 你的电脑主板需支持UEFI启动模式（2012年后生产的电脑基本都支持） | 旧电脑使用Legacy模式可能导致分区失败 | +| **开启CSM** | 针对**老旧设备**：在主板设置中开启"兼容性支持模块"（让UEFI兼容Legacy设备） | 不开启可能导致安装界面卡死 | + +**▶ 如何检查UEFI模式？** +在Windows中按 `Win+R` 输入 `msinfo32` → 查看**BIOS模式**是否为"UEFI" + +**▶ 为什么要用UEFI？** + +- 支持超过2TB的硬盘 +- 更快的启动速度 +- 双系统引导更稳定（GRUB与Windows Boot Manager兼容性好） + +### ❓ **如果不符合要求会怎样？** + +| 硬件项 | 不符合后果 | 解决方案 | +| ---------- | -------------------------------- | -------------------------------------------------------- | +| 存储不足 | 安装过程中出现"磁盘空间不足"错误 | 压缩Windows分区 | +| 内存不足 | 系统运行极度卡顿，频繁崩溃 | 关闭后台程序或添加内存条（笔记本用户需确认是否支持扩展） | +| 无UEFI支持 | 无法完成安装程序初始化 | 旧电脑需开启CSM或单独制作Legacy模式启动盘 | + +**实际场景下的建议方案**： + +如果你是学生或开发者的典型配置： + +```markdown +硬盘：512GB SSD +- Windows分配200GB（系统+基础开发环境） +- DevStation分配80GB （Linux开发环境+容器） +- 剩余232GB作为公共数据盘（NTFS格式，Windows/Linux均可读写） + +内存：16GB DDR4 → 可同时应对IDE/虚拟机等重度场景 +固件：UEFI模式+关闭Secure Boot → 确保硬件驱动兼容性 +``` + +## 获取安装源 + +在安装开始前，您需要获取 openEuler DevStation 的镜像和校验文件。 + +请按以下步骤获取 openEuler Devstation 的镜像和校验文件： + +1. 登录[openEuler DevStation 社区镜像源](https://repo.openeuler.org/)网站。 +2. 选择 openEuler-24.03-LTS-SP2 版本。 +3. 根据实际待安装环境的架构和场景选择需要下载的 openEuler DevStation 的镜像和校验文件。 + 1. 若为 aarch64 架构。 + 1. 选择 aarch64 目录。 + 2. 将镜像 “openEuler-24.03-LTS-SP2-DevStation-aarch64-dvd.iso” 下载到本地。 + 2. 若为 x86_64 架构。 + 1. 选择 x86_64 目录。 + 2. 将镜像 “openEuler-24.03-LTS-SP2-DevStation-x86_64-dvd.iso” 下载到本地。 + +> ![](./public_sys-resources/icon-note.gif) **说明：** +> +> - aarch64 架构的镜像支持 UEFI 模式，x86\_64 架构的镜像支持 UEFI 模式和 Legacy 模式。 + +## 镜像完整性校验 + +> ![](./public_sys-resources/icon-note.gif) **说明：** +> 本章节以 aarch64 架构的镜像完整性校验为例，x86\_64 架构的镜像完整性校验的操作方法相同。 + +### 简介 + +为了确认软件包在传输过程中由于网络原因或者存储设备原因是否出现下载不完整的问题，在获取到软件包后，需要对软件包的完整性进行校验，通过了校验的软件包才能部署。 + +这里通过对比校验文件中记录的校验值和手动方式计算的 iso 文件校验值，判断软件包是否完整。若两个值相同，说明iso文件完整，否则，iso 完整性被破坏，请重新获取 iso 镜像。 + +### 前提条件 + +在校验镜像完整性之前，需要准备如下文件： + +- iso 文件：openEuler-24.03-LTS-SP2-DevStation-aarch64-dvd.iso。 +- 校验文件：openEuler-24.03-LTS-SP2-DevStation-aarch64-dvd.iso.sha256sum，文件保存ISO完整性校验值信息，校验信息与ISO值一一对应。 + +### 操作指导 + +文件完整性校验操作步骤如下： + +1. 计算文件的 sha256 校验值。执行命令如下： + + ```bash + sha256sum openEuler-24.03-LTS-SP2-DevStation-aarch64-dvd.iso + ``` + + 命令执行完成后，输出校验值。 +2. 对比步骤1计算的校验值与校验文件中复制的 SHA256 值是否一致。 + + 如果校验值一致说明 iso 文件完整，如果校验值不一致则可以确认文件完整性已被破坏，需要重新获取。 + +## 制作启动盘 + +1. 下载 [Rufus](https://rufus.ie/)（或使用Etcher、Ventoy等工具） +2. 插入U盘（容量≥8GB） +3. 打开Rufus，选择下载的ISO镜像： + 1. 分区类型：MBR + 2. 目标系统类型：BIOS 或 UEFI + 3. 文件系统：FAT32 +4. 制作完成后，记录U盘卷标（例如："openEuler-24.03-LTS-SP2-DevStation-netin"） + +## Windows 磁盘空间释放 + +### 分区压缩步骤 + +1. **打开磁盘管理** + + ![Win+X → 磁盘管理](./figures/compress.png) +2. **右键目标分区→压缩卷** +3. **输入压缩量（单位MB）**： + + ```bash + 推荐公式： (总空间 - 系统已用)*0.3 # 例如100GB系统盘建议保留30GB供Windows + ``` + +### 空间验证 + +```powershell +# 以管理员身份执行： +Get-Partition | ft -AutoSize +# 确认显示"未分配"空间 +``` diff --git "a/docs/zh/install/\345\256\211\350\243\205\345\207\206\345\244\207.md" "b/docs/zh/install/\345\256\211\350\243\205\345\207\206\345\244\207.md" new file mode 100644 index 0000000000000000000000000000000000000000..deeda8b0d56e8338d682817c6dcfd705b7854a2c --- /dev/null +++ "b/docs/zh/install/\345\256\211\350\243\205\345\207\206\345\244\207.md" @@ -0,0 +1,102 @@ +# 安装准备 + +在安装前，需要考虑软硬件的兼容性问题，并评估相关配置和准备工作，确保安装过程顺利进行。 + +## 获取安装源 + +在安装开始前，您需要获取 openEuler DevStation 的镜像和校验文件。 + +请按以下步骤获取 openEuler Devstation 的镜像和校验文件： + +1. 登录[openEuler DevStation 社区镜像源](https://repo.openeuler.org/)网站。 +2. 选择 openEuler-24.03-LTS-SP2 版本。 +3. 根据实际待安装环境的架构和场景选择需要下载的 openEuler DevStation 的镜像和校验文件。 + 1. 若为 aarch64 架构。 + 1. 选择 aarch64 目录。 + 2. 将镜像 “openEuler-24.03-LTS-SP2-DevStation-aarch64-dvd.iso” 下载到本地。 + 2. 若为 x86_64 架构。 + 1. 选择 x86_64 目录。 + 2. 将镜像 “openEuler-24.03-LTS-SP2-DevStation-x86_64-dvd.iso” 下载到本地。 + +> ![](./public_sys-resources/icon-note.gif) **说明：** +> +> - aarch64 架构的镜像支持 UEFI 模式，x86\_64 架构的镜像支持 UEFI 模式和 Legacy 模式。 + +## 镜像完整性校验 + +> ![](./public_sys-resources/icon-note.gif) **说明：** +> 本章节以 aarch64 架构的镜像完整性校验为例，x86\_64 架构的镜像完整性校验的操作方法相同。 + +### 简介 + +为了确认软件包在传输过程中由于网络原因或者存储设备原因是否出现下载不完整的问题，在获取到软件包后，需要对软件包的完整性进行校验，通过了校验的软件包才能部署。 + +这里通过对比校验文件中记录的校验值和手动方式计算的 iso 文件校验值，判断软件包是否完整。若两个值相同，说明iso文件完整，否则，iso 完整性被破坏，请重新获取 iso 镜像。 + +### 前提条件 + +在校验镜像完整性之前，需要准备如下文件： + +- iso 文件：openEuler-24.03-LTS-SP2-DevStation-aarch64-dvd.iso。 +- 校验文件：openEuler-24.03-LTS-SP2-DevStation-aarch64-dvd.iso.sha256sum，文件保存ISO完整性校验值信息，校验信息与ISO值一一对应。 + +### 操作指导 + +文件完整性校验操作步骤如下： + +1. 计算文件的 sha256 校验值。执行命令如下： + + ```bash + sha256sum openEuler-24.03-LTS-SP2-DevStation-aarch64-dvd.iso + ``` + + 命令执行完成后，输出校验值。 +2. 对比步骤1计算的校验值与校验文件中复制的 SHA256 值是否一致。 + + 如果校验值一致说明 iso 文件完整，如果校验值不一致则可以确认文件完整性已被破坏，需要重新获取。 + +## 物理机的安装要求 + +若需要在物理机环境上安装 openEuler DevStation ，则物理机需要满足如下的硬件兼容性和最小硬件要求。 + +### 硬件兼容支持 - 待补充 + +openEuler DevStation 安装时，应注意硬件兼容性方面的问题，当前已支持的服务器类型请参考[兼容性列表](https://www.openeuler.org/zh/compatibility/)。 - 待补充 + +### 最小硬件要求 + +openEuler DevStation 所需的最小硬件要求如[表2](#tff48b99c9bf24b84bb602c53229e2541)所示。 + +**表 2** 最小硬件要求`` + +| 部件名称 | 最小硬件要求 | +| :------- | :------------------------------------------------------ | +| 架构 | aarch64 或 x86_64 | +| CPU | 现代1Ghz 双核处理器 | +| 内存 | 不小于 4GB（为了获得更好的应用体验，建议不小于 8GB） | +| 硬盘 | 不小于 32GB（为了获得更好的应用体验，建议不小于 120GB） | + +## 虚拟机的安装要求 + +若需要在虚拟机环境上安装 openEuler DevStation ，则虚拟机需要满足如下的虚拟化平台兼容性和最小虚拟化要求。 + +### 虚拟化平台兼容性 + +openEuler DevStation 安装时，应注意虚拟化平台兼容性的问题，当前已支持的虚拟化平台为： + +- Hyper-v +- VMware Workstation +- VM VirtualBox + +### 最小虚拟化空间要求 + +openEuler所需的最小虚拟化空间要求如[表3](#tff48b99c9bf24b84bb602c53229e2542)所示。 + +**表 3** 最小虚拟化空间要求`` + +| 部件名称 | 最小虚拟化空间要求 | +| :------- | :------------------------------------------------------ | +| 架构 | aarch64 或 x86_64 | +| CPU | 双核 CPU | +| 内存 | 不小于 4GB（为了获得更好的应用体验，建议不小于 8GB） | +| 硬盘 | 不小于 32GB（为了获得更好的应用体验，建议不小于 120GB） | diff --git "a/docs/zh/install/\345\256\211\350\243\205\346\214\207\345\257\274-1.md" "b/docs/zh/install/\345\256\211\350\243\205\346\214\207\345\257\274-1.md" new file mode 100644 index 0000000000000000000000000000000000000000..b703c7db637bbefd36ebd261b215a80e23e928cc --- /dev/null +++ "b/docs/zh/install/\345\256\211\350\243\205\346\214\207\345\257\274-1.md" @@ -0,0 +1,246 @@ +# **安装指导** + +## 1. 安装前准备 + +### 1.1 BIOS设置 + +> ![](./public_sys-resources/icon-warning.gif) **重要提示：** +> +> - 不同品牌设备进入BIOS方式不同（常见品牌：F1/F2/DEL/ESC） +> - 必须关闭"安全启动"(Secure Boot)选项 +> - 错误修改BIOS设置可能导致系统无法启动 + +1. 插入U盘启动盘 +2. 开机时立即按下设备对应的BIOS键（持续快速点击） +3. 在Security选项中禁用Secure Boot +4. 保存设置(F10)并重启 + +### 1.2 启动菜单选择 + +> ![](./public_sys-resources/icon-note.gif) **说明：** +> +> - 启动菜单键通常为F12/ESC +> - 需在BIOS POST完成后快速按下 + +1. 重启后立即按下启动菜单键 +2. 选择带有"UEFI:"前缀的U盘设备 +3. 按Enter确认启动 + +## 2. 安装引导界面 + +### 2.1 引导菜单 + +系统将显示引导菜单，默认选项为： + +- `Start openEuler-24.03-LTS-SP2-DevStation-x86_64-dvd.iso 24.03-LTS-SP2`（推荐） +- `Troubleshooting`（仅用于问题诊断） + +> ![](./public_sys-resources/icon-note.gif) **操作说明：** +> +> - 使用↑/↓方向键选择 +> - 按Enter确认选择 +> - 60秒无操作将自动进入默认选项 + +**图1** 安装引导界面 + +![引导界面](./figures/3-installation.png) + +### 2.2 高级选项 + +- 按 `e`：编辑启动参数（高级用户） +- 按 `c`：进入命令行模式（故障诊断） + +## 3. 初始设置 + +### 3.1 语言选择 + +在欢迎界面选择"简体中文"（或其他支持语言） + +> ![](./public_sys-resources/icon-warning.gif) **注意：** +> +> - 此处选择的语言将作为系统默认语言 +> - 安装完成后仍可修改 + +**图2** 语言设置界面 + +![语言设置](./figures/1-welcome.png) + +### 3.2 时区设置 + +1. 选择"亚洲/北京"时区（UTC+8） +2. 如城市未列出，选择同区域最近城市 + +**图3** 时区设置界面 + +![时区设置](./figures/2-timezone.jpg) + +## 4. 账户与安全设置 + +### 4.1 用户账户设置 + +**图4** 账户设置界面 + +![账户设置](./figures/3-username.jpg) + +1. 设置用户名（建议使用英文） +2. 设置符合复杂度要求的密码： + - 至少8位字符 + - 包含大小写字母和数字 + - 建议使用特殊符号 + +> ![](./public_sys-resources/icon-warning.gif) **安全建议：** +> +> - 避免使用简单密码如"123456" +> - 不要使用与个人信息相关的密码 +> - 定期更换密码 + +### 4.2 Root账户设置 + +- 勾选"为管理员账号使用同样的密码"可统一密码 +- 取消勾选可单独设置Root密码 + +> ![](./public_sys-resources/icon-note.gif) **最佳实践：** +> +> - 日常操作建议使用普通账户 +> - 仅在进行系统管理时使用Root账户 + +## 5. 软件包选择 + +### 5.1 基础环境选择 + +**图5** 软件包选择界面 + +![软件选择](./figures/4-packages.png) + +可选方案： + +1. **DevStation全功能环境**（推荐）： + 1. 包含开发工具链和常用应用 + 2. 适合大多数开发者 +2. **最小安装**： + 1. 仅基础系统组件 + 2. 适合自定义构建环境 + +> ![](./public_sys-resources/icon-note.gif) **扩展建议：** +> +> - 安装完成后可通过以下命令添加软件： +> ```bash +> sudo dnf install +> ``` +> - 可使用 `dnf search`命令查找可用软件包 + +## 6. 磁盘分区（关键步骤❗️❗️❗️） + +### 6.1 存储设备选择 + +> - 操作：选择"手动分区" ![](./public_sys-resources/icon-warning.gif) **重要警告：不要选择自动分区，请选择手动分区，请谨慎操作❗️❗️❗️** +> - 选择"自动分区"将会删除目前选定的存储器上所有数据，将会导致windows系统也被删除 +> - 请选择预留有空闲空间的磁盘 + +**图6** 存储设备列表 + +![存储设备](./figures/5-manifast.png) + +> ![](./public_sys-resources/icon-warning.gif) **重要警告：** +> +> - 错误的分区操作将导致数据永久丢失 +> - 建议提前备份重要数据 +> - 双系统用户请特别注意以下步骤 + +### 6.2 EFI系统分区设置 + +1. 选择现有的FAT32格式分区（通常为300-500MB） +2. 点击"编辑"按钮： + - 操作：选择"保留" ![](./public_sys-resources/icon-warning.gif) **重要警告：不保留的话，将导致windows系统永久丢失，请谨慎操作❗️❗️❗️** + - 挂载点：`/boot/efi` + +**图7** EFI分区设置 + +![EFI设置](./figures/7-bootefi.png) + +### 6.3 根分区设置 + +1. 选择安装前预留的空闲分区（如nvme0n1p7） +2. 点击"编辑"按钮： + - 文件系统：ext4 + - 挂载点：`/` + - 卷标：可自定义（如devstation） + +**图8** 根分区设置 + +![根分区](./figures/9-boot.png) + +### 6.4 分区确认 + +**图9** 分区总览 + +![分区总览](./figures/10-startinstall.jpg) + +> ![](./public_sys-resources/icon-warning.gif) **再次确认：** +> +> - 仔细检查每个分区的挂载点和大小 +> - 确认不会误操作其他系统的分区 + +## 7. 安装与初始化 + +### 7.1 安装确认 + +**图10** 安装确认界面 + +> ![](./public_sys-resources/icon-warning.gif) **最后确认：** +> +> - 再次检查所有设置，请确认分区当前和之后，是否选定**正确的空闲分区**上（如nvme0n1p7）安装 openEuler-24.03-LTS-SP2 +> - 确保电源稳定（笔记本请接通电源） + +点击"安装"开始系统部署 + +![安装确认](./figures/11-summary.png) + +### 7.2 安装进度 + +**图11** 安装过程界面 + +![安装进度](./figures/12-installing.jpg) + +预计时间：5-10分钟（取决于硬件配置） + +### 7.3 安装完成 + +1. 系统将提示安装成功 +2. 点击"重启"按钮 +3. **重要**：及时移除安装介质(U盘) + +**图12** 启动菜单 + +![启动菜单](./figures/13-grub.png) + +- 选择"openEuler"启动项 +- 首次启动可能需较长时间初始化 + +## 8. 首次启动配置 + +### 8.1 登录系统 + +- 使用安装时设置的账户登录 +- root账号可在终端中切换 + +### 8.2 网络配置 + +1. 点击系统托盘网络图标 +2. 选择Wi-Fi网络并输入密码 +3. 或有线网络将自动连接 + +### 8.3 应用管理 + +- 通过"应用中心"查找安装软件 +- 或使用终端命令： + +```bash +sudo dnf list installed +``` + +> ![](./public_sys-resources/icon-note.gif) **提示：** +> +> 遇到问题可查阅及反馈： +> +> - 社区论坛：[https://forum.openeuler.org](https://forum.openeuler.org) diff --git "a/docs/zh/install/\345\256\211\350\243\205\346\214\207\345\257\274.md" "b/docs/zh/install/\345\256\211\350\243\205\346\214\207\345\257\274.md" new file mode 100644 index 0000000000000000000000000000000000000000..37de3a126cf1c65b82c40eae4d1189bf385aff80 --- /dev/null +++ "b/docs/zh/install/\345\256\211\350\243\205\346\214\207\345\257\274.md" @@ -0,0 +1,128 @@ +# 安装指导 + +本章将以光盘安装为例，详细介绍如何安装 openEuler DevStation。对于其他安装方式，除了在启动安装时的引导方式可能有所不同外，其余的安装流程均相同，因此本章不再赘述。 + +## 启动安装 + +### 使用光盘引导安装 + +使用光盘引导安装 openEuler DevStation，具体步骤如下。 + +> ![](./public_sys-resources/icon-note.gif) **说明：** +> 在安装开始前，需要保证启动选项为光驱优先。安装步骤以 VirtualBox 挂载虚拟光驱进行光盘安装的操作举例。 + +1. 在 VM VirtualBox 工具栏中，单击新建如下图所示。 + + **图 1** 光驱图标 ``![](./figures/1-createvm.png) + + 弹出新建虚拟电脑对话框，如下图所示。 + + **图 2** 新建虚拟电脑对话框 ``![](./figures/2-create_dialog_box.png) +2. 在新建虚拟电脑对话框中，选择“虚拟光盘”， 并单击下拉框。选择 DevStation 镜像。 +3. 选择下一步，根据“安装准备”章节中所要求的硬件规格去进行配置。 + +### 安装引导界面 + +系统使用引导介质完成引导后会显示引导菜单。该引导菜单除启动安装程序外还提供一些选项。安装系统时，默认采用“Start openEuler-24.03-LTS-SP2-DevStation-x86_64-dvd.iso 24.03-LTS-SP2”方式进行安装。如果要选择默认选项之外的选项，请使用键盘中的“↑”和“↓”方向键进行选择，并在选项为高亮状态时按“Enter”。 + +> ![](./public_sys-resources/icon-note.gif) **说明：** +> +> - 如果60秒内未按任何键，系统将从默认选项“Start openEuler-24.03-LTS-SP2-DevStation-x86_64-dvd.iso 24.03-LTS-SP2”自动进入安装界面。 + +**图 3** 安装引导界面 `` + +![img](./figures/3-installation.png) + +安装引导选项说明如下： + +- Start openEuler-24.03-LTS-SP2-DevStation-x86_64-dvd.iso 24.03-LTS-SP2 —— 默认选项。 +- Troubleshooting —— 问题定位模式，系统无法正常安装时使用。-功能待完善 + +在安装引导界面，按“e”进入已选选项的参数编辑界面，按“c”进入命令行模式。 + +DevStation 正常启动之后，会以Livecd方式进入主界面，同时以devstation用户权限自动拉起系统安装服务进行落盘安装，如[图4](#zh-cn_topic_0186390097_zh-cn_topic_0122145868_fig17366454247)所示，点击图中"认证"进入安装欢迎页。 + +**图 4** 管理员权限认证 `` +![](./figures/7-apps.png) + +## 设置系统语言 + +在“欢迎”页面中选择“语言”，设置系统的语言。如[图5](#zh-cn_topic_0186390098_zh-cn_topic_0122145772_fig187301927172619)所示，用户也可根据实际情况进行调整，选择“简体中文”。 + +**图 5** 语言支持 `` +![](./figures/8-selectlanguage.png) + +## 设置时间和日期 + +在“基础设置”页面中选择“地区和区域”，设置系统的时区、日期、时间等。 + +设置时区时，用户可通过页面顶部的“地区”和“城市”下拉菜单中进行选择，如[图6](#zh-cn_topic_0186390096_zh-cn_topic_0122145900_fig1260162652312)所示。 + +如果您所在城市没有出现在下拉菜单中，请选择同一时区中离您最近的城市。 + +**图 6** 日期和时间 `` +![](./figures/9-timezone.png) + +## 设置帐户密码 + +在“用户设置”页面中设置账号密码，如[图7](#zh-cn_topic_0186390266_zh-cn_topic_0122145909_fig1323165793018)所示，根据[密码复杂度](#密码复杂度)输入密码并再次输入密码进行确认。 + +> ![](./public_sys-resources/icon-note.gif) **说明：** +> +> - root帐户是用来执行关键系统管理任务，不建议您在日常工作及系统访问时使用root帐户。 + +**图 7** root帐户 `` +![](./figures/10-username.png) + +如上图所示，界面选中“为管理员账号使用同样的密码”选项后，管理员账户(即root)的密码与界面设置的用户密码相同，该选项避免多次输入密码（习惯上人们都会趋向于不同账号设置同一个密码，方便记忆）。相反，当取消选择该选项后，在该页面可以为管理员账号及密码进行单独设置。 + +## 选择安装软件 + +在“用户设置”页面中选择“DevStation”，指定需要安装的软件包。 + +用户需要根据实际的业务需求，在左侧也可以选择一个“最小安装”，如[图8](#zh-cn_topic_0186390261_zh-cn_topic_0122145865_fig03031519101414)所示。 + +**图 8** 软件选择 ``![img](./figures/11-packages.png) + +> ![](./public_sys-resources/icon-note.gif) **说明：** +> +> - 在最小安装的环境下，并非安装源中所有的包都会安装。如果用户需要使用的包未安装，可将安装源挂载到本地制作repo源，通过DNF工具单独安装。 + +## 设置安装目的地 + +在“安装设置”页面中选择“存储器”，设置操作系统的安装磁盘及分区。 + +在[图9](#fig1195417125015)所示的页面中您可以看到计算机中的本地可用存储设备。 + +**图 9** 安装目标位置 `` +![](./figures/12-disk.png) + +### 存储配置 -待完善 + +**自动**分区 + +如果是在未使用过的存储设备中执行全新安装，或者不需要保留该存储设备中任何数据，建议选择“自动”进行自动分区。 + +**自定义**分区 -待完善 + +## 开始安装 + +在安装界面上完成所有必填选项的配置后。此时，用户可以单击“安装”进行系统安装，如[图10](#fig-install-sure)。 + +**图 10** 安装配置确认 `` +![](./figures/14-install-sure.png) + +## 安装过程 + +开始安装后会出现进度页面，显示安装进度及所选软件包写入系统的进度，如[图11](#zh-cn_topic_0186390266_zh-cn_topic_0122145909_fig1590863119306)所示。 + +> ![](./public_sys-resources/icon-note.gif) **说明：** +> +> 若系统安装过程中，单击“退出”，或复位、下电服务器，则安装过程被中断，系统将不可用，需要重新进行安装。 + +**图 11** 安装过程 `` +![](./figures/13-install.png) + +## 安装完成 + +在安装过程执行完成后，openEuler Devstation即完成了安装。请点击“重启系统”按钮，系统将会重新启动。