长期支持版本

    社区创新版本

      基础配置

      设置语言环境

      您可以通过localectl修改系统的语言环境,对应的参数设置保存在/etc/locale.conf文件中。这些参数会在系统启动过程中被systemd的守护进程读取。

      显示当前语言环境状态

      显示当前语言环境,命令如下:

      localectl status
      

      例如显示系统当前的设置,命令和输出如下:

      # localectl status
         System Locale: LANG=zh_CN.UTF-8
             VC Keymap: cn
            X11 Layout: cn
      

      列出可用的语言环境

      显示当前可用的语言环境,命令如下:

      # localectl list-locales
      

      例如显示当前系统中所有可用的中文环境,命令和输出如下:

      # localectl list-locales | grep zh
      zh_CN.UTF-8
      

      设置语言环境

      要设置语言环境,在root权限下执行如下命令,其中 locale 是您要设置的语言类型,取值范围可通过localectl list-locales获取,请根据实际情况修改。

      # localectl set-locale LANG=locale
      

      例如设置为简体中文语言环境,在root权限下执行如下命令:

      # localectl set-locale LANG=zh_CN.UTF-8
      

      说明: 修改后需要重新登录或者在root权限下执行source /etc/locale.conf命令刷新配置文件,使修改生效。

      设置键盘

      您可以通过localectl修改系统的键盘设置,对应的参数设置保存在/etc/locale.conf文件中。这些参数,会在系统启动的早期被systemd的守护进程读取。

      显示当前设置

      显示当前键盘设置,命令如下:

      # localectl status
      

      例如显示系统当前的设置,命令和输出如下:

      # localectl status
         System Locale: LANG=zh_CN.UTF-8
             VC Keymap: cn
            X11 Layout: cn
      

      列出可用的键盘布局

      显示当前可用的键盘布局,命令如下:

      # localectl list-keymaps
      

      例如显示系统当前的中文键盘布局,命令和输出如下:

      # localectl list-keymaps | grep cn
      cn
      

      设置键盘布局

      设置键盘布局,在root权限下执行如下命令,其中 map 是您想要设置的键盘类型,取值范围可通过localectl list-keymaps获取,请根据实际情况修改:

      # localectl set-keymap map
      

      此时设置的键盘布局同样也会应用到图形界面中。

      设置完成后,查看当前状态:

      # localectl status
         System Locale: LANG=zh_CN.UTF-8
             VC Keymap: cn
            X11 Layout: us
      

      设置日期和时间

      本节介绍如何通过timedatectl、date、hwclock命令来设置系统的日期、时间和时区等。

      使用timedatectl命令设置

      显示日期和时间

      显示当前的日期和时间,命令如下:

      # timedatectl
      

      例如显示系统当前的日期和时间,命令和输出如下:

      # timedatectl
                     Local time: Mon 2019-09-30 04:05:00 EDT
                 Universal time: Mon 2019-09-30 08:05:00 UTC
                       RTC time: Mon 2019-09-30 08:05:00
                      Time zone: China Standard Time (CST), UTC +8
      System clock synchronized: no
                    NTP service: inactive
                RTC in local TZ: no
      

      通过远程服务器进行时间同步

      您可以启用NTP远程服务器进行系统时钟的自动同步。是否启用NTP,可在root权限下执行如下命令进行设置。其中 boolean 可取值yes和no,分别表示启用和不启用NTP进行系统时钟自动同步,请根据实际情况修改。

      说明: 若启用了NTP远程服务器进行系统时钟自动同步,则不能手动修改日期和时间。若需要手动修改日期或时间,则需确保已经关闭NTP系统时钟自动同步。可执行timedatectl set-ntp no命令进行关闭。

      例如开启自动远程时间同步,命令如下:

      # timedatectl set-ntp yes
      

      修改日期

      说明: 修改日期前,请确保已经关闭NTP系统时钟自动同步。

      修改当前的日期,在root权限下执行如下命令,其中 YYYY 代表年份,MM 代表月份,DD 代表某天,请根据实际情况修改:

      # timedatectl set-time YYYY-MM-DD
      

      例如修改当前的日期为2019年8月14号,命令如下:

      # timedatectl set-time '2019-08-14'
      

      修改时间

      说明: 修改时间前,请确保已经关闭NTP系统时钟自动同步。

      修改当前的时间,在root权限下执行如下命令,其中 HH 代表小时,MM 代表分钟,SS 代表秒,请根据实际情况修改:

      # timedatectl set-time HH:MM:SS
      

      例如修改当前的时间为15点57分24秒,命令如下:

      # timedatectl set-time 15:57:24
      

      修改时区

      显示当前可用时区,命令如下:

      timedatectl list-timezones
      

      要修改当前的时区,在root权限下执行如下命令,其中 time_zone 是您想要设置的时区,请根据实际情况修改:

      # timedatectl set-timezone time_zone
      

      例如修改当前的时区,首先查询所在地域的可用时区,此处以Asia为例:

      # timedatectl list-timezones | grep Asia
      Asia/Aden
      Asia/Almaty
      Asia/Amman
      Asia/Anadyr
      Asia/Aqtau
      Asia/Aqtobe
      Asia/Ashgabat
      Asia/Baghdad
      Asia/Bahrain
      ……
      
      Asia/Seoul
      Asia/Shanghai
      Asia/Singapore
      Asia/Srednekolymsk
      Asia/Taipei
      Asia/Tashkent
      Asia/Tbilisi
      Asia/Tehran
      Asia/Thimphu
      Asia/Tokyo
      

      然后修改当前的时区为“Asia/Shanghai”,命令如下:

      # timedatectl set-timezone Asia/Shanghai
      

      使用date命令设置

      显示当前的日期和时间

      显示当前的日期和时间,命令如下:

      # date
      

      默认情况下,date命令显示本地时间。要显示UTC时间,添加--utc或-u参数:

      # date --utc
      

      要自定义对应的输出信息格式,添加 +"format" 参数:

      # date +"format"
      

      表 1 参数说明

      格式参数

      说明

      %H

      小时以HH格式(例如 17)。

      %M

      分钟以MM格式(例如 37)。

      %S

      秒以SS格式(例如 25)。

      %d

      日期以DD格式(例如 15)。

      %m

      月份以MM格式(例如 07)。

      %Y

      年份以YYYY格式(例如 2019)。

      %Z

      时区缩写(例如CEST)。

      %F

      日期整体格式为YYYY-MM-DD(例如 2019-7-15),等同%Y-%m-%d。

      %T

      时间整体格式为HH:MM:SS(例如 18:30:25),等同%H:%M:%S。

      实际使用示例如下:

      • 显示当前的日期和本地时间。

        # date 
        2019年 08月 17日 星期六 17:26:34 CST
        
      • 显示当前的日期和UTC时间。

        # date --utc
        2019年 08月 17日 星期六 09:26:18 UTC
        
      • 自定义date命令的输出。

        # date +"%Y-%m-%d %H:%M"
        2019-08-17 17:24
        

      修改时间

      要修改当前的时间,添加--set或者-s参数。在root权限下执行如下命令,其中 HH 代表小时,MM 代表分钟,SS 代表秒,请根据实际情况修改:

      # date --set HH:MM:SS
      

      默认情况下, date命令设置本地时间。要设置UTC时间,添加--utc或-u参数:

      # date --set HH:MM:SS --utc
      

      例如修改当前的时间为23点26分00秒,在root权限下执行如下命令:

      # date --set 23:26:00
      

      修改日期

      修改当前的日期,添加--set或者-s参数。在root权限下执行如下命令,其中 YYYY 代表年份,MM 代表月份,DD 代表某天,请根据实际情况修改:

      # date --set YYYY-MM-DD
      

      例如修改当前的日期为2019年11月2日,命令如下:

      # date --set 2019-11-02
      

      使用hwclock命令设置

      可以使用 hwclock 命令设置硬件时钟RTC (Real Time Clock) 。

      硬件时钟和系统时钟

      Linux 将时钟分为:

      • 系统时钟 (System Clock) :当前Linux Kernel中的时钟。
      • 硬件时钟 RTC:主板上由电池供电的主板硬件时钟,该时钟可以在BIOS的 "Standard BIOS Feature" 项中进行设置。

      当Linux启动时,会读取硬件时钟,并根据硬件时间来设置系统时间。

      显示日期和时间

      显示当前硬件的日期和时间,在root权限下执行如下命令:

      # hwclock
      

      例如显示当前硬件的日期和时间,命令和输出如下:

      # hwclock
      2019-08-26 10:18:42.528948+08:00
      

      设置日期和时间

      修改当前硬件的日期和时间,在root权限下执行如下命令,其中 dd 表示日,mm 表示月份,yyyy 表示年份,HH 表示小时,MM 表示分钟,请根据实际情况修改:

      # hwclock --set --date "yyyy-mm-dd HH:MM"
      

      例如修改当前的时间为2019年10月21日21点17分,命令如下:

      # hwclock --set --date "2019-10-21 21:17"
      

      设置kdump

      本节介绍如何设置kdump预留内存及修改kdump配置文件参数。

      设置kdump预留内存

      预留内存参数格式

      kdump预留内存参数必须添加到内核启动参数中,配置文件为/boot/efi/EFI/openEuler/grub.cfg(UEFI引导模式)或/boot/grub2/grub.cfg(legacy引导模式),openEuler发布版本中默认已经添加,可以根据实际使用情况调整。添加和修改启动参数后,重启系统生效。kdump预留内存参数格式如下:

      内核启动参数描述缺省值备注
      crashkernel=x在4G以下的物理内存预留x大小的内存给kdump使用。x86版本默认配置512M该配置方法只在4G以下内存预留,必须保证4G以下连续可用内存足够预留。
      crashkernel=x@y在y起始地址预留x大小的内存给kdump使用。未使用需要确保y起始地址的x大小的内存未被其他模块预留。
      crashkernel=x,high在4G以下的物理内存中预留256M内存,在4G以上预留x大小内存给kdump使用。arm64版本默认配置1024M,high需要确保4G以下有256M连续可用的物理内存,4G以上有连续的x大小的连续物理内存。实际预留内存大小为256M+x。
      crashkernel=x,low crashkernel=y,high在4G以下的物理内存中预留x大小,在4G以上预留y大小内存给kdump使用。未使用需要确保4G以下有连续的x大小物理内存,4G以上有连续的y大小物理内存。

      预留内存推荐值

      推荐方案预留参数参数说明
      通用方案crashkernel=2048M,high4G以下预留256M,4G以上预留2048M内存给kdump使用。共256+2048M。
      经济方案crashkernel=1024M,high4G以下预留256M,4G以上预留1024M内存给kdump使用。共256+1024M。 推荐系统512M内存以内的场景,并不使用网络转储kdump文件。对于虚拟机场景,可以适当减少内存预留值,推荐虚拟机设置为crashkernel=512M或者crashkernel=256M,high

      说明: 不通过网络转储kdump文件时,需要设置kdump文件系统不打包网络相关驱动。网络驱动加载需要申请较大内存,可能导致预留内存不足,kdump失败。因此建议禁用网络相关驱动。

      禁用网络相关驱动

      kdump配置文件(/etc/kdump.conf)中,dracut参数可以设置裁剪的驱动模块,可以将网络驱动配置到裁剪驱动列表中,让kdump文件系统中不加载该驱动,修改配置文件后,重启kdump服务生效。dracut参数配置如下所示:

      dracut_args --omit-drivers "mdio-gpi usb_8dev et1011c rt2x00usb bcm-phy-lib mac80211_hwsim rtl8723be rndis_host hns3_cae amd vrf rtl8192cu mt76x02-lib int51x1 ppp_deflate team_mode_loadbalance smsc911x aweth bonding mwifiex_usb hnae dnet rt2x00pci vaser_pci hdlc_ppp marvell rtl8xxxu mlxsw_i2c ath9k_htc rtl8150 smc91x cortina at803x rockchip cxgb4 spi_ks8995 mt76x2u smsc9420 mdio-cavium bnxt_en ch9200 dummy macsec ice mt7601u rtl8188ee ixgbevf net1080 liquidio_vf be2net mlxsw_switchx2 gl620a xilinx_gmii2rgmii ppp_generic rtl8192de sja1000_platform ath10k_core cc770_platform realte igb c_can_platform c_can ethoc dm9601 smsc95xx lg-vl600 ifb enic ath9 mdio-octeon ppp_mppe ath10k_pci cc770 team_mode_activebackup marvell10g hinic rt2x00lib mlx4_en iavf broadcom igc c_can_pci alx rtl8192se rtl8723ae microchip lan78xx atl1c rtl8192c-common almia ax88179_178a qed netxen_nic brcmsmac rt2800usb e1000 qla3xxx mdio-bitbang qsemi mdio-mscc-miim plx_pci ipvlan r8152 cx82310_eth slhc mt76x02-usb ems_pci xen-netfront usbnet pppoe mlxsw_minimal mlxsw_spectrum cdc_ncm rt2800lib rtl_usb hnae3 ath9k_common ath9k_hw catc mt76 hns_enet_drv ppp_async huawei_cdc_ncm i40e rtl8192ce dl2 qmi_wwan mii peak_usb plusb can-dev slcan amd-xgbe team_mode_roundrobin ste10Xp thunder_xcv pptp thunder_bgx ixgbe davicom icplus tap tun smsc75xx smsc dlci hns_dsaf mlxsw_core rt2800mmi softing uPD60620 vaser_usb dp83867 brcmfmac mwifiex_pcie mlx4_core micrel team macvlan bnx2 virtio_net rtl_pci zaurus hns_mdi libcxgb hv_netvsc nicvf mt76x0u teranetics mlxfw cdc_eem qcom-emac pppox mt76-usb sierra_net i40evf bcm87xx mwifiex pegasus rt2x00mmi sja1000 ena hclgevf cnic cxgb4vf ppp_synctty iwlmvm team_mode_broadcast vxlan vsockmon hdlc_cisc rtl8723-common bsd_comp fakelb dp83822 dp83tc811 cicada fm10 8139t sfc hs geneve hclge xgene-enet-v2 cdc_mbim hdlc asix netdevsim rt2800pci team_mode_random lxt ems_usb mlxsw_pci sr9700 mdio-thunder mlxsw_switchib macvtap atlantic cdc_ether mcs7830 nicpf mdi peak_pci atl1e cdc_subset ipvtap btcoexist mt76x0-common veth slip iwldvm bcm7xxx vitesse netconsole epic100 myri10ge r8169 qede microchip_t1 liquidi bnx2x brcmutil mwifiex_sdi mlx5_core rtlwifi vmxnet3 nlmon hns3 hdlc_raw esd_usb2 atl2 mt76x2-common iwlwifi mdio-bcm-unimac national ath rtwpci rtw88 nfp rtl8821ae fjes thunderbolt-net 8139cp atl1 mscc vcan dp83848 dp83640 hdlc_fr e1000e ipheth net_failover aquantia rtl8192ee igbvf rocker intel-xway tg3" --omit "ramdisk network ifcfg qemu-net" --install "chmod" --nofscks

      设置磁盘调度算法

      本节介绍如何设置磁盘调度算法。

      临时修改调度策略

      例如将所有IO调度算法修改为mq-deadline,此修改重启后会失效。

      # echo mq-deadline > /sys/block/sd*/queue/scheduler
      

      永久设置调度策略

      可以通过在内核启动配置文件grub.cfg中的kernel行追加:elevator=mq-deadline,重启后生效。

      linux   /vmlinuz-4.19.90-2003.4.0.0036.oe1.x86_64 root=/dev/mapper/openeuler-root ro resume=/dev/mapper/openeuler-swap rd.lvm.lv=openeuler/root rd.lvm.lv=openeuler/swap quiet crashkernel=512M elevator=mq-deadline
      

      设置NMI watchdog

      本节介绍openEuler在arm64架构上NMI watchdog方案的差异以及配置。

      概述

      NMI watchdog(Hard lockup detector)是一种用来检测系统是否出现Hard lockup(硬死锁)的机制。一般的watchdog依赖时钟中断进行挂死检测,当系统在原子上下文(中断,或者中断关闭的上下文中,etc)中出现挂死时,时钟中断处理,检测失效。NMI watchdog一般通过PMC(或者PMU)的NMI中断进行检测,NMI中断可以在原子上下文中产生并处理,因此可以用来检测原子上下文中挂死的场景。

      NMI watchdog主线已经支持,当硬件满足以下条件时可以使能NMI watchdog:

      1. 支持NMI中断
      2. 支持PMC(PMU)

      在arm64上,openEuler基于arm64的SDEI功能实现了SDEI watchdog作为NMI watchdog。因此openEuler在arm64上存在2种NMI watchdog方案:

      1. SDEI watchdog(默认方式)
      2. 基于PMC(PMU)中断的NMI watchdog

      注意事项

      对于arm64机器,需要注意以下事项:

      • 默认情况下使用SDEI watchdog。当SDEI watchdog使能失败时,不会切换到NMI watchdog
      • 需要使用NMI watchdog时,需要显式的在启动参数中禁用SDEI watchdog:disable_sdei_nmi_watchdog
      • 当需要使用NMI watchdog时,需要保证硬件支持NMI中断:
        • 当硬件支持NMI中断时,不需要额外处理
        • 当硬件不支持NMI中断,但是支持伪NMI中断时,需要显式的在启动参数中使能伪NMI中断:irqchip.gicv3_pseudo_nmi=1

      以上事项不影响非arm64平台。

      操作步骤

      针对arm64架构配置NMI watchdog的操作步骤如下:

      1. 在OS的引导配置文件grub.cfg中添加如下参数:irqchip.gicv3_pseudo_nmi=1(仅通过Pseudo-NMI实现NMI watchdog时添加) disable_sdei_nmi_watchdog
      2. 检查NMI watchdog是否加载成功,如果加载成功,内核dmesg日志打印类似如下内容
      [   11.361889][  T129] NMI watchdog: Enabled. Permanently consumes one hw-PMU counter.
      

      关闭NMI watchdog

      将NMI watchdog临时关闭,此修改重启后会失效;默认nmi_watchdog=1。

      #  echo 0 > /proc/sys/kernel/nmi_watchdog
      

      在OS启动时,可以通过配置内核参数nmi_watchdog=0关闭NMI watchdog。

      修改NMI watchdog阈值

      修改NMI watchdog阈值,此修改重启后会失效;默认watchdog_thresh=10。

      #  echo 10 > /proc/sys/kernel/watchdog_thresh
      

      在OS启动时,可以通过配置内核参数watchdog_thresh=[0-60]修改阈值。

      文档捉虫

      “有虫”文档片段

      问题描述

      提交类型 issue

      有点复杂...

      找人问问吧。

      PR

      小问题,全程线上修改...

      一键搞定!

      问题类型
      规范和低错类

      ● 错别字或拼写错误;标点符号使用错误;

      ● 链接错误、空单元格、格式错误;

      ● 英文中包含中文字符;

      ● 界面和描述不一致,但不影响操作;

      ● 表述不通顺,但不影响理解;

      ● 版本号不匹配:如软件包名称、界面版本号;

      易用性

      ● 关键步骤错误或缺失,无法指导用户完成任务;

      ● 缺少必要的前提条件、注意事项等;

      ● 图形、表格、文字等晦涩难懂;

      ● 逻辑不清晰,该分类、分项、分步骤的没有给出;

      正确性

      ● 技术原理、功能、规格等描述和软件不一致,存在错误;

      ● 原理图、架构图等存在错误;

      ● 命令、命令参数等错误;

      ● 代码片段错误;

      ● 命令无法完成对应功能;

      ● 界面错误,无法指导操作;

      风险提示

      ● 对重要数据或系统存在风险的操作,缺少安全提示;

      内容合规

      ● 违反法律法规,涉及政治、领土主权等敏感词;

      ● 内容侵权;

      您对文档的总体满意度

      非常不满意
      非常满意
      提交
      根据您的反馈,会自动生成issue模板。您只需点击按钮,创建issue即可。
      文档捉虫
      编组 3备份