TURNKEYGNU / LINUX
中文

文档

观测站

本文件页提供与《公约》第2条有关的资料。 TurnKey Linux Observium 应用设备。当前这个doc的版本是专门用TurnKey版本18x来写成的,但应该与较新的版本保持兼容.

请通过网站提供与该网页有关的反馈意见和/或问题。 TurnKey 论坛 (需要免费 TurnKey Lnux 网站用户账户)。或者可以通过我们报告文档错误 合并的 TurnKey Linux 问题跟踪器.

已知的发行量 : “ 无法通过网络手动添加设备, 无法调用 < hostname> ”

如TurnKey Linux合并说明的 问题跟踪器但是,正如上文(a)段所指出的,这个问题如果需要,是可以解决的。 注释 )上游观测站的文档建议您不要这样做,因为安全性影响;而是使用CLI来添加设备。所以,这取决于您...

更新观测站

所有这些更新指示都是根据官方 高级更新文档。这里还具体提到与《公约》有关的进一步细节。 TurnKey Observium 应用设备无论如何,你不妨也查阅正式文件页,特别是如果您 升级到订阅版.

目录:

启动前; 备份 !

自动备份制度(例如使用 TKLBAM 密码) 总是应该为包含您所关心的数据的任何系统配置。系统数据丢失总是与何时,而不是是否发生有关。 观测站升级过程预计会顺利进行,因此近期的备份可能足够了. 无论如何,总是建议在软件升级之前立即进行人工备份。

下面记录的 Observium 升级进程保存您旧的 Observium 文件副本。 但是它没有保存您原始数据库的副本 。 没有合适的备份,如果出错,你可能无法回滚到上一个版本. 备份没有同等重要的唯一情景是,您只设置了您的 Observatium 服务器,而没有现有的数据 。 即使这样,如果出了问题,需要后退,一个备份仍然可以节省你的时间.

AWS 市场用户的重要说明

大多数 TurnKey 服务器默认使用“ root” 用户。 如果是您, 请读 。 对于使用 TurnKey 从 AWS 市场推出的用户, 它们默认为“ admin” 用户 。 因此,在这些指令生效之前,你需要切换到“ root” 用户。你可以用“ sudo” 来前置每个命令, 但这是很痛苦的 。 我建议为这个过程向“ root” 用户吸附。 您可以这样做 :

sudo su -

完成后,通过发布"退出"命令,切换回"admin"用户.

使用更新脚本更新 Observatium CE

备份您的系统

执行手册 备份 上文已指出,

通过 turnkey 更新 - 观测站的脚本 - 包含在 TurnKey 观测站 应用设备 中

此脚本将手动更新指令自动化, 并创建一个 Observium 文件的本地备份( /opt/observium).) 脚本以 BASH 写成, 包含在您的服务器上的版本来源可以在 /usr/local/bin/turnkey-update-observium 或 查看 GitHub 上的最新源代码.

要运行 CLI 的脚本 :

turnkey-update-observium

