diff --git a/docs/source/bsp/arm64/hisilicon/kp920/kp920.rst b/docs/source/bsp/arm64/hisilicon/kp920/kp920.rst index 0f305e0f60c572d12b73715b4da4933a91be2b37..3a57710b0742ccb7401f0e197c857e99f7880637 100644 --- a/docs/source/bsp/arm64/hisilicon/kp920/kp920.rst +++ b/docs/source/bsp/arm64/hisilicon/kp920/kp920.rst @@ -61,7 +61,157 @@ ____ 安装说明 ======== -.. seealso:: +1. 使用光驱安装： - 参考 :ref:`openEuler Embedded ISO 镜像安装说明 `，若使用 BMC 进行安装，请在 BMC 界面挂载光驱并选择光驱启动之后进行镜像安装。 + .. seealso:: + 参考 :ref:`openEuler Embedded ISO 镜像安装说明 `，若使用 BMC 进行安装，请在 BMC 界面挂载光驱并选择光驱启动之后进行镜像安装。 + +2. 使用PXE安装： + + 2.1 环境准备 + + 执行PXE安装需要准备一台PXE服务器，并确保需要安装镜像的设备可以与PXE服务器建立连接。PXE服务器用于存放 openEuler Embedded 镜像与各项配置文件，以便目标机器通过连接PXE服务器，进行PXE安装。 + + .. note:: + + 下文将PXE服务器 IP 设置为 192.168.122.10，目标机器需要与PXE服务器在同网段下。 + + 2.2 PXE服务器配置 + + 1. 设置HTTP服务 + + 通过以下命令安装 httpd 服务，并进行启动和激活： + + .. code-block:: console + + # yum install -y httpd + # systemctl start httpd + # systemctl enable httpd + + 2. 设置TFTP服务 + + 通过以下命令安装 tftp 服务，并进行相关配置： + + .. code-block:: console + + # yum install -y tftp-server xinetd + # vim /etc/xinetd.d/tftp + service tftp + { + socket_type = dgram + protocol = udp + wait = yes + user = root + server = /usr/sbin/in.tftpd + server_args = -s /var/lib/tftpboot + disable = no + per_source = 11 + cps = 100 2 + flags = IPv4 + } + # systemctl start tftp + # systemctl enable tftp + # systemctl start xinetd + # systemctl status xinetd + # systemctl enable xinetd + + 3. 设置DHCP服务 + + 通过以下命令安装 dhcp 服务，并进行相关配置： + + .. code-block:: console + + # yum install -y dhcp + # vim /etc/dhcp/dhcpd.conf + authoritative + ddns-update-style interim; + ignore client-updates; + subnet 192.168.122.0 netmask 255.255.255.0 { + range 192.168.122.100 192.168.122.200; # 动态IP范围 + next-server 192.168.122.10; # PXE服务器IP地址 + filename "grubaa64.efi"; # 默认的grub文件名，需要与下文中下载的grub文件名保持一致 + option routers 192.168.122.1; # 网关地址 + option subnet-mask 255.255.255.0; # 子网掩码 + default-lease-time 86400; + max-lease-time 172800; + } + + # systemctl start dhcpd + # systemctl enable dhcpd + + 4. 安装源的制作 + + 通过以下命令本地挂载 openEuler Embedded ISO镜像： + + .. code-block:: console + + # mkdir -p /mnt/iso + # sudo mount openeuler_embedded.iso /mnt/iso # 镜像名称请以实际为准 + + 5. 准备PXE安装所需文件 + + a. 准备启动引导文件： + + 下载 `grubaa64.efi `_，之后，通过以下命令，将grub放在tftpboot目录，并创建grub.cfg： + + .. code-block:: console + + # 准备引导文件： + # mkdir -p /var/lib/tftpboot + # cp grubaa64.efi /var/lib/tftpboot + # cp /mnt/iso/Image /var/lib/tftpboot + # cp /mnt/iso/initrd /var/lib/tftpboot + + # 创建 grub.cfg + # vim /var/lib/tftpboot/grub.cfg + set default="1" + + function load_video { + if [ x$feature_all_video_module = xy ]; then + insmod all_video + else + insmod efi_gop + insmod efi_uga + insmod ieee1275_fb + insmod vbe + insmod vga + insmod video_bochs + insmod video_cirrus + fi + } + + load_video + set gfxpayload=keep + insmod gzio + insmod part_gpt + insmod ext2 + + set timeout=60 + + menuentry 'openEuler Embedded PXE Install' { + linux /Image LABEL=install-pxe install_cfg=http://192.168.122.10/install_pxe.cfg root=/dev/ram0 console=tty1 crashkernel=256M + initrd /initrd + } + + b. 准备 ISO 安装所需文件： + + PXE安装需要iso镜像、iso镜像的sha256校验值，以及配置文件 ``install_pxe.cfg``： + + .. code-block:: console + + # 假设iso镜像名为 openeuler_embedded.iso，sha256校验值文件为 openeuler_embedded.iso.sha256sum + # cp openeuler_embedded.iso /var/lib/tftpboot + # cp openeuler_embedded.iso.sha256sum /var/lib/tftpboot + # chmod +rx /var/lib/tftpboot + # chmod +r /var/lib/tftpboot/openeuler_embedded.iso + + # vim /var/lib/tftpboot/install_pxe.cfg + INSTALL_ISO="openeuler_embedded.iso" # openEuler Embedded 镜像名称 + TARGET_DEVICE_NAME="sda" # 目标机器预备安装系统的盘 + INSTALL_ISO_SHA256="openeuler_embedded.iso.sha256sum" # 镜像sha256sum校验值文件 + + 2.3 安装步骤 + + 在 BMC 界面选择 ``PXE`` 启动项，重启系统开始自动化安装，系统安装完成后，会提示：``Installation successful. Remove your installation media and press ENTER to reboot.`` + 之后可以在 BMC 界面选择 ``BIOS`` 启动项，按 Enter 键重启机器，重启后进入 BIOS 界面选择对应的磁盘启动项，进行系统启动。 diff --git a/docs/source/bsp/x86/HVAEIPC-M10/images/grub-option.png b/docs/source/bsp/x86/HVAEIPC-M10/images/grub-option.png index 6221e67330bcd818ed47cc9e3399c9c8695182f5..c0bc88b9ffb0f692e885e638a43d4a1ad0a70344 100644 Binary files a/docs/source/bsp/x86/HVAEIPC-M10/images/grub-option.png and b/docs/source/bsp/x86/HVAEIPC-M10/images/grub-option.png differ diff --git a/docs/source/bsp/x86/HVAEIPC-M10/m10.rst b/docs/source/bsp/x86/HVAEIPC-M10/m10.rst index a68789a86f565e2d796da77a09226a2cb3ace9ba..8a7cc1634ff8915d73bd8f22ab155a2edb9e718b 100644 --- a/docs/source/bsp/x86/HVAEIPC-M10/m10.rst +++ b/docs/source/bsp/x86/HVAEIPC-M10/m10.rst @@ -29,9 +29,6 @@ ____ 安装说明 ======== -.. warning:: - 进行openEuler Embedded镜像安装，会擦除安装磁盘中原有的数据。 - 1. 使用构建出来的iso镜像制作U盘启动盘，例如使用Rufus制作： .. image:: images/install-step1.png @@ -43,6 +40,11 @@ ____ 选择 ``boot`` 可以进入live os，一般用于debug；选择 ``install`` 进入系统安装流程。 + .. warning:: + 选择 install 选项进行安装，会擦除安装磁盘中原有的数据。 + + 选择 install(without-formatting) 选项进行安装，不会擦除整个分区，仅会使用安装镜像中的文件覆盖安装分区中的文件。 + 3. 选择 ``install`` 后，进行系统安装，依次输入U盘和安装盘： .. image:: images/install-step3.jpg diff --git a/docs/source/developer_guide/develop/board-support/index.rst b/docs/source/developer_guide/develop/board-support/index.rst index ea0c216afa12800427118af479e00f19bcd85bcf..cfda9dae94299f1451f8bf3603bb5a6b9af486a6 100644 --- a/docs/source/developer_guide/develop/board-support/index.rst +++ b/docs/source/developer_guide/develop/board-support/index.rst @@ -13,7 +13,7 @@ add_new_bsp_layer.rst .. note:: - 如果厂商在 :ref:`board-support-list` 已经支持，可以按照下面的步骤快速新增。 + 参考下面的步骤快速新增。 .. toctree:: :maxdepth: 1 diff --git a/docs/source/features/xen.rst b/docs/source/features/xen.rst index 8b93ed48f67c14adf73a723efe1a6a5507c1075f..d513368dcb325ddbb891ac4ffd8c3801f3b042ea 100644 --- a/docs/source/features/xen.rst +++ b/docs/source/features/xen.rst @@ -69,7 +69,7 @@ Xen 使用指导 如果需要退出 DomU 的 shell，可以通过 ``ctrl + ]`` 组合键切换回 Dom0，通过 ``xl console domU`` 可以重新进入。 示例：基于KP920引导一个实时OS作为DomU ---------------------------------- +------------------------------------- 1. KP920使能xen的镜像已默认打包一个实时OS的示例，包括xen config和使能xen的zephyr镜像。