miosiris/unis

Periscope：统一网络信息服务（UNIS）

Periscope包含对标准PerfSONAR网络监控schema的扩展集，以及客户端监控组件、拓扑和数据存储。Periscope组件收集的信息通过层级部署的UNIS和测量存储（MS）实例进行维护。本容器运行UNIS服务器守护进程实例。

UNIS API文档可参考此处。

核心功能

1. 存储与管理网络监控数据
2. 支持层级部署的UNIS实例架构
3. 提供标准化API接口用于数据访问
4. 可自定义配置与外部数据库集成

使用场景

• 网络监控系统的数据持久化存储
• 多节点网络环境下的信息同步与共享
• 网络运维中的数据查询与分析支持

配置说明

UNIS服务器会在/etc/periscope/unis.cfg查找配置文件。容器中包含默认配置，可通过挂载/etc/periscope卷覆盖默认配置。服务监听8888端口。

配置文件示例：

[unis]
#url    = ; 自身端点
#ms_url = ; 测量存储端点
               
# root_urls是逗号分隔的“父”实例列表
root_urls = http://unis.open.sice.indiana.edu:8888
# 推送到根实例的逗号分隔社区字符串列表
communities = OSIRIS,SLATE

#db_name    = unis_db                  ; 数据库名称
#db_host    = 127.0.0.1                ; 数据库主机（如MongoDB）
#db_port    = 27017                    ; 数据库端口

#summary_size              = 10
#summary_collection_period = 3600      ; 汇总间隔（秒）

use_ms      = false                    ; 启用MS注册

[unis_ssl]
#enable     = false                    ; 启用SSL连接
#ssl_cert   =                          ; SSL证书文件
#ssl_key    =                          ; SSL密钥文件
#ssl_cafile =                          ; SSL CA文件

[auth]
#enabled    = false                    ; 对请求启用认证

MongoDB注意事项

UNIS服务依赖MongoDB提供NoSQL对象数据库。DB文件可存储在容器overlayfs中，但停止或重启容器（未先提交）可能导致服务数据丢失。建议挂载独立的DB卷以实现持久化存储，MongoDB默认将/var/lib/mongodb作为备份目录。

使用Docker模块的Puppet配置

以下是Puppet代码片段，可用于在主机网络上实例化UNIS容器并配置常见选项：

  $confdir = '/data/periscope'
  $dbdir   = '/data/mongodb'

	docker::run { 'unis':
          image            => 'miosiris/unis',
          net              => 'host',
          extra_parameters => [ '--name unis' ],
          volumes          => [ "${confdir}:${confdir}", "${dbdir}:${dbdir}" ],
          systemd_restart  => 'on-failure',
          hostname         => 'unis',
          privileged       => true,
          pull_on_start    => true
	}

Docker环境变量

没有环境变量影响UNIS服务的执行，需通过配置文件修改设置。