迄今为止,虽然没有关于错误或问题的报告,但对这一更新脚本的反馈有限。 但由于剧本运行时反馈有限,报告"实验性",尽管如此,它应该可靠(见下文注). 根据任何更新或重大配置变化,总是建议您有备份(例如. TKLBAM 密码以防出事了 万一你发现什么了

运行脚本时已注意到 :

注意此脚本将从TurnKey 应用设备构建时间创建的数据中检查当前版本. 如果Observium已经通过替代方法更新(或者文件不存在),它将总是会下载和"更新"到最新的Observium CE(社区版). 它会做到这一点,即使你已经运行了最新的CE版本;或者已经通过一个替代通道安装了!

手动更新 Observatory CE

这些指示的依据是: 官方观测站 CE 更新文件 - 具体涉及下列事项: TurnKey Linux Observium 应用设备。所有命令都应作为根用户从命令行运行。

备份您的系统

执行手册 备份 上文已指出,

禁用 Observatium cronjob( 可选的)

Cron 工作是按进度运行的自动化任务。 通常 Cron 工作与 Observatium “ 保持室” 有关。 取消 cron 工作是可选的 。 但是,如果你不这样做,你可能会在日志中注意到一些 cron 错误。如果您真的禁用 cron 任务, 请确保您也注意 可重新启用 更新后(这些指示后面涉及的重新调整工作)。

要禁用 Observer cron 任务 :

或手动编辑 cron 文件 - /etc/cron.d/observium - 并注释所有活动的 cron 线条。 I. e. 在每行中添加一个“ # ” 字符, 字符开头没有“ # ” 。 如果您没有经历此过程,建议您在每个行中添加一个"#"(所以所有现有的注释都用"□"前缀).

或者从命令线上运行下面的喷雾器命令。 请注意, 此命令会在 cron 文件的每行中添加一个“ # ” 。 此命令不是一元命令, 所以 。 NOT 密码 运行多次 ! 如果您做了, 您需要手动编辑 cron 文件以解压缩 cron 线, 并留下“ #” 前缀 。

sed -i "s|^|#|" /etc/cron.d/observium

用新版本替换旧文件

以下命令将当前 Observium 文件移出 , 下载最新版本, 然后复制所需的文件( 配置文件和 rdd & 日志目录) 由您最初安装的观测站中安装。

运行以下命令( 作为根) :

cd /opt
mv observium observium_old
wget -Oobservium-community-latest.tar.gz https://www.observium.org/observium-community-latest.tar.gz
tar zxvf observium-community-latest.tar.gz
mv /opt/observium_old/rrd observium/
mv /opt/observium_old/logs observium/
mv /opt/observium_old/config.php observium/

更新 DB 方案

更新新版本的 DB 方案 :

/opt/observium/discovery.php -u

强制重发现( 可选)

如果你更新了很久(12个月或更长), 你可能会想迫使所有设备立即重新发现,

/opt/observium/discovery.php -h all

可复用的观察室 cronjobs(可选)

重新启用 cron 工作需要先先先禁用, 然后再更新 Observion 。 如果您跳过初始步骤, 请确保您这样做 NOT 密码 跟着这步走,直接跳到下一节

要手动重新启用 cron 任务, 请将上方的禁用 cron 任务部分所完成的进程反转 。 解析 Observium cron 文件中的 cron 命令行 - /etc/cron.d/observium 。

使用上述的涂鸦作业,您可通过上面提到的涂鸦作业,在上面的涂鸦作业中,您可以使用下面的涂鸦作业,重新使用。 它会从每行中删除( 首) 领导“ #” 字符。 do NOT 密码 这样做,除非您使用前一个 sed 命令来解除 cron 任务。 根据前一个 sed 命令, 它不是 idemacent, 所以 NOT 密码 运行它不止一次 ! 如果您这样做, 您需要手动编辑 cron 文件以评论 cron 任务中的有意评论行( 添加“ # ” 以表示) 。

sed -i "s|^#||" /etc/cron.d/observium

最后清理( 可选)

一旦您确认更新工作如预期的那样有效, 您现在可以删除在以上文件更新过程中创建的 Observatium 文件。 I. e. 删除旧目录:

rm -rf /opt/observium_old

更新 Observium CE 到 Observium Pro/Enterprise 版

这些指示的依据是: 官方观测站 CE - > 观测站 Pro Docs - 具体涉及下列事项: TurnKey Linux Observium 应用设备。它们既与Pro 也与企业订阅版本相关。所有命令都应该从命令行中运行,作为根用户-这么多TurnKey用户都很好。 AWS 采购网用户需要 切换到根用户 首先,我说:

sudo su -

如相关观察文件页所述:

观测站的设计容易升级,而且可以无缝地迁移,使用户能够从社区版顺利过渡到专业版或 企业报版.

备份您的系统

执行手册 备份 上文已指出,

安装颠覆

Observium订阅版通过SVN(subversion)版本控制系统提供初始安装代码和未来更新. TurnKey Observium 应用设备 默认不包括所需的颠覆软件,然而它可以通过apt(作为根用户)很容易安装:

apt update
apt install subversion

禁用 Observatium cron 任务( 建议)

Cron工作是按时间表运行的自动化任务,一般cron工作与Observium"house keeping"有关,尽管包含其他功能. 推荐在升级期间取消cron工作,尽管严格来说是可选的。 不过 如果在代码检查过程中或移动 rdd 目录时, Observatorium 传票人(被 cron 任务触发) 运行, 可能会产生意想不到的后果 。 如果您真的禁用 cron 工作, 请确保您也禁用 可重新启用 更新后(这些指示稍后部分将涵盖重新授权的 cron 工作)。

要禁用 Observer cron 任务 :

要么手动编辑 cron 文件 - /etc/cron.d/observium - 并注释所有 cron 工作行。 I. e. 在每 cron 工作行的开始添加一个“ # ” 字符 。 建议您在每行中添加一个“ # ” 。 这意味着现有的有意评论会前缀为"□",使重新赋能更可靠,更不会容易出错.

或者您可以通过命令行运行下面的 sed 命令 。 请注意,此命令会在 cron 文件中的每行添加一个"#"(按照手动指令中的建议). 此 sed 命令不是 idemptent - 表示重运行此脚本将会导致额外的更改 。 NOT 密码 运行不止一次 ! 如果您做了, 您需要手动修正/ 编辑 cron 文件才能重新启用 cron 任务 。

sed -i "s|^|#|" /etc/cron.d/observium

迁移到 SVN 仓库代码 - 用 SVN 版本替换旧文件

要迁移到 SVN 寄存器寄存码, 您需要检查代码的新副本, 并将您现有的配置 php 和 rd 目录 转移到新副本 。

下面的命令会安装稳定列车。如果您喜欢使用滚动列车,请将第三命令中的分支/稳定替换为干线。 详见观察文献.

在以下更新过程中,您会被提示使用用户名和密码。这些证书可在 观测订阅门户.

以下命令将当前 Observium 文件移出, 通过 SVN 版本下载 Observium 的最新稳定订阅版本, 然后复制回 需要从 Observium 安装的文件(配置文件和 rdd & 日志目录) 。

cd /opt
mv observium observium-old
svn co https://svn.observium.org/svn/observium/branches/stable observium
cp observium-old/config.php observium
mv observium-old/rrd observium-old/logs observium
cd observium
./discovery.php -u

可重新启用的观察中心工作(建议----如果以上为残疾,则需要)

如果您在 Observatory 升级前已禁用, 则需要重新启用 cron 工作。 如果您跳过该初始步骤, 请确保您这样做 。 NOT 密码 跟着这步走,直接跳到下一节

要手动重新启用 cron 任务, 请将 以上 的 禁用 cron 任务 所完成的进程倒置 。 从 Observium cron 文件 - /etc/cron.d/observium 中每行开头的起始处删除“#”(有意评论除外).

如果您通过上面初始禁用 cron 工作步骤中注明的 sed 命令来禁用 cron 工作, 您可以使用下面的 sed 线重新启用 。 它会从每行中删除( 首) 领导“ #” 字符。 do NOT 密码 这样做 除非是说 您使用上一个 sed 命令来解析 crun 任务。 根据上一个 sed 命令, 此命令不是一元命令, 如果运行不止一次, 将会作出额外的更改 。 也一样 NOT 密码 运行多次 ! 如果您做了, 您需要手动编辑/ 固定 cron 文件, 从而导致有意的评论被前缀为“ # ” 。

sed -i "s|^#||" /etc/cron.d/observium

需要的话, 默认 TurnKey 观测站 cron 文件 如果您需要修改您的 cron 文件, 可以咨询 。

最后清理( 可选)

一旦您确认迁移升级工作如预期的那样有效, 您现在可以删除上述升级过程中创建的旧 Observation 文档。 I. e. 删除旧目录:

rm -rf /opt/observium_old

将订阅版升级到最新版本

操作程序必须使用此程序, 前提是您已经将 Observatory 升级为 订阅版.

备份您的系统

开始前, 执行手动操作 备份 上文已指出,

禁用 cron 任务( 可选但推荐)

禁用 Observatium cron 任务 上文已说明。

更新到最新稳定版本

使用 SVN 更新 Observatory 的订阅版很简单。 要将 Observatory 订阅版升级到最新的稳定发行, 请使用以下命令 :

cd /opt/observium
svn update
./discovery.php -u

备选/附加观测站Pro/企业升级选项

请注意,webapp软件一般不支持降级到之前的版本. 我无法证实观察组织的情况,但是如果你坚持拇指规则,你就不会遇到问题。所以,创建一个手册。 备份 如上文所述,总是建议并视为最佳做法。

更新特定修订版的 Observium 订阅版

与其更新到最新稳定状态,不如升级到特定修订,即在稳定发布时间段的某个特定位置. 将观测站升级为特定修改,与该程序及命令非常相似。 升级 。但是,“svn 更新”命令附加了“-r < revision number>”。

svn update -r <revision number>

例如,假设您想要安装/升级版本0.12.4.3049. SVN版本是最后一个数字,所以运行如下:

svn update -r 3049

请看外观 观测订阅版升级文件 更多选择和细节。