genieacs 安装指南

最新推荐文章于 2024-09-13 22:28:45 发布
最新推荐文章于 2024-09-13 22:28:45 发布
阅读量5.2k 收藏 9
点赞数 1
分类专栏： TR069 文章标签： genieacs tr069服务端
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/m0_37312808/article/details/122188169
版权

genieacs官网：GenieACS

genieacs开发手册：Welcome to GenieACS’s documentation! — GenieACS Documentation 1.2.8 documentation

genieacs 论坛：GenieACS Forum - GenieACS community

（注意：可选用docker进行安装 ，这里不做介绍）

安装指南参考官网Installation Guide — GenieACS Documentation 1.2.8 documentation

安装指南

本指南用于在任何使用 systemd 作为其初始化系统的 Linux 发行版上的单个服务器上安装 GenieACS。

各种 GenieACS 服务相互独立，可以安装在不同的服务器上。 您还可以在负载平衡/故障转移设置中运行每个实例的多个实例。

注意

对于生产部署，请确保配置 TLS 并将 UI_JWT_SECRET 更改为唯一且安全的字符串。 有关如何启用 TLS 以加密流量的信息，请参阅 HTTPS 部分。

条件

Node.js

GenieACS 需要 Node.js 10.x 及更高版本。 有关说明，请参阅 Node.js。

注意：如果Node.js版本过低，则运行时会出错，n模块可能存在无法升至10.x以上，建议使用nvm模块进行升级，网上资料较多并且安装简单，可自行升级，提供传送门：NVM安装nodejs的方法_json博客-CSDN博客_nvm安装nodejs

MongoDB

GenieACS 需要 MongoDB 3.6 及更高版本。 参考MongoDB：应用数据平台| MongoDB 获取说明。

（注意：必须安装到对应的版本以上，否则运行不了）

安装GenieACS

从 NPM 安装：

sudo npm install -g genieacs@1.2.5

从源码安装

如果您更喜欢从源代码安装，例如在运行带有自定义补丁的 GenieACS 副本时，请参阅源包中的 README.md 文件。 相应地调整下面的后续步骤。

配置systemd

创建一个系统用户来运行 genieacs 守护进程

sudo useradd --system --no-create-home --user-group genieacs

创建目录以保存扩展和环境文件

我们将使用 /opt/genieacs/ext/ 目录来存储扩展脚本。

mkdir /opt/genieacs
mkdir /opt/genieacs/ext
chown genieacs:genieacs /opt/genieacs/ext

创建文件 /opt/genieacs/genieacs.env 来保存我们作为环境变量传递给 GenieACS 的配置选项。 有关所有可用配置选项的列表，请参阅环境变量部分。

GENIEACS_CWMP_ACCESS_LOG_FILE=/var/log/genieacs/genieacs-cwmp-access.log
GENIEACS_NBI_ACCESS_LOG_FILE=/var/log/genieacs/genieacs-nbi-access.log
GENIEACS_FS_ACCESS_LOG_FILE=/var/log/genieacs/genieacs-fs-access.log
GENIEACS_UI_ACCESS_LOG_FILE=/var/log/genieacs/genieacs-ui-access.log
GENIEACS_DEBUG_FILE=/var/log/genieacs/genieacs-debug.yaml
NODE_OPTIONS=--enable-source-maps
GENIEACS_EXT_DIR=/opt/genieacs/ext
GENIEACS_UI_JWT_SECRET=secret

设置文件所有权和权限：

sudo chown genieacs:genieacs /opt/genieacs/genieacs.env
sudo chmod 600 /opt/genieacs/genieacs.env

创建日志目录

mkdir /var/log/genieacs
chown genieacs:genieacs /var/log/genieacs

创建 systemd 文件

为四个 GenieACS 服务中的每一个创建一个 systemd 单元文件。 请注意，我们使用 EnvironmentFile 指令从我们之前创建的文件中读取环境变量。

每个服务都有两个日志流：访问日志和进程日志。 访问日志在此处配置为转储到 /var/log/genieacs/ 下的日志文件中，而进程日志则转到 journald。 使用 journalctl 命令查看进程日志。

注意

如果命令 systemctl edit --force --full 失败，您可以手动创建单元文件。

(注意：如果systemctl edit失败，需在/etc/systemd/system/中创建genieacs-nbi.service、genieacs-ui.service、genieacs-fs.service、genieacs-cwmp.service，并修改权限)

  1. 运行以下命令创建 genieacs-cwmp 服务：

