From e594a5f19ae7607b5a8c9d15d951bee65ee10330 Mon Sep 17 00:00:00 2001 From: zhangsz Date: Sat, 21 Jun 2025 12:06:27 +0800 Subject: [PATCH] fix: build shell --- bin/build.sh | 8 +- docs/quickstart/01-PSAP OMC 安装指南.md | 402 ++++++++++++++++++++++++ 2 files changed, 407 insertions(+), 3 deletions(-) create mode 100644 docs/quickstart/01-PSAP OMC 安装指南.md diff --git a/bin/build.sh b/bin/build.sh index 6d1e858..594dbeb 100755 --- a/bin/build.sh +++ b/bin/build.sh @@ -56,8 +56,8 @@ if [ ! -d ${GitLocalRoot} ]; then exit 3 fi -ProjectL=psap -ProjectU=PSAP +ProjectL=omc +ProjectU=OMC PROJECT=${ProjectL} VERSION=1.2506.2 RelDate=`date +%Y%m%d` @@ -355,7 +355,9 @@ case "${pkgtype}" in echo "Finish to make ${pkgtype} package <======" ;; psapdeb) - ProjectL="psap" + ProjectL="omc" + ProjectU="OMC" + ProjectTag="psap" echo "Begin to make ${pkgtype} package ======>" ReleasePkgDir=${ReleaseDir}/debs/${RelArch} ProcList="restagent" diff --git a/docs/quickstart/01-PSAP OMC 安装指南.md b/docs/quickstart/01-PSAP OMC 安装指南.md new file mode 100644 index 0000000..a723f86 --- /dev/null +++ b/docs/quickstart/01-PSAP OMC 安装指南.md @@ -0,0 +1,402 @@ +# PSAP OMC安装指南 + +## 1 安装环境及依赖包 + +X86_64通用服务器： + +``` +计算机或者虚拟机环境(最低配置)：CPU: 4, Memory: 8.00 GB, Disk: 500 GB +操作系统环境：Ubuntu 22.04 +数据库环境：mariadb-10.3.38-GA +安装包名称格式：psap-r1.2506.1-20250616-ub22-amd64.deb （其中: 'r1.2506.1'为版本号, '20250616'是构建日期, 'ub22'是操作系统, md64'为硬件平台名称） +``` + +麒麟arm64服务器： + +``` +计算机或者虚拟机环境(最低配置)：CPU: 2, Memory: 8.00 GB, Disk: 200 GB +操作系统环境：银河麒麟 kylin server v10 +数据库环境：mariadb-10.3.35-1.p01.ky10.aarch64 +WEB服务: nginx 1.16.1-11.p01.ky10.aarch64 +安装包名称格式：OMC-PSAP16.1.1.arm64.rpm （其中，'PSAP16.1.1'为版本号, 'arm64'为硬件平台名称） +``` + +注意事项： + +```tips +* 以下操作以银河麒麟arm64硬件平台为例 +* 全新安装方式，数据库的数据会被全部清除 +``` + +### 1.1 安装数据库 + +注意：非第一次安装或者全新安装请跳过此步骤 + +mariadb版本：mariadb-server-3:10.3.35-1.p01.ky10.aarch64 + +软件安装 + +银河麒麟OS(CentOS) + +```bash +# yum clean all +# yum makecache +# yum -y update +# yum install -y mariadb +# yum install -y mariadb-server-3:10.3.35-1.p01.ky10.aarch64 +``` + +配置修改 + +修改/etc/my.cnf.d/mariadb-server.cnf +增加或者修改如下三行： + +``` +bind-address=0.0.0.0 +port=33066 +max_connections=1000 +``` + +验证测试 + +```bash +# systemctl enable mariadb +# systemctl restart mariadb +# systemctl status mariadb +``` + +正常显示结果如下： + +```bash +[root@ems omc]# systemctl status mariadb +● mariadb.service - MariaDB 10.3.35 database server + Loaded: loaded (/usr/lib/systemd/system/mariadb.service; disabled; vendor preset: disabled) + Active: active (running) since Sun 2023-04-30 11:09:56 CST; 7h ago + Docs: man:mysqld(8) + https://mariadb.com/kb/en/library/systemd/ + Main PID: 5127 (mysqld) + Status: "Taking your SQL requests now..." + Tasks: 37 + Memory: 101.0M + CGroup: /system.slice/mariadb.service + └─5127 /usr/libexec/mysqld +``` + +修改mysql数据库root密码: + +```tips +!!!注意!!!: 修改后的密码需要更新到/usr/local/omc/etc/restconf.yaml, crontask.yaml和nbi_alarm.json等配置文件中的数据库信息配置项 +``` + +```bash +[root@ems ~]# mysql -u root +MariaDB [none]> use mysql + +MariaDB [mysql]> update user set password=PASSWORD('******') where User='root'; + +MariaDB [mysql]> flush privileges; + +MariaDB [mysql]> GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY '******' + +MariaDB [mysql]> quit +``` + +通过以下登录命令确认修改成功 + +``` +[root@ems ~]# mysql -u root -h 192.168.0.229 -P 33066 -p +Enter password: +Welcome to the MariaDB monitor. Commands end with ; or \g. +Your MariaDB connection id is 95 +Server version: 10.3.35-MariaDB MariaDB Server + +Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others. + +Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. + +MariaDB [(none)]> + +``` + +### 1.2 安装WEB服务(可选) + +注意：非第一次安装或者全新安装请跳过此步骤 + +OMC Web服务可通过nginx代理进行访问，也可不需要代理进行访问 + +WEB服务: nginx-1.16.1-11.p01.ky10.aarch64 + +* 软件安装 + +```bash +# yum clean all +# yum makecache +# yum -y update +# yum install -y nginx +``` + +* 验证测试 + +```bash +# systemctl enable nginx +# systemctl daemon-reload +# systemctl start nginx +# systemctl status nginx +● nginx.service - The nginx HTTP and reverse proxy server + Loaded: loaded (/usr/lib/systemd/system/nginx.service; disabled; vendor preset: disabled) + Active: active (running) since Tue 2023-05-02 20:57:48 CST; 3h 12min ago + Main PID: 23163 (nginx) + Tasks: 5 + Memory: 19.3M + CGroup: /system.slice/nginx.service + ├─23163 nginx: master process /usr/sbin/nginx + ├─23164 nginx: worker process + ├─23165 nginx: worker process +``` + +## 2 安装配置OMC + +### 2.1 安装OMC软件包 + +安装OMC软件包 + +```bash +# rpm -ivh OMC\ PSAP16.1.1.arm64.rpm +``` + +安装后的软件包目录树（实际目录树会随版本不同有变化，以下仅供参考）： + +```bash +# cd /usr/local +# tree omc -L 2 +omc +├── backup +├── bin +│   ├── cpsshkey.sh +│   ├── crontask +│   ├── importdb.sh +│   ├── nehosts +│   ├── omcsvc.sh +│   ├── restagent +│   └── tables.txt +├── database +├── etc +│   ├── cm +│   ├── crontask.yaml +│   ├── db +│   ├── default +│   ├── restconf.yaml +│   ├── schema +│   └── tasks.yaml +├── htdocs +│   └── front +├── license +├── log +│   ├── crontask.log -> /usr/local/omc/log/crontask.log-20230629 +│   ├── crontask.log-20230628 +│   ├── crontask.log-20230629 +│   ├── nbi_alarm +│   ├── restagent.log -> /usr/local/omc/log/restagent.log-20230629 +│   ├── restagent.log-20230628 +│   └── restagent.log-20230629 +├── software +└── upload +# +``` + +### 2.2 修改nginx服务的OMC配置(可选) + +安装软件包成功后可以根据实际环境对nginx的OMC配置进行修改，前端Web的默认侦听端口是8888，除了侦听端口，其它不用修改 + +```bash +# cd /etc/nginx/conf.d +# cat omc.conf +server { + listen 8888 default_server; + root /usr/local/omc/htdocs/front/; + index index.html index.htm; + server_name localhost; + location / { + try_files $uri $uri/ =404; + } +} +``` + +### 2.3 修改OMC Web前端配置 + +根据实际环境修改如下文件的IP地址和端口，端口需要和OMC的配置文件一致, OMC后端ipv4服务侦听端口默认为3030, ipv6的默认侦听端口为6060: + +```bash +# sudo sed -i.bak 's/192.168.2.119:/192.168.0.229:/g' /usr/local/omc/htdocs/front/config.js +``` + +### 2.4 修改OMC后端配置 + +说明： + +```tips +* 目录/usr/local/omc/etc/default下的文件是OMC程序的初始配置文件，不要修改 +* 拷贝default目录下的文件至/usr/local/omc/etc目录，根据使用环境修改配置文件 +``` + +```bash +# cd /usr/local/omc/etc +# cp default/* ../ +``` + +根据实际的运行环境对配置文件restconf.yaml, crontask.yaml, nbi_alarm.json, nbi_agent.json, 4a_agent.yaml及tasks.yaml进行修改, 特别是侦听端口和数据库配置信息(包括端口/用户/密码) + +### 2.5 数据库配置 + +注意：第一次或全新安装执行该步骤, 该步骤会清除掉原有的omc数据库 + +```bash +# /usr/local/omc/bin/importdb.sh install +``` + +升级安装执行该步骤 + +```bash +# /usr/local/omc/bin/importdb.sh upgrade +``` + +### 2.6 防火墙配置 + +如果系统默认是打开防火墙，需要添加配置文件中配置的服务和端口(端口要和实际环境配置一致)，如下： + +```bash +# firewall-cmd --add-port=33066/tcp --permanent +# firewall-cmd --add-port=8443/tcp --permanent +# firewall-cmd --add-port=8080/tcp --permanent +# firewall-cmd --add-port=4443/tcp --permanent +# firewall-cmd --add-port=8888/tcp --permanent +# firewall-cmd --add-port=3030/tcp --permanent +# firewall-cmd --add-port=4040/tcp --permanent +# firewall-cmd --add-port=5050/tcp --permanent +# firewall-cmd --add-port=6060/tcp --permanent +# firewall-cmd --add-port=31232-31271/tcp --permanent +# firewall-cmd --add-port=2222/tcp --permanent +# firewall-cmd --add-port=6379/tcp --permanent +# firewall-cmd --add-port=2152/udp --permanent +# firewall-cmd --reload +``` + +### 2.7 配置被管网元的SSH信任关系 + +为了便于OMC管理被管网元(包括登录网元，安装软件，备份配置文件和执行命令等操作), 第一次安装时需要配置被管网元与OMC的SSH信任关系，便于无密码SSH登录： + +* 修改/usr/local/omc/bin目录下的nehosts文件(******替换为明文密码), 根据现网环境增加被管网元的ip, 用户和密码信息列表 +* 运行脚本cpsshkey.sh, 将公钥拷贝至被管网元 +* 运行ssh root@192.168.4.133验证是否可以无密码登录 +* 执行成功后, 为了防止密码泄露，清除掉nehosts文件的密码信息 + +```bash +[root@ems bin]# cat nehosts +# host user password +# Example: 192.168.4.133 root password +192.168.4.133 root ****** +192.168.4.134 root ****** +[root@ems bin]# ./cpsshkey.sh +[root@ems bin]# ssh root@192.168.4.133 +``` + +## 3 启动和停止OMC + +### 3.1 系统服务启动 + +```bash +# systemctl enable restagent.service +# systemctl enable crontask.service +# systemctl enable sshsvc.service +# systemctl enable captrace.service +# systemctl daemon-reload +``` + +执行上述命令后，它被设置为作为 systemd 服务运行。 + +### 3.2 手动启动/查询/停止OMC + +您可以按如下方式启动，查询状态，停止和重新启动OMC, 以下命令可通过/usr/local/omc/bin/omcsvc.sh脚本一次性执行： + +```bash +# cd /usr/local/omc/bin +# ./omcsvc.sh start/stop/restart/status +``` + +单个OMC进程的执行命令如下, 启动/状态/停止/重启： + +```bash +# systemctl start restagent.service +# systemctl start crontask.service +# systemctl start sshsvc.service +# systemctl start captrace.service +``` + +```bash +# systemctl status restagent.service +# systemctl status crontask.service +# systemctl status sshsvc.service +# systemctl status captrace.service +``` + +```bash +# systemctl stop restagent.service +# systemctl stop crontask.service +# systemctl stop sshsvc.service +# systemctl stop captrace.service +``` + +```bash +# systemctl restart restagent.service +# systemctl restart crontask.service +# systemctl restart sshsvc.service +# systemctl restart captrace.service +``` + +## 4 问题定位跟踪 + +OMC restagent程序的配置文件在restagent.yaml，trace级别的日志通常在调试系统时使用，正常运行级别为debug，如下配置项所示： + +```yaml +logger: + file: /usr/local/omc/log/restagent.log + level: debug + duration: 24 + count: 90 +``` + +OMC crontask程序的配置文件在crontask.yaml，trace级别的日志通常在调试系统时使用，正常运行级别为debug，如下配置项所示： + +```yaml +logger: + file: /usr/local/omc/log/crontask.log + level: trace + duration: 24 + count: 90 +``` + +OMC sshsvc程序的配置文件在sshsvc.yaml，日志配置项如下所示： + +```json +logger: + file: /usr/local/omc/log/sshsvc.log + level: debug + duration: 24 + count: 30 +``` + +OMC captrace程序的配置文件在capconf.yaml，日志配置项如下所示： + +```json +logger: + file: /usr/local/omc/log/captrace.log + level: trace + duration: 24 + count: 10 +``` + +## 5 管理核心网系统 + +通过浏览器输入：[http://192.168.0.229:8888](http://192.168.0.229:8888) （nginx代理模式） + +或：http://192.168.0.229:8080 (非nginx代理模式)