diff --git a/.This project migrated to AtomGit/README.md b/.This project migrated to AtomGit/README.md new file mode 100644 index 0000000000000000000000000000000000000000..44314c176ea88bf3f7990d5aa001478e7234e95b --- /dev/null +++ b/.This project migrated to AtomGit/README.md @@ -0,0 +1 @@ +# Notice: This project has been migrated to [AtomGit](https://atomgit.com/src-openeuler/calamares) diff --git "a/.\346\234\254\351\241\271\347\233\256\345\267\262\347\273\217\346\255\243\345\274\217\350\277\201\347\247\273\350\207\263 AtomGit \345\271\263\345\217\260/README.md" "b/.\346\234\254\351\241\271\347\233\256\345\267\262\347\273\217\346\255\243\345\274\217\350\277\201\347\247\273\350\207\263 AtomGit \345\271\263\345\217\260/README.md" new file mode 100644 index 0000000000000000000000000000000000000000..da8214057b1012b4535d3c1f30c3690f962d9e1d --- /dev/null +++ "b/.\346\234\254\351\241\271\347\233\256\345\267\262\347\273\217\346\255\243\345\274\217\350\277\201\347\247\273\350\207\263 AtomGit \345\271\263\345\217\260/README.md" @@ -0,0 +1 @@ +# 通知: 本项目已经正式迁移至 [AtomGit](https://atomgit.com/src-openeuler/calamares) 平台 diff --git a/0024-add-mcp-server-dependency.patch b/0024-add-mcp-server-dependency.patch index d3dd6d7ae82030dd7174d981fdcf0f1e69737b08..75d3d05d01b6ee0dda5e8171034905c013da52c6 100644 --- a/0024-add-mcp-server-dependency.patch +++ b/0024-add-mcp-server-dependency.patch @@ -20,7 +20,7 @@ index 40b1ac6d7..52a96336a 100644 # screenshot: ":/images/Plasma.png" - id: gnome - packages: [ checkpolicy, dejavu-fonts, liberation-fonts, gnome-shell, gnome-session, gnome-terminal, gnome-software, gnome-menus, nautilus, xdg-utils, google-droid-sans-fonts, google-noto-fonts-common, google-noto-sans-arabic-vf-fonts, google-noto-sans-armenian-vf-fonts, google-noto-sans-bengali-vf-fonts, google-noto-sans-canadian-aboriginal-vf-fonts, google-noto-sans-cherokee-vf-fonts, google-noto-sans-devanagari-vf-fonts, google-noto-sans-ethiopic-vf-fonts, google-noto-sans-georgian-vf-fonts, google-noto-sans-hebrew-vf-fonts, google-noto-sans-kannada-vf-fonts, google-noto-sans-khmer-vf-fonts, google-noto-sans-lao-vf-fonts, google-noto-sans-math-fonts, google-noto-sans-mono-vf-fonts, google-noto-sans-sinhala-vf-fonts, google-noto-sans-symbols2-fonts, google-noto-sans-symbols-vf-fonts, google-noto-sans-tamil-vf-fonts, google-noto-sans-thaana-vf-fonts, google-noto-sans-thai-vf-fonts, google-noto-sans-vf-fonts, google-noto-serif-armenian-vf-fonts, google-noto-serif-ethiopic-vf-fonts, google-noto-serif-georgian-vf-fonts, google-noto-serif-gujarati-vf-fonts, google-noto-serif-gurmukhi-vf-fonts, google-noto-serif-hebrew-vf-fonts, google-noto-serif-kannada-vf-fonts, google-noto-serif-khmer-vf-fonts, google-noto-serif-lao-vf-fonts, google-noto-serif-sinhala-vf-fonts, google-noto-serif-tamil-vf-fonts, google-noto-serif-thai-vf-fonts, google-noto-serif-vf-fonts, gdm, ibus-libpinyin, webp-pixbuf-loader, firefox, devstation-config, wqy-zenhei-fonts, oeDevPlugin, rust-cbindgen, polkit-qt5-1, polkit-qt5-1-devel, oedp, kernel-extra-modules, epkg, euler-copilot-shell, vscodium, oegitext, kf5-kcalendarcore-devel, kf5-kcalendarcore, rust-ripgrep, xorg-x11-drv-*, linux-firmware-iwlwifi, linux-firmware-mediatek, gnome-keyring, gnome-keyring-pam, linux-firmware-ath, linux-firmware-cypress, linux-firmware-libertas, linux-firmware-mrvl, linux-firmware-netronome, linux-firmware-ti-connectivity, gnome-shell-extension-dash-to-dock, git, thunderbird, autogen, ntp, timedatex, chrony, gnome-user-docs, gnome-doc-utils, yelp-tools] -+ packages: [ checkpolicy, dejavu-fonts, liberation-fonts, gnome-shell, gnome-session, gnome-terminal, gnome-software, gnome-menus, nautilus, xdg-utils, google-droid-sans-fonts, google-noto-fonts-common, google-noto-sans-arabic-vf-fonts, google-noto-sans-armenian-vf-fonts, google-noto-sans-bengali-vf-fonts, google-noto-sans-canadian-aboriginal-vf-fonts, google-noto-sans-cherokee-vf-fonts, google-noto-sans-devanagari-vf-fonts, google-noto-sans-ethiopic-vf-fonts, google-noto-sans-georgian-vf-fonts, google-noto-sans-hebrew-vf-fonts, google-noto-sans-kannada-vf-fonts, google-noto-sans-khmer-vf-fonts, google-noto-sans-lao-vf-fonts, google-noto-sans-math-fonts, google-noto-sans-mono-vf-fonts, google-noto-sans-sinhala-vf-fonts, google-noto-sans-symbols2-fonts, google-noto-sans-symbols-vf-fonts, google-noto-sans-tamil-vf-fonts, google-noto-sans-thaana-vf-fonts, google-noto-sans-thai-vf-fonts, google-noto-sans-vf-fonts, google-noto-serif-armenian-vf-fonts, google-noto-serif-ethiopic-vf-fonts, google-noto-serif-georgian-vf-fonts, google-noto-serif-gujarati-vf-fonts, google-noto-serif-gurmukhi-vf-fonts, google-noto-serif-hebrew-vf-fonts, google-noto-serif-kannada-vf-fonts, google-noto-serif-khmer-vf-fonts, google-noto-serif-lao-vf-fonts, google-noto-serif-sinhala-vf-fonts, google-noto-serif-tamil-vf-fonts, google-noto-serif-thai-vf-fonts, google-noto-serif-vf-fonts, gdm, ibus-libpinyin, webp-pixbuf-loader, firefox, devstation-config, wqy-zenhei-fonts, oeDevPlugin, rust-cbindgen, polkit-qt5-1, polkit-qt5-1-devel, oedp, kernel-extra-modules, epkg, euler-copilot-shell, vscodium, oegitext, kf5-kcalendarcore-devel, kf5-kcalendarcore, rust-ripgrep, xorg-x11-drv-*, linux-firmware-iwlwifi, linux-firmware-mediatek, gnome-keyring, gnome-keyring-pam, linux-firmware-ath, linux-firmware-cypress, linux-firmware-libertas, linux-firmware-mrvl, linux-firmware-netronome, linux-firmware-ti-connectivity, gnome-shell-extension-dash-to-dock, git, thunderbird, autogen, ntp, timedatex, chrony, gnome-user-docs, gnome-doc-utils, yelp-tools, roo-code, uv, python3-mcp] ++ packages: [ checkpolicy, dejavu-fonts, liberation-fonts, gnome-shell, gnome-session, gnome-terminal, gnome-software, gnome-menus, nautilus, xdg-utils, google-droid-sans-fonts, google-noto-fonts-common, google-noto-sans-arabic-vf-fonts, google-noto-sans-armenian-vf-fonts, google-noto-sans-bengali-vf-fonts, google-noto-sans-canadian-aboriginal-vf-fonts, google-noto-sans-cherokee-vf-fonts, google-noto-sans-devanagari-vf-fonts, google-noto-sans-ethiopic-vf-fonts, google-noto-sans-georgian-vf-fonts, google-noto-sans-hebrew-vf-fonts, google-noto-sans-kannada-vf-fonts, google-noto-sans-khmer-vf-fonts, google-noto-sans-lao-vf-fonts, google-noto-sans-math-fonts, google-noto-sans-mono-vf-fonts, google-noto-sans-sinhala-vf-fonts, google-noto-sans-symbols2-fonts, google-noto-sans-symbols-vf-fonts, google-noto-sans-tamil-vf-fonts, google-noto-sans-thaana-vf-fonts, google-noto-sans-thai-vf-fonts, google-noto-sans-vf-fonts, google-noto-serif-armenian-vf-fonts, google-noto-serif-ethiopic-vf-fonts, google-noto-serif-georgian-vf-fonts, google-noto-serif-gujarati-vf-fonts, google-noto-serif-gurmukhi-vf-fonts, google-noto-serif-hebrew-vf-fonts, google-noto-serif-kannada-vf-fonts, google-noto-serif-khmer-vf-fonts, google-noto-serif-lao-vf-fonts, google-noto-serif-sinhala-vf-fonts, google-noto-serif-tamil-vf-fonts, google-noto-serif-thai-vf-fonts, google-noto-serif-vf-fonts, gdm, ibus-libpinyin, webp-pixbuf-loader, firefox, devstation-config, wqy-zenhei-fonts, oeDevPlugin, rust-cbindgen, polkit-qt5-1, polkit-qt5-1-devel, oedp, kernel-extra-modules, epkg, euler-copilot-shell, vscodium, oegitext, kf5-kcalendarcore-devel, kf5-kcalendarcore, rust-ripgrep, xorg-x11-drv-*, linux-firmware-iwlwifi, linux-firmware-mediatek, gnome-keyring, gnome-keyring-pam, linux-firmware-ath, linux-firmware-cypress, linux-firmware-libertas, linux-firmware-mrvl, linux-firmware-netronome, linux-firmware-ti-connectivity, gnome-shell-extension-dash-to-dock, git, thunderbird, autogen, ntp, timedatex, chrony, gnome-user-docs, gnome-doc-utils, yelp-tools, roo-code, uv, python3-mcp, euler-copilot-desktop, dev-store, python3-django-rest-framework, tigervnc-server] name: DevStation name[zh]: DevStation description: GNU Networked Object Modeling Environment Desktop diff --git a/0025-get-os-release-version.patch b/0025-get-os-release-version.patch new file mode 100644 index 0000000000000000000000000000000000000000..5cc3dafbb3e8441d542429f036ae5fb1b05c2bc1 --- /dev/null +++ b/0025-get-os-release-version.patch @@ -0,0 +1,72 @@ +From f69963d210e516b707a8974a4d628147787926b9 Mon Sep 17 00:00:00 2001 +From: lw520203 <1823363429@qq.com> +Date: Fri, 2 May 2025 16:46:56 +0800 +Subject: [PATCH] get os release version + +--- + src/branding/default/branding.desc | 2 +- + src/calamares/CalamaresApplication.cpp | 28 ++++++++++++++++++++++++++ + 2 files changed, 29 insertions(+), 1 deletion(-) + +diff --git a/src/branding/default/branding.desc b/src/branding/default/branding.desc +index 9f0843385..f4e6e2a7c 100644 +--- a/src/branding/default/branding.desc ++++ b/src/branding/default/branding.desc +@@ -121,7 +121,7 @@ navigation: widget + # are visible as buttons there if the corresponding *show* keys + # are set to "true" (they can also be overridden). + strings: +- productName: "${NAME}" ++ productName: @OS_VERSION@ + shortProductName: Generic + version: 24.09 + shortVersion: 24.09 +diff --git a/src/calamares/CalamaresApplication.cpp b/src/calamares/CalamaresApplication.cpp +index 6b62fd67d..60cc815fc 100644 +--- a/src/calamares/CalamaresApplication.cpp ++++ b/src/calamares/CalamaresApplication.cpp +@@ -34,6 +34,8 @@ + #include + #include + #include ++#include ++#include + + /// @brief Convenience for "are the settings in debug mode" + static bool +@@ -158,6 +160,32 @@ CalamaresApplication::initQmlPath() + void + CalamaresApplication::initBranding() + { ++ ++ auto rse = Calamares::System::runCommand({"cat", "/etc/os-release"}, std::chrono::seconds(30)); ++ QString osVersion = rse.getOutput().split("PRETTY_NAME=\"")[1].split("\"\n")[0].replace(" ", "-"); ++ cDebug() << "osVersion is " << osVersion; ++ QFile descFile("/usr/share/calamares/branding/default/branding.desc"); ++ if (descFile.open(QIODevice::ReadOnly | QIODevice::Text)) { // 改为只读模式 ++ // 读取内容 ++ QTextStream inStream(&descFile); ++ QString content = inStream.readAll(); ++ descFile.close(); // 关闭文件 ++ ++ // 执行替换 ++ content.replace("@OS_VERSION@", osVersion); ++ ++ // 重新打开文件写入 ++ if (descFile.open(QIODevice::WriteOnly | QIODevice::Text | QIODevice::Truncate)) { ++ QTextStream outStream(&descFile); ++ outStream << content; ++ descFile.close(); ++ } else { ++ qDebug() << "写入失败:" << descFile.errorString(); ++ } ++ } else { ++ qDebug() << "打开失败:" << descFile.errorString(); ++ } ++ + QString brandingComponentName = Calamares::Settings::instance()->brandingComponentName(); + if ( brandingComponentName.simplified().isEmpty() ) + { +-- +2.46.0 + diff --git a/0026-fix-ppt-picture-show-issue-and-set-release-version.patch b/0026-fix-ppt-picture-show-issue-and-set-release-version.patch new file mode 100644 index 0000000000000000000000000000000000000000..9b3e807e1d67fd9fe7bacfb983d7a036248463e8 --- /dev/null +++ b/0026-fix-ppt-picture-show-issue-and-set-release-version.patch @@ -0,0 +1,91 @@ +From bc26e3276a6e82b6e523d1af5837cb725dfba2c3 Mon Sep 17 00:00:00 2001 +From: lw520203 <1823363429@qq.com> +Date: Sat, 3 May 2025 10:02:09 +0800 +Subject: [PATCH] resolve PPT pictures show issue + +--- + src/branding/default/branding.desc | 8 ++++---- + src/branding/default/show.qml | 24 +++++++++++------------- + 2 files changed, 15 insertions(+), 17 deletions(-) + +diff --git a/src/branding/default/branding.desc b/src/branding/default/branding.desc +index 2a9f640dd..91542662f 100644 +--- a/src/branding/default/branding.desc ++++ b/src/branding/default/branding.desc +@@ -123,10 +123,10 @@ navigation: widget + strings: + productName: @OS_VERSION@ + shortProductName: Generic +- version: 24.09 +- shortVersion: 24.09 +- versionedName: openEuler-25.03 +- shortVersionedName: openEuler 25.03 ++ version: @OS_VERSION@ ++ shortVersion: @OS_VERSION@ ++ versionedName: @OS_VERSION@ ++ shortVersionedName: @OS_VERSION@ + bootloaderEntryName: openEuler + productUrl: https://openeuler.org/ + supportUrl: null +diff --git a/src/branding/default/show.qml b/src/branding/default/show.qml +index f91d520cd..4551a8838 100644 +--- a/src/branding/default/show.qml ++++ b/src/branding/default/show.qml +@@ -14,6 +14,7 @@ import calamares.slideshow 1.0; + Presentation + { + id: presentation ++ anchors.fill: parent + + function nextSlide() { + console.log("QML Component (default slideshow) Next slide"); +@@ -29,36 +30,33 @@ Presentation + } + + Slide { +- id: slide1 ++ id: slide1 ++ anchors.fill: parent + Image { + id: background1 + source: "Slide1.png" +- width: 980; height: 980 +- fillMode: Image.PreserveAspectFit +- anchors.horizontalCenter:parent.horizontalCenter +- y:parent.height / 2 - height / 2 -25 ++ fillMode: Image.Stretch ++ anchors.fill: parent + } + } + Slide { + id: slide2 ++ anchors.fill: parent + Image { + id: background2 + source: "Slide2.png" +- width: 980; height: 980 +- fillMode: Image.PreserveAspectFit +- anchors.horizontalCenter:parent.horizontalCenter +- y:parent.height / 2 - height / 2 -25 ++ fillMode: Image.Stretch ++ anchors.fill: parent + } + } + Slide { + id: slide3 ++ anchors.fill: parent + Image { + id: background3 + source: "Slide3.png" +- width: 980; height: 980 +- fillMode: Image.PreserveAspectFit +- anchors.horizontalCenter:parent.horizontalCenter +- y:parent.height / 2 - height / 2 -25 ++ fillMode: Image.Stretch ++ anchors.fill: parent + } + } + // When this slideshow is loaded as a V1 slideshow, only +-- +2.46.0 + diff --git a/README.md b/README.md index 707e8ea4fd336eb26136a1ccbe9bbc515ca723ab..e1e9a3a456c8a5ff62e4caa5a469c0ee6d776d57 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,5 @@ +# Notice: This project has been migrated to [AtomGit](https://atomgit.com/src-openeuler/calamares) +# 通知: 本项目已经正式迁移至 [AtomGit](https://atomgit.com/src-openeuler/calamares) 平台 # calamares #### 介绍 diff --git a/calamares.spec b/calamares.spec index 6a5139791aaa7d65cc2ad4497623c3a8186e4eee..22b1705c946aef6d0a649cbe0acb5e1ccdadf4c5 100644 --- a/calamares.spec +++ b/calamares.spec @@ -2,7 +2,7 @@ Name: calamares Version: 3.3.7 -Release: 14 +Release: 23 Summary: Installer from a live CD/DVD/USB to disk License: GPL-3.0-or-later @@ -66,10 +66,12 @@ Patch20: 0021-aarch64-start-desktop-failed.patch Patch21: 0022-add-gnome-user-docs-dependency.patch Patch22: 0023-add-module-dependency.patch Patch23: 0024-add-mcp-server-dependency.patch +Patch24: 0025-get-os-release-version.patch +Patch25: 0026-fix-ppt-picture-show-issue-and-set-release-version.patch # Calamares is only supported where live images (and GRUB) are. (#1171380) # This list matches the arches where grub2-efi is used to boot the system -ExclusiveArch: %{ix86} x86_64 aarch64 riscv64 +ExclusiveArch: %{ix86} x86_64 aarch64 riscv64 loongarch64 # Macros BuildRequires: git-core @@ -358,6 +360,35 @@ cd %{_builddir} || exit 0 rm -rf %{buildroot} %changelog +* Mon Nov 10 2025 Wenlong Zhang - 3.3.7-23 +- enable loongarch64 for calamares + +* Wed Sep 17 2025 Liu Wang <1823363429@qq.com> - 3.3.7-22 +- ID:NA +- SUG:NA +- DESC: add tigervnc-server + +* Mon Sep 01 2025 Liu Wang <1823363429@qq.com> - 3.3.7-21 +- add 25.09 docs + +* Tue Jun 17 2025 wu-donger - 3.3.7-20 +- Revise docs formatting guidelines + +* Tue Jun 10 2025 Liu Wang <1823363429@qq.com> - 3.3.7-19 +- Add euler-copilot-desktop server + +* Thu Jun 05 2025 Liu Wang <1823363429@qq.com> - 3.3.7-18 +- Delete euler-copilot server and get all release version + +* Wed Jun 04 2025 Liu Wang <1823363429@qq.com> - 3.3.7-17 +- Get os release version + +* Tue Jun 03 2025 Liu Wang <1823363429@qq.com> - 3.3.7-16 +- Add euler-copilot-web server + +* 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..0f18a075c834f0f36efd9e2147cdc8948481217c --- /dev/null +++ b/docs/zh/_toc.yaml @@ -0,0 +1,22 @@ +label: Devstation安装指南 +isManual: true +description: calamares 为 DevStation 客户端安装工具,帮助用户顺利完成 openEuler DevStation 安装 +sections: + - label: 概述 + href: ./install/devstation_installation_guide.md + - label: calamares简介 + href: ./calamares_introduction.md + - label: 在VirtualBox上安装 + href: ./install/devstation_installation_on_virtualbox.md + - label: 安装准备 + href: ./install/installation_preparations.md + - label: 安装指导 + href: ./install/installation_guide.md + - label: 在个人PC上双系统安装 + href: ./install/devstation_installation_on_pc_for_dual_booting.md + - label: 安装准备 + href: ./install/installation_preparations_1.md + - label: 安装指导 + href: ./install/installation_guide_1.md + - label: 在Hyper-v虚拟机上安装DevStation指南 + href: ./install/installation_guide_2.md diff --git a/docs/zh/calamares_introduction.md b/docs/zh/calamares_introduction.md new file mode 100644 index 0000000000000000000000000000000000000000..dc8720cdcd8b666127374fda578e0a767dcc642a --- /dev/null +++ b/docs/zh/calamares_introduction.md @@ -0,0 +1,3 @@ +# calamares 安装工具简介 + +calamares 为安装 DevStation 客户端工具, 帮助用户顺利完成 openEuler DevStation 安装。 diff --git a/docs/zh/install/devstation_installation_guide.md b/docs/zh/install/devstation_installation_guide.md new file mode 100644 index 0000000000000000000000000000000000000000..c36e82ce87bcf221ef3ad178dbda4d4bde1245c6 --- /dev/null +++ b/docs/zh/install/devstation_installation_guide.md @@ -0,0 +1,5 @@ +# 安装指南 + +本文档主要介绍 openEuler DevStation 安装方法,以指导用户顺利完成 openEuler DevStation 安装。 + +本文档适用于所有使用 openEuler DevStation 的用户,特别是初次使用或想了解 openEuler DevStation 的用户,包括社区开发者、高校师生、系统工程师、管理员及维护人员等。 diff --git a/docs/zh/install/devstation_installation_on_pc_for_dual_booting.md b/docs/zh/install/devstation_installation_on_pc_for_dual_booting.md new file mode 100644 index 0000000000000000000000000000000000000000..c0949db9a5a36d36661c8cef0c43fe37499e6096 --- /dev/null +++ b/docs/zh/install/devstation_installation_on_pc_for_dual_booting.md @@ -0,0 +1,5 @@ +# 在个人PC上双系统安装 DevStation + +前提:请先安装 windows 系统,再进行 openEuler DevStation 系统安装,不要将两者顺序颠倒,否则安装完成后无法引导 openEuler DevStation 系统。 + +本文是介绍在个人PC上安装 openEuler Devstation 的步骤方法,使用本手册需要具备基本的 Linux 系统管理知识。 diff --git a/docs/zh/install/devstation_installation_on_virtualbox.md b/docs/zh/install/devstation_installation_on_virtualbox.md new file mode 100644 index 0000000000000000000000000000000000000000..32652b722e49980923a2f91aa3f82e6187198865 --- /dev/null +++ b/docs/zh/install/devstation_installation_on_virtualbox.md @@ -0,0 +1,3 @@ +# 在 VirtualBox 上安装 DevStation + +本文是介绍在 VirtualBox 上安装 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..6add3c39c3a6767eeca3f1e0ab4099ac21507e2c Binary files /dev/null and b/docs/zh/install/figures/1-welcome.png differ diff --git a/docs/zh/install/figures/10-startinstall.png b/docs/zh/install/figures/10-startinstall.png new file mode 100644 index 0000000000000000000000000000000000000000..38e6fd27a848a5e67e98d84b4e1184f9a395956d Binary files /dev/null and b/docs/zh/install/figures/10-startinstall.png 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..1eb2009a7a9ca506580a3bf808b9ec272aeeda2d 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..d7ea30f980fb4b97fce136b78c5586887901668e 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..ae9822f8c009ac923838fc609a118f7a41f27f43 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..23abafb4bbdb9906b29a796b99220bf8ed45e558 Binary files /dev/null and b/docs/zh/install/figures/12-disk.png differ diff --git a/docs/zh/install/figures/12-installing.png b/docs/zh/install/figures/12-installing.png new file mode 100644 index 0000000000000000000000000000000000000000..0199a9d3e909d3aa88f9c403b8ec3e9fd59ccaa5 Binary files /dev/null and b/docs/zh/install/figures/12-installing.png 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..b99751c017cc22a0c5469d2aa239c34eaf38308a 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..0199a9d3e909d3aa88f9c403b8ec3e9fd59ccaa5 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..ae9822f8c009ac923838fc609a118f7a41f27f43 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.png b/docs/zh/install/figures/2-timezone.png new file mode 100644 index 0000000000000000000000000000000000000000..0c178aa9c33786fe22dcdfb8a431c010254f23bc Binary files /dev/null and b/docs/zh/install/figures/2-timezone.png 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..b99751c017cc22a0c5469d2aa239c34eaf38308a Binary files /dev/null and b/docs/zh/install/figures/3-installation.png differ diff --git a/docs/zh/install/figures/3-username.png b/docs/zh/install/figures/3-username.png new file mode 100644 index 0000000000000000000000000000000000000000..1eb2009a7a9ca506580a3bf808b9ec272aeeda2d Binary files /dev/null and b/docs/zh/install/figures/3-username.png 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..d7ea30f980fb4b97fce136b78c5586887901668e 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..b3eef9651b47fa2ec47197d30b18bb7c0ee772cf Binary files /dev/null and b/docs/zh/install/figures/5-manifast.png differ diff --git a/docs/zh/install/figures/6-fat32.png b/docs/zh/install/figures/6-fat32.png new file mode 100644 index 0000000000000000000000000000000000000000..38e6fd27a848a5e67e98d84b4e1184f9a395956d Binary files /dev/null and b/docs/zh/install/figures/6-fat32.png 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..285bd4e306e157435b6044298ff9bbc2a3630ba6 Binary files /dev/null and b/docs/zh/install/figures/7-bootefi.png differ diff --git a/docs/zh/install/figures/8-devstation.png b/docs/zh/install/figures/8-devstation.png new file mode 100644 index 0000000000000000000000000000000000000000..f88aab98378cb9c0ae7e41b0ae2345d68b90930c Binary files /dev/null and b/docs/zh/install/figures/8-devstation.png 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..6add3c39c3a6767eeca3f1e0ab4099ac21507e2c 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..bc6c04ae18d3b4308bb0105b3ff233383342aa51 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..0c178aa9c33786fe22dcdfb8a431c010254f23bc Binary files /dev/null and b/docs/zh/install/figures/9-timezone.png differ diff --git a/docs/zh/install/figures/blkid-share.png b/docs/zh/install/figures/blkid-share.png new file mode 100644 index 0000000000000000000000000000000000000000..dd541429f167a51cdbdde9f12a37655ab3b78ef9 Binary files /dev/null and b/docs/zh/install/figures/blkid-share.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/figures/desktop-icon.png b/docs/zh/install/figures/desktop-icon.png new file mode 100644 index 0000000000000000000000000000000000000000..f7a9c56ea9b959ec4ff15724ec9377d10f6f963f Binary files /dev/null and b/docs/zh/install/figures/desktop-icon.png differ diff --git a/docs/zh/install/figures/disk-location.png b/docs/zh/install/figures/disk-location.png new file mode 100644 index 0000000000000000000000000000000000000000..6920e5040cb484d96f0a48aec659a7860421ca2b Binary files /dev/null and b/docs/zh/install/figures/disk-location.png differ diff --git a/docs/zh/install/figures/download.png b/docs/zh/install/figures/download.png new file mode 100644 index 0000000000000000000000000000000000000000..f4030ac5eab4c4c42882c27189e79780236039a1 Binary files /dev/null and b/docs/zh/install/figures/download.png differ diff --git a/docs/zh/install/figures/first.png b/docs/zh/install/figures/first.png new file mode 100644 index 0000000000000000000000000000000000000000..f2d191da1b2b696683c1440badf1242a03646cb0 Binary files /dev/null and b/docs/zh/install/figures/first.png differ diff --git a/docs/zh/install/figures/hyper-cache.png b/docs/zh/install/figures/hyper-cache.png new file mode 100644 index 0000000000000000000000000000000000000000..9651b02060936608cf3bf78a8ed89c321f98884b Binary files /dev/null and b/docs/zh/install/figures/hyper-cache.png differ diff --git a/docs/zh/install/figures/hyper-disk-create.png b/docs/zh/install/figures/hyper-disk-create.png new file mode 100644 index 0000000000000000000000000000000000000000..c7d2bc631f9fa4621494b913f051bca38e184f6d Binary files /dev/null and b/docs/zh/install/figures/hyper-disk-create.png differ diff --git a/docs/zh/install/figures/hyper-iso.png b/docs/zh/install/figures/hyper-iso.png new file mode 100644 index 0000000000000000000000000000000000000000..79acc13ed53fcc81a8ae7324e5d680c42a8d432c Binary files /dev/null and b/docs/zh/install/figures/hyper-iso.png differ diff --git a/docs/zh/install/figures/hyper-net.png b/docs/zh/install/figures/hyper-net.png new file mode 100644 index 0000000000000000000000000000000000000000..7402d76dd1a969a734d600d0603523d138aaa045 Binary files /dev/null and b/docs/zh/install/figures/hyper-net.png differ diff --git a/docs/zh/install/figures/hyper-set.png b/docs/zh/install/figures/hyper-set.png new file mode 100644 index 0000000000000000000000000000000000000000..2d2548fff5ab9e4c08762e40087b52de0b698163 Binary files /dev/null and b/docs/zh/install/figures/hyper-set.png differ diff --git a/docs/zh/install/figures/install-exe.png b/docs/zh/install/figures/install-exe.png new file mode 100644 index 0000000000000000000000000000000000000000..28fb63862ef46a3cb4eca24510cc906e4bb3552e Binary files /dev/null and b/docs/zh/install/figures/install-exe.png differ diff --git a/docs/zh/install/figures/install-location.png b/docs/zh/install/figures/install-location.png new file mode 100644 index 0000000000000000000000000000000000000000..2ad0cd64baef9946c48eb0618d7d72a71cf742c0 Binary files /dev/null and b/docs/zh/install/figures/install-location.png differ diff --git a/docs/zh/install/figures/install-strong.jpg b/docs/zh/install/figures/install-strong.jpg new file mode 100644 index 0000000000000000000000000000000000000000..637c030424670743014cce12e23be5f3c641215d Binary files /dev/null and b/docs/zh/install/figures/install-strong.jpg differ diff --git a/docs/zh/install/figures/new-machain.png b/docs/zh/install/figures/new-machain.png new file mode 100644 index 0000000000000000000000000000000000000000..9c09a481baa42ce6dd1b5df860c66147f860ef01 Binary files /dev/null and b/docs/zh/install/figures/new-machain.png differ diff --git a/docs/zh/install/figures/remove-iso.png b/docs/zh/install/figures/remove-iso.png new file mode 100644 index 0000000000000000000000000000000000000000..30efe94fa55c500d67061b9cf5f73c98cc40aa7f Binary files /dev/null and b/docs/zh/install/figures/remove-iso.png differ diff --git a/docs/zh/install/figures/run-bash.png b/docs/zh/install/figures/run-bash.png new file mode 100644 index 0000000000000000000000000000000000000000..8893a28f6e330672d78d6775ea4ed181a2ca1c9f Binary files /dev/null and b/docs/zh/install/figures/run-bash.png differ diff --git a/docs/zh/install/figures/run-mount.png b/docs/zh/install/figures/run-mount.png new file mode 100644 index 0000000000000000000000000000000000000000..ce736f40ae9eb4c1dbbe7631b80f1f21646ea9aa Binary files /dev/null and b/docs/zh/install/figures/run-mount.png differ diff --git a/docs/zh/install/figures/set-hyper-v.png b/docs/zh/install/figures/set-hyper-v.png new file mode 100644 index 0000000000000000000000000000000000000000..64234851aa89b0930765a271fd25326305182932 Binary files /dev/null and b/docs/zh/install/figures/set-hyper-v.png differ diff --git a/docs/zh/install/figures/share-dir.png b/docs/zh/install/figures/share-dir.png new file mode 100644 index 0000000000000000000000000000000000000000..3a904e0ae2db554f671ca4b57bfaf9a184e7a48e Binary files /dev/null and b/docs/zh/install/figures/share-dir.png differ diff --git a/docs/zh/install/figures/vir-config.png b/docs/zh/install/figures/vir-config.png new file mode 100644 index 0000000000000000000000000000000000000000..80c67cf12949d5a3bd5dc598704af4c7aaff60bd Binary files /dev/null and b/docs/zh/install/figures/vir-config.png differ diff --git a/docs/zh/install/figures/vir-show.png b/docs/zh/install/figures/vir-show.png new file mode 100644 index 0000000000000000000000000000000000000000..c476a5ae694ae55a07cb014b4bcd818f3606526b Binary files /dev/null and b/docs/zh/install/figures/vir-show.png differ diff --git a/docs/zh/install/figures/vnc-connect.png b/docs/zh/install/figures/vnc-connect.png new file mode 100644 index 0000000000000000000000000000000000000000..e3e558f3f51728f910d6ed6575cf10fc182bd335 Binary files /dev/null and b/docs/zh/install/figures/vnc-connect.png differ diff --git a/docs/zh/install/figures/vnc-download.png b/docs/zh/install/figures/vnc-download.png new file mode 100644 index 0000000000000000000000000000000000000000..c88e9eb07827f3586101e590690983750db2798e Binary files /dev/null and b/docs/zh/install/figures/vnc-download.png differ diff --git a/docs/zh/install/figures/xstartup-conf-back.png b/docs/zh/install/figures/xstartup-conf-back.png new file mode 100644 index 0000000000000000000000000000000000000000..6ed1ac272b11846043758a72aa9ec5d7a2e6bedf Binary files /dev/null and b/docs/zh/install/figures/xstartup-conf-back.png differ diff --git a/docs/zh/install/figures/xstartup-conf.png b/docs/zh/install/figures/xstartup-conf.png new file mode 100644 index 0000000000000000000000000000000000000000..29cf9eae11e9200bbd445614f543fb9eac10ff75 Binary files /dev/null and b/docs/zh/install/figures/xstartup-conf.png differ diff --git a/docs/zh/install/installation_guide.md b/docs/zh/install/installation_guide.md new file mode 100644 index 0000000000000000000000000000000000000000..82a810e653cb19e1cf7af9f3067290747307820c --- /dev/null +++ b/docs/zh/install/installation_guide.md @@ -0,0 +1,327 @@ +# 安装指南 + +本章将以光盘安装为例,详细介绍如何安装 openEuler DevStation。对于其他安装方式,除了在启动安装时的引导方式可能有所不同外,其余的安装流程均相同,因此本章不再赘述。 + +## VirtualBox 下载安装 + +进入[virtualbox官网](https://www.virtualbox.org/),在Download栏目下选择Windows hosts下载 + +![](./figures/download.png) + +完成后双击.exe打开安装程序,选择自定义安装路径,点击下一步,在自定安装页面按需选择是否创建**桌面创建快捷方式** ,最后点击安装等待安装完成即可 + +![](./figures/install-exe.png) + +![](./figures/install-location.png) + +![](./figures/desktop-icon.png) + +## 启动安装 + +### 使用光盘引导安装 + +使用光盘引导安装 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. 选择下一步,在virtual hardware虚机配置页面按个人电脑配置情况将虚机内存、CPU、磁盘大小配置好,建议Base Memory内存配置不小于4G,DiskSize磁盘大小不小于40G,同时勾选“**Use EFI**”,现代计算机都基本都是UEFI方式启动,接着一路点击下一步即可完成虚拟机创建 + +![](./figures/vir-config.png) + +已创建的虚拟机会显示在Virtualbox页面左边,如图所示 + +![](./figures/vir-show.png) + +### 安装引导界面 + +系统使用引导介质完成引导后会显示引导菜单。该引导菜单除启动安装程序外还提供一些选项。安装系统时,默认采用“Start openEuler-25.09-DevStation-x86_64-dvd.iso 25.09”方式进行安装。如果要选择默认选项之外的选项,请使用键盘中的“↑”和“↓”方向键进行选择,并在选项为高亮状态时按“Enter”。 + +> ![](./public_sys-resources/icon-note.gif) **说明:** +> +> - 如果60秒内未按任何键,系统将从默认选项“Start openEuler-25.09-DevStation-x86_64-dvd.iso 25.09”自动进入安装界面。 + +**图 3** 安装引导界面 + +![img](./figures/3-installation.png) + +安装引导选项说明如下: + +- Start openEuler-25.09-DevStation-x86_64-dvd.iso 25.09 —— 默认选项。 +- Troubleshooting —— 问题定位模式,系统无法正常安装时使用。-功能待完善 + +在安装引导界面,按“e”进入已选选项的参数编辑界面,按“c”进入命令行模式。 + +DevStation 正常启动之后,会以Livecd方式进入主界面,同时以devstation用户权限自动拉起系统安装服务进行落盘安装。 + +## 设置系统语言 + +在“欢迎”页面中选择“语言”,设置系统的语言。如[图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)所示,根据[密码复杂度](https://www.openeuler.openatom.cn/whitepaper/openEuler%2024.03%20LTS%20SP2%20%E6%8A%80%E6%9C%AF%E7%99%BD%E7%9A%AE%E4%B9%A6.pdf)输入密码并再次输入密码进行确认。 + +>[!NOTE]说明 +> +> - 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即完成了安装。请点击“重启系统”按钮,系统将会重新启动。 + +## VirtualBox 共享文件夹配置指南 + +### 第一步:安装增强功能 + +在安装增强功能之前,确保虚机有网络。 + +**移除iso镜像文件**:操作如下:**设置->存储->控制器:IDE->Remove Disk From Virtual Drive** + +![](./figures/remove-iso.png) + +**加载虚拟光盘**:启动虚拟机并登录到操作系统,在VirtualBox顶部菜单栏,点击 **“设备” → “安装增强功能”**,如下图,这会自动加载一个虚拟光盘。 + +![](./figures/install-strong.jpg) + +之后在终端运行命令"**blkid**"查看结果:在输出结果中,寻找一个标识为 `cdrom` 或类型为 `iso9660` 的设备。如果看到类似 `/dev/sr0` 且文件系统是 `iso9660` 的行,就说明虚拟光盘已加载成功,如图所示。 + +```bash +blkid +``` + +![](./figures/blkid-share.png) + +**安装kernel-devel**:需要在虚机内部安装kernel-devel软件包: + +```bash +sudo dnf install kernel-devel -y +``` + +**安装增强功能**:进入“/dev/sr0”挂载的目录(查看/dev/sr0挂载目录:**lsblk** ),并在该目录下执行“VBoxLinuxAdditions.run脚本”,完成后**务必重启**虚拟机生效 + +```bash +lsblk +``` + +![](./figures/run-mount.png) + +```bash +./VBoxLinuxAdditions.run +``` + +![](./figures/run-bash.png) + +### 第二步:在VirtualBox中设置共享文件夹 + +打开VirtualBox,在虚拟机列表中选择需要配置的虚拟机,点击 “设置” 按钮,在设置窗口中,选择左侧的 “共享文件夹” 选项卡,点击右侧的 “添加共享文件夹” 图标(带加号的文件夹图标)。在弹出的对话框中,按以下要求配置: + +**文件夹路径**:点击右侧文件夹图标,选择宿主机上要共享的目录 + +**文件夹名称**:为这个共享起一个名字(例如 Share)。建议使用英文且不带空格 + +**只读分配**:如果只需要从虚拟机读取文件,可以勾选此项 + +**自动挂载**:**必须勾选**,这样VirtualBox增强功能通常会自动将共享文件夹挂载到 `/media/sf_<共享名称>` 目录下(例如 `/media/sf_share`),该目录即为共享目录 + +最后点击 “确定” 保存设置。这样,我们就成功设置/media/sf_share为共享目录 + +![](./figures/share-dir.png) + +### 第三步:设置普通用户操作权限 + +要确保用户对该目录有操作权限,需要将当前用户加入vboxsf用户组。执行此命令后**需要重启虚机**生效。 + +```bash +sudo usermod -aG vboxsf $USER +``` + +## VNC远程连接DevStation操作指南 + +### 一、VNC客户端安装(Windows系统为例) + +#### 1. 下载客户端 + +访问[VNC官网下载页面](https://sourceforge.net/projects/tigervnc/files/stable/1.15.0/) + +- 选择Windows版本下载安装文件 + + ![](./figures/vnc-download.png) + +- 下载完成后双击“.exe”文件进行安装 + +- 安装过程按照默认设置,一直点击“下一步”即可完成 + +#### 2. 安装验证 + +- 安装完成后可在开始菜单找到“TigerVNC Viewer”程序 + +### 二、DevStation环境准备 + +#### 1. 关闭防火墙 + +```bash +sudo systemctl stop firewalld +``` + +#### 2. 关闭SELinux + +```bash +sudo setenforce 0 +``` + +#### 3. 确保服务以普通用户启动 + +- 使用普通用户账户进行操作,不要使用root用户 + +### 三、VNC服务配置 + +#### 1. 设置VNC连接密码 + +```bash +sudo vncpasswd +``` + +- 按照提示设置并确认密码 + +#### 2. 启动VNC服务 + +```bash +sudo vncserver :2 +``` + +**端口说明:** + +- `:2` 对应端口 **5902** +- `:3` 对应端口 **5903** +- 以此类推,端口号 = 5900 + 启动编号 + +#### 3. 修改VNC启动配置文件 + +#### 配置文件位置 + +```bash +/home/[用户名]/.vnc/xstartup +``` + +例如:用户名为aaa,则路径为 `/home/aaa/.vnc/xstartup` + +#### 修改步骤 + +```bash +sudo sed -i '/if \[ -e \/usr\/bin\/gnome-session \]; then/,/fi/s/^/# /' /home/aaa/.vnc/xstartup +``` + +#### 配置文件对比 + +- **修改前**: + + ![](./figures/xstartup-conf.png) + +- **修改后**:这两行已被注释(以#开头) + + ![](./figures/xstartup-conf-back.png) + +### 四、客户端连接 + +#### 1. 启动TigerVNC Viewer + +- 打开安装好的TigerVNC Viewer客户端 + +#### 2. 输入连接信息 + +- 在连接地址栏输入:`IP:端口号`,例如:`192.168.1.100:5902`,或简写:`192.168.1.100:2` + + ![](./figures/vnc-connect.png) + +#### 3. 身份验证 + +- 点击“连接”按钮 +- 在弹出的窗口中输入之前设置的VNC密码 +- 点击“确定”即可建立远程连接 diff --git a/docs/zh/install/installation_guide_1.md b/docs/zh/install/installation_guide_1.md new file mode 100644 index 0000000000000000000000000000000000000000..5168ffee7851e224c4b235e18636aa91681a2aa2 --- /dev/null +++ b/docs/zh/install/installation_guide_1.md @@ -0,0 +1,248 @@ +# **安装指导** + +## 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-25.09-DevStation-x86_64-dvd.iso 25.09`(推荐) +- `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.png) + +## 4. 账户与安全设置 + +### 4.1 用户账户设置 + +**图4** 账户设置界面 + +![账户设置](./figures/3-username.png) + +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.png) + +> ![](./public_sys-resources/icon-warning.gif) **再次确认:** +> +> - 仔细检查每个分区的挂载点和大小 +> - 确认不会误操作其他系统的分区 + +## 7. 安装与初始化 + +### 7.1 安装确认 + +**图10** 安装确认界面 + +> ![](./public_sys-resources/icon-warning.gif) **最后确认:** +> +> - 再次检查所有设置,请确认分区当前和之后,是否选定**正确的空闲分区**上(如nvme0n1p7)安装 openEuler-25.09 +> - 确保电源稳定(笔记本请接通电源) + +点击"安装"开始系统部署 + +![安装确认](./figures/11-summary.png) + +### 7.2 安装进度 + +**图11** 安装过程界面 + +![安装进度](./figures/12-installing.png) + +预计时间: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/installation_guide_2.md b/docs/zh/install/installation_guide_2.md new file mode 100644 index 0000000000000000000000000000000000000000..2d76fc67fcc47ef1d4dd4931011463404c46c9e4 --- /dev/null +++ b/docs/zh/install/installation_guide_2.md @@ -0,0 +1,330 @@ +# 安装指南 + +本章将以光盘安装为例,详细介绍如何安装 openEuler DevStation。对于其他安装方式,除了在启动安装时的引导方式可能有所不同外,其余的安装流程均相同,因此本章不再赘述。 + +## Hyper-V 虚拟机创建完整指南 + +### 一、启用和安装 Hyper-V 功能 + +#### Windows 10/11 专业版/企业版/教育版 + +1. 打开 **控制面板** → **程序** → **启用或关闭 Windows 功能** + +2. 勾选以下选项: + + - Hyper-V + + - Hyper-V 管理工具 + + - Hyper-V 平台 + + - Hyper-V Hypervisor + + - Hyper-V 服务 + +3. 点击 **确定**,系统会自动安装 + +4. 安装完成后重启计算机 + +![](./figures/set-hyper-v.png) + +### 二、配置 Hyper-V 设置 + +#### 1. 打开 Hyper-V 管理器 + +- 开始菜单搜索 "Hyper-V 管理器" + +- 或运行 `virtmgmt.msc` + +#### 2. 配置虚拟硬盘和虚拟机存储路径 + +1. 在右侧操作面板点击 **Hyper-V 设置** + +2. 配置以下路径(建议选择空间充足的磁盘): + +- 虚拟硬盘(指定存储虚拟机磁盘文件的位置):`D:\Hyper-v-disk` + +- 虚拟机(指定存储虚拟机配置文件的位置):`D:\Hyper-v-machain` + +![](./figures/hyper-set.png) + +### 三、创建虚拟机 + +在 Hyper-V 管理器点击 快速创建 + +步骤1:启动向导 + +在右侧操作面板点击 新建 → 虚拟机 + +![](./figures/new-machain.png) + +点击 下一步 + +步骤2:指定名称和位置 + +名称:新建虚拟机 + +位置:D:\Hyper-v-disk + +![](./figures/disk-location.png) + +步骤3:指定代数 + +第1代:支持32位/64位,兼容旧系统 + +**PS:此处需选择第一代,第二代启动虚机会失败** + +![](./figures/first.png) + +步骤4:分配内存 + +启动内存:4096 MB(4GB) + +为 Hyper-V 使用动态内存:推荐勾选,勾选后内存变换范围:1024 MB至8192 MB。内存缓冲:20% + +![](./figures/hyper-cache.png) + +步骤5:配置网络 + +连接:Default Switch + +![](./figures/hyper-net.png) + +步骤6:连接虚拟硬盘 + +创建虚拟硬盘 + +名称:`新建虚拟机.vhdx` + +位置:D:\Hyper-v-disk\新建虚拟机\Virtual Hard Disks\ + +大小:64 GB(动态扩展) + +![](./figures/hyper-disk-create.png) + +步骤7:安装选项 + +选择 从可启动的CD/DVD-ROM安装操作系统 + +选择安装介质: + +映像文件 (.iso):浏览选择 Windows ISO 文件 + +![](./figures/hyper-iso.png) + +点击下一步,浏览虚拟机配置,然后点击完成即完成虚拟机的创建 + +### 安装引导界面 + +系统使用引导介质完成引导后会显示引导菜单。该引导菜单除启动安装程序外还提供一些选项。安装系统时,默认采用“Start openEuler-25.09-DevStation-x86_64-dvd.iso 25.09”方式进行安装。如果要选择默认选项之外的选项,请使用键盘中的“↑”和“↓”方向键进行选择,并在选项为高亮状态时按“Enter”。 + +> ![](./public_sys-resources/icon-note.gif) **说明:** +> +> - 如果60秒内未按任何键,系统将从默认选项“Start openEuler-25.09-DevStation-x86_64-dvd.iso 25.09”自动进入安装界面。 + +**图 3** 安装引导界面 + +![img](./figures/3-installation.png) + +安装引导选项说明如下: + +- Start openEuler-25.09-DevStation-x86_64-dvd.iso 25.09 —— 默认选项。 +- Troubleshooting —— 问题定位模式,系统无法正常安装时使用。-功能待完善 + +在安装引导界面,按“e”进入已选选项的参数编辑界面,按“c”进入命令行模式。 + +DevStation 正常启动之后,会以Livecd方式进入主界面,同时以devstation用户权限自动拉起系统安装服务进行落盘安装。 + +## 设置系统语言 + +在“欢迎”页面中选择“语言”,设置系统的语言。如[图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)所示,根据[密码复杂度](https://www.openeuler.openatom.cn/whitepaper/openEuler%2024.03%20LTS%20SP2%20%E6%8A%80%E6%9C%AF%E7%99%BD%E7%9A%AE%E4%B9%A6.pdf)输入密码并再次输入密码进行确认。 + +>[!NOTE]说明 +> +> - 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即完成了安装。请点击“重启系统”按钮,系统将会重新启动。 + +## VNC远程连接DevStation操作指南 + +### 一、VNC客户端安装(Windows系统为例) + +#### 1. 下载客户端 + +访问[VNC官网下载页面](https://sourceforge.net/projects/tigervnc/files/stable/1.15.0/) + +- 选择Windows版本下载安装文件 + + ![](./figures/vnc-download.png) + +- 下载完成后双击“.exe”文件进行安装 + +- 安装过程按照默认设置,一直点击“下一步”即可完成 + +#### 2. 安装验证 + +- 安装完成后可在开始菜单找到“TigerVNC Viewer”程序 + +### 二、DevStation环境准备 + +#### 1. 关闭防火墙 + +```bash +sudo systemctl stop firewalld +``` + +#### 2. 关闭SELinux + +```bash +sudo setenforce 0 +``` + +#### 3. 确保服务以普通用户启动 + +- 使用普通用户账户进行操作,不要使用root用户 + +### 三、VNC服务配置 + +#### 1. 设置VNC连接密码 + +```bash +sudo vncpasswd +``` + +- 按照提示设置并确认密码 + +#### 2. 启动VNC服务 + +```bash +sudo vncserver :2 +``` + +**端口说明:** + +- `:2` 对应端口 **5902** +- `:3` 对应端口 **5903** +- 以此类推,端口号 = 5900 + 启动编号 + +#### 3. 修改VNC启动配置文件 + +#### 配置文件位置 + +```bash +/home/[用户名]/.vnc/xstartup +``` + +例如:用户名为aaa,则路径为 `/home/aaa/.vnc/xstartup` + +#### 修改步骤 + +```bash +sudo sed -i '/if \[ -e \/usr\/bin\/gnome-session \]; then/,/fi/s/^/# /' /home/aaa/.vnc/xstartup +``` + +#### 配置文件对比 + +- **修改前**: + + ![](./figures/xstartup-conf.png) + +- **修改后**:这两行已被注释(以#开头) + + ![](./figures/xstartup-conf-back.png) + +### 四、客户端连接 + +#### 1. 启动TigerVNC Viewer + +- 打开安装好的TigerVNC Viewer客户端 + +#### 2. 输入连接信息 + +- 在连接地址栏输入:`IP:端口号`,例如:`192.168.1.100:5902`,或简写:`192.168.1.100:2` + + ![](./figures/vnc-connect.png) + +#### 3. 身份验证 + +- 点击“连接”按钮 +- 在弹出的窗口中输入之前设置的VNC密码 +- 点击“确定”即可建立远程连接 diff --git a/docs/zh/install/installation_preparations.md b/docs/zh/install/installation_preparations.md new file mode 100644 index 0000000000000000000000000000000000000000..480f38f66a769794a9bba549f7de29bb02fba331 --- /dev/null +++ b/docs/zh/install/installation_preparations.md @@ -0,0 +1,102 @@ +# 安装准备 + +在安装前,需要考虑软硬件的兼容性问题,并评估相关配置和准备工作,确保安装过程顺利进行。 + +## 获取安装源 + +在安装开始前,您需要获取 openEuler DevStation 的镜像和校验文件。 + +请按以下步骤获取 openEuler Devstation 的镜像和校验文件: + +1. 登录[openEuler DevStation 社区镜像源](https://repo.openeuler.org/)网站。 +2. 选择 openEuler-25.09 版本。 +3. 根据实际待安装环境的架构和场景选择需要下载的 openEuler DevStation 的镜像和校验文件。 + 1. 若为 aarch64 架构。 + 1. 选择 aarch64 目录。 + 2. 将镜像 “openEuler-25.09-DevStation-aarch64-dvd.iso” 下载到本地。 + 2. 若为 x86_64 架构。 + 1. 选择 x86_64 目录。 + 2. 将镜像 “openEuler-25.09-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-25.09-DevStation-aarch64-dvd.iso。 +- 校验文件:openEuler-25.09-DevStation-aarch64-dvd.iso.sha256sum,文件保存ISO完整性校验值信息,校验信息与ISO值一一对应。 + +### 操作指导 + +文件完整性校验操作步骤如下: + +1. 计算文件的 sha256 校验值。执行命令如下: + + ```bash + sha256sum openEuler-25.09-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/installation_preparations_1.md b/docs/zh/install/installation_preparations_1.md new file mode 100644 index 0000000000000000000000000000000000000000..ab2b48a7a642621111dbebebe640b0f4898ff42c --- /dev/null +++ b/docs/zh/install/installation_preparations_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-25.09 版本。 +3. 根据实际待安装环境的架构和场景选择需要下载的 openEuler DevStation 的镜像和校验文件。 + 1. 若为 aarch64 架构。 + 1. 选择 aarch64 目录。 + 2. 将镜像 “openEuler-25.09-DevStation-aarch64-dvd.iso” 下载到本地。 + 2. 若为 x86_64 架构。 + 1. 选择 x86_64 目录。 + 2. 将镜像 “openEuler-25.09-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-25.09-DevStation-aarch64-dvd.iso。 +- 校验文件:openEuler-25.09-DevStation-aarch64-dvd.iso.sha256sum,文件保存ISO完整性校验值信息,校验信息与ISO值一一对应。 + +### 操作指导 + +文件完整性校验操作步骤如下: + +1. 计算文件的 sha256 校验值。执行命令如下: + + ```bash + sha256sum openEuler-25.09-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-25.09-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/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