sudo systemctl edit --force --full genieacs-cwmp

然后在编辑器中粘贴以下内容并保存：

[Unit]
Description=GenieACS CWMP
After=network.target
 
[Service]
User=genieacs
EnvironmentFile=/opt/genieacs/genieacs.env
ExecStart=/usr/bin/genieacs-cwmp
 
[Install]
WantedBy=default.target

（注意: ExecStart需修改为对应genieacs-cwmp路径，可通过命令which genieacs-cwmp查看）

  1. 运行以下命令创建 genieacs-nbi 服务：

sudo systemctl edit --force --full genieacs-nbi

然后在编辑器中粘贴以下内容并保存：

[Unit]
Description=GenieACS NBI
After=network.target
 
[Service]
User=genieacs
EnvironmentFile=/opt/genieacs/genieacs.env
ExecStart=/usr/bin/genieacs-nbi
 
[Install]
WantedBy=default.target

  1. 运行以下命令创建 genieacs-fs 服务：

sudo systemctl edit --force --full genieacs-fs

然后在编辑器中粘贴以下内容并保存：

[Unit]
Description=GenieACS FS
After=network.target
 
[Service]
User=genieacs
EnvironmentFile=/opt/genieacs/genieacs.env
ExecStart=/usr/bin/genieacs-fs
 
[Install]
WantedBy=default.target

  1. 运行以下命令创建 genieacs-ui 服务：

sudo systemctl edit --force --full genieacs-ui

然后在编辑器中粘贴以下内容并保存：

[Unit]
Description=GenieACS UI
After=network.target
 
[Service]
User=genieacs
EnvironmentFile=/opt/genieacs/genieacs.env
ExecStart=/usr/bin/genieacs-ui
 
[Install]
WantedBy=default.target

使用 logrotate 配置日志文件轮换

将以下内容另存为 /etc/logrotate.d/genieacs

/var/log/genieacs/*.log /var/log/genieacs/*.yaml {
    daily
    rotate 30
    compress
    delaycompress
    dateext
}

启用和启动服务

sudo systemctl enable genieacs-cwmp
sudo systemctl start genieacs-cwmp
sudo systemctl status genieacs-cwmp
 
sudo systemctl enable genieacs-nbi
sudo systemctl start genieacs-nbi
sudo systemctl status genieacs-nbi
 
sudo systemctl enable genieacs-fs
sudo systemctl start genieacs-fs
sudo systemctl status genieacs-fs
 
sudo systemctl enable genieacs-ui
sudo systemctl start genieacs-ui
sudo systemctl status genieacs-ui

查看每个状态消息以验证服务是否成功运行。

genieacs配置

acs认证设置

Key:cwmp.auth

Value:AUTH("cwmp","cwmp")

cpe认证设置

Key:cwmp.connectionRequestAuth

Value:AUTH("cwmpd","cwmpd")

Online设置

可以设置配置cwmp.deviceOnlineThreshold来调整超时前等待的时间。默认为 4000（以毫秒为单位）

Key:cwmp.deviceOnlineThreshold

Value:10000

会话超时设置

可以配置cwmp.deviceOnlineThreshold来调整会话超时时间

Key:cwmp.seesionTimeout

Value:"10000"

其他：

可在论坛GenieACS Forum - GenieACS community中搜索对应ACS产生的异常

genieacs基本操作

1：任务队列数，需要调用操作2才会将队列中任务发送出去

2：Commit发送数据，将1中Queued全部整合成报文在一个session中发送出去

3：搜索栏，可通过节点名称过滤节点

4：部分PRC操作

  • reboot：重启

  • reset：恢复出厂设置

  • Push file 上传文件 如固件升级

  • Delete：删除当前设备

5：Log，能查看当前设备的错误返回情况

6：部分RPC操作，操作后将会放入Queued队列中

7、12：刷新节点，通过节点后带有数字的为object，详细可查看协议或规格

  • 7为param，刷新7时，会调用getParamValue刷新当前值

  • 12位object，刷新12时，会先调用getParamName获取PortMapping下所有的{i}节点名称，如PortMapping.1. PortMapping.2. ……PortMapping.n.等，当前仅存在PortMapping.1. 然后再调用getParamValue获取其子节点值

详细可通过wireshark抓包查看

8：当param中属性rw=1，可写入时，ACS会生成此图标，可通过调用setParamName设置CPE参数值

9：当object中属性rw=1，可写入时，ACS会生成此图标，可通过调用addObject添加CPE object实例值

10：当object中属性rw=1，可写入时，ACS会生成此图标，可通过调用delObject删除CPE object实例值

11：清空队列Queued

genieacs配置更改

配置为systemctl edit --force --full genieacs-*中

EnvironmentFile=/opt/genieacs/genieacs.env

配置中参数设置参考Environment Variables — GenieACS Documentation 1.2.8 documentation

服务开启

sudo systemctl enable genieacs-cwmp
sudo systemctl enable genieacs-nbi
sudo systemctl enable genieacs-fs
sudo systemctl enable genieacs-ui

服务开始

sudo systemctl start genieacs-cwmp
sudo systemctl start genieacs-nbi
sudo systemctl start genieacs-fs
sudo systemctl start genieacs-ui

服务停止

sudo systemctl stop genieacs-cwmp
sudo systemctl stop genieacs-nbi
sudo systemctl stop genieacs-fs
sudo systemctl stop genieacs-ui

服务状态查询

sudo systemctl status genieacs-cwmp
sudo systemctl status genieacs-nbi
sudo systemctl status genieacs-fs
sudo systemctl status genieacs-ui

安装过程遇到的问题：

由于安装使用的是genieacs账户，当在root时，nodejs的版本是最新的，但在genieacs账号中node指令可能仍然是低版本

解决方法1：

1.切换至genieacs查看node的路径

2.并将更新好的node14.17.1 软链接到node中

genieacs@ubuntu:/xx$ node --version
v8.17.0

genieacs@ubuntu:/xx$ which node
/usr/local/bin/node

genieacs@ubuntu:/xx$ su
root@ubuntu:/xx$

root@ubuntu:/xx$ cd /usr/local/bin/
root@ubuntu:/usr/local/bin$

root@ubuntu:/usr/local/bin$ find / -name "node"
……
/usr/bin/node
/usr/local/bin/node
/usr/local/share/doc/node
/usr/local/n/versions/node
/usr/local/n/versions/node/8.17.0/bin/node
/usr/local/n/versions/node/8.17.0/share/doc/node
/usr/local/n/versions/node/8.17.0/include/node
/home/ecos/.nvm/versions/node
/home/ecos/.nvm/versions/node/v14.17.1/bin/node
/home/ecos/.nvm/versions/node/v14.17.1/share/doc/node
/home/ecos/.nvm/versions/node/v14.17.1/include/node
/home/ecos/.nvm/.cache/src/node-v14.17.1/files/node
/home/ecos/.nvm/.cache/src/node-v14.17.1/files/deps/v8/tools/node
……

root@ubuntu:/usr/local/bin# sudo ln -s /home/ecos/.nvm/versions/node/v14.17.1/bin/node ./node

GenieACS使用教程
m0_61806534的博客
01-15 383
成功登录网站后，就可以通过网站对cpe下发命令了。
GenieACS的安装与使用
m0_61806534的博客
01-13 157
安装完后，记得确认一下版本(我使用的版本是v18.20.5、10.8.2）GenieACS 要求 Node.js 12.13 或者更高版本(一定要记得！
genieacs, 一个快速轻量的TR 069自动配置服务器( ACS ).zip
10-10
genieacs, 一个快速轻量的TR 069自动配置服务器( ACS ) GenieACSGenieACS是一个快速且轻量级的TR-069 自动配置服务器( ACS ) 。 这是核心后端组件。 一个GUI前端在 https://github.com/zaidka/genieacs-gui 可用。特性规模
GenieACS 安装与使用指南
gitblog_00004的博客
04-04 483
GenieACS 安装与使用指南 genieacs A fast and lightweight TR-069 Auto Configuration Server (ACS) 项目地址: https://gitcode.com/gh_mirrors/ge/geni...
GenieACS 安装和配置指南
gitblog_07347的博客
09-13 1004
GenieACS 安装和配置指南 genieacs A fast and lightweight TR-069 Auto Configuration Server (ACS) 项目地址: https://gitcode.com/g...
GenieACS 开源项目安装与使用指南
gitblog_00965的博客
08-15 1184
GenieACS 开源项目安装与使用指南 项目地址:https://gitcode.com/gh_mirrors/ge/genieacs 1. 项目目录结构及介绍 GenieACS 是一个高效的TR-069自动配置服务器(ACS)，专为远程设备管理设计。以下是其基本的目录结构概述： genieacs/ ├── bin # 存放可执行脚本和服务入口 │ ...
Genie acs的搭建及使用
caterLi的博客
09-29 8571
GENIE ACS 搭建指南及常见错误，并添加使用方法
genieacs-安装脚本_genieacs-master_GenieACSwiki_GenieACS_genieacs安装_G
10-03
`GenieACSwiki`则指向了项目的官方维基文档，那里可以找到详细的安装指南和用户手册。 安装GenieACS的过程中，首先需要下载`genieacs-master`压缩包。这个压缩包包含了源代码、必要的配置文件以及安装脚本。解压后...
Ubuntu16 安装GenieACS（TR069）服务器预配置指导
Shelly的博客
03-20 6499
1. 安装GenieACS服务器所需要的依赖包及数据库等 sudo apt-get update sudo apt-get upgrade sudo apt-get install git #安装git sudo apt-get install redis-server mongodb npm build-essential ruby-bundler ruby-dev libsqlite3-de...
GenieACS一键安装脚本：快速搭建ACS服务器
在实际操作过程中，用户应当参考GenieACS官方文档或wiki，以获取最准确和最新的安装指导，因为软件、依赖包和操作系统本身都可能不断更新。此外，安装脚本可能会根据不同的操作系统版本和环境变量有所差异，因此需要...
GenieACS:使用GenieACS通过balenaCloud网关管理设备
03-07
这些模型是根据你的设备规格和需求定制的，用于指导GenieACS如何与设备交互。 4. **连接设备**: 设备上线后，它们会自动连接到balenaCloud，并通过balenaCloud与GenieACS建立安全连接。GenieACS会识别设备，并应用...
genieacs:快速轻巧的TR-069自动配置服务器（ACS）
04-29
GenieACS GenieACS是用于对启用TR-069的设备进行远程管理的高性能自动配置服务器（ACS）。 它利用声明性和容错配置引擎来大规模自动化复杂的配置方案。 经过实践检验，它可以处理数十万甚至数十万个并发设备。 快速开始 安装和 。 请参阅其相应的文档以获取安装说明。 支持的版本是： Node.js：12.3以上 MongoDB：3.6以上 从NPM安装GenieACS： sudo npm install -g genieacs 要从源代码构建，请克隆此仓库或下载源归档文件，然后将cd插入源目录，然后运行： npm install npm run build 最后，运行以下服务（如果从源代码构建，则位于./dist/bin/下）： genieacs-cwmp 这是CPE将与之通信的服务。 默认情况下，它在端口7547上侦听。 相应地在设备中配置ACS URL。 如果
ACS安装配置实验手册
11-14
ACS已经安装在服务器上，ACS的IP地址为11.156.198.200。安装完后会在桌面产生一个ACS管理页面。 点击即可登录进ACS进行管理操作。如：配置管理员帐号，数据库管理等等。
ubuntu部署genieacs
lj8373的博客
08-02 1342
Ubuntu搭建genieacs服务器
GenieACS 开源项目教程
gitblog_00813的博客
08-15 1100
GenieACS 开源项目教程 项目地址:https://gitcode.com/gh_mirrors/ge/genieacs 项目介绍 GenieACS 是一个开源的 TR-069 远程管理解决方案，具有高级设备配置功能。它是一个快速且轻量级的自动配置服务器（ACS），用于对启用 TR-069 的设备进行远程管理。GenieACS 利用声明性和容错配置引擎来大规模自动化复杂的配置方案，经过实践检...
使用genieacs -- TR069模糊查询设备信息
ajiejie66的博客
01-24 705
使用genieacs -- TR069模糊查询设备信息 http://localhost:7557/devices/?query={"_id": "*202BC1-BM632w-000000*"} 注意在查询字段前后加上星号 * 即可 结果
GenieACS-GUI 安装与使用教程
gitblog_00811的博客
09-05 456
GenieACS-GUI 安装与使用教程 genieacs-guiA GUI front end for GenieACS built with Ruby on Rails.项目地址:https://gitcode.com/gh_mirrors/ge/genieacs-gui 1. 项目的目录结构及介绍 GenieACS-GUI 是一个基于 Ruby on Rails 构建的前端组件，用于 Ge...
嵌入式八股文面试题库资料知识宝典-华为的面试试题.zip
最新发布
04-27
嵌入式八股文面试题库资料知识宝典-华为的面试试题.zip
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值