iTopCN – 安装/升级 iTop

Docs: 安装您的第一个 iTop

Fri, 27 Jun 2025 00:00:00 +0000

本文档介绍如何安装您的第一个 iTop 实例。iTop 的安装过程与许多基于 PHP 的应用程序类似。更多详细内容请参考 iTop 官方文档。

安装您的第一个 iTop

下载和安装

iTop 的安装与许多基于 PHP 的应用程序类似：

从 Sourceforge 下载 iTop 安装包
检查安装先决条件
适当调整 PHP 和 MySQL 设置
启动安装向导
然后通过配置后台任务完成安装

实施部署

在您的用户可以开始在生产环境中使用 iTop 之前：

阅读用户账户和配置文件，并确定您将使用哪种认证类型
阅读实施指南并设置服务目录、客户合同等
通过配置电子邮件通知和适当的邮件传输来完成安装
调整配置以微调性能
做好数据备份的准备

原文：https://www.itophub.io/wiki/page?id=3_2_0:gettingstarted

版本：3_2_0/gettingstarted.txt · Last modified: 2024/09/10 10:25 by 127.0.0.1

Docs: 硬件和软件要求

Fri, 27 Jun 2025 00:00:00 +0000

本文档介绍 iTop 的硬件和软件要求，包括兼容性列表和浏览器支持。更多详细内容请参考 iTop 官方文档。

最低硬件要求

您的需求	我们的建议
每月创建工单数	控制台用户
<200	< 20
< 5000	< 50
> 5000	> 50

使用 iTop 的最低屏幕分辨率为 1024*768 像素，但分辨率越高越好。

我们建议使用运行 Debian 12 或 Ubuntu 24.04 LTS 的虚拟机。

iTop 兼容性列表

iTop	最低要求 → 最高支持	已知限制
	PHP	MySQL
2.3.x	5.3.6	5.0
2.4.x	5.3.6	5.5.3
2.5.x	5.3.6	5.5.3
2.6.0 / 2.6.1+	5.6 → 7.2 / 5.6 → 7.3	5.6
2.7.x / 2.7.7 - 2.7.8	7.0.8 → 7.4 / 7.1.3 → 7.4	5.6 → 5.7
2.7.9+	7.1.3 → 7.4	5.6 → 5.7
3.0.x / 3.0.2	7.1.3 → 7.4 / 7.1.3 → 8.0	5.7+
3.1.x	7.4 → 8.1	5.7+
3.2.x	8.1 → 8.3	5.7+
3.2.3-1	8.1 → 8.4	5.7+
3.3.x	8.2 → 8.4	5.7+

图例：

粗体：自上一版本以来最低或最高版本发生变化时
斜体：最高支持版本，当已知时

Web 浏览器

推荐使用最新版本的 Chrome（Firefox 也很安全）。

自 2.7.0 起，不再支持 IE9
自 3.0.0 起，不再支持 IE11
后续版本的 iTop 将不再支持任何 Internet Explorer 版本
Brave 与 iTop 有已知的兼容性问题
Safari 不受 Combodo 支持，但我们知道有人在使用它，报告的问题很少。

Web 服务器

配置您的 Web 服务器

Apache Httpd：iTop 包包含 Apache Httpd 的内置配置（.htaccess 文件）。在此处阅读更多：iTop 和 Apache HTTPD
Microsoft IIS：iTop 包包含 Microsoft IIS 的内置配置（web.config 文件）。在此处阅读更多：iTop 和 IIS
NGINX：要正确配置 NGINX，请查看此专用页面：iTop 和 NGINX
Suhosin：iTop 和 Suhosin
SELinux：iTop 和 SE Linux

GraphViz

iTop 依赖 Graphviz 来生成对象生命周期的图形表示以及影响分析图。

在 Linux 上，graphviz 已经是上述先决条件的一部分，因此无需额外操作。
在 Windows 上：从网站下载 Graphviz 并安装。
Linux：/user/bin/dot
Windows：C:\Program files (x86)\Graphviz 2.68\bin\dot.exe

数据库服务器

要选择数据库版本，请查看 MariaDB 各版本发布说明和 MySQL 文档

MariaDB 与 iTop 备份的不兼容性

以下版本的 MariaDB 会导致 iTop 备份无法工作：

10.5.x	10.4.x	10.3.x	10.2.x
10.5.7	10.4.16	10.3.26	10.2.35
10.5.8	10.4.17	10.3.27	10.2.36

症状：

当您执行此查询时：

MariaDB [sbacmdb]> select * from view_DBServer;

您会收到此错误：

Error: Failed to execute mysqldump: mysqldump: Couldn't execute 'show create table `view_DBServer`': You have an error in your SQL syntax; check the manual that corresponds to your MariaDB server version for the right syntax to use near '= 0 and `SoftwareLicence_softwarelicence_id_Licence`.`end_date` < date_format...' at line 1 (1064)

根本原因：这是一个 MariaDB 问题，在以下次要版本中已修复。

策略：避免这些有问题的 MariaDB 版本。降级到不受影响的版本或升级到已修复的版本：

10.5.9	10.4.18	10.3.28	10.2.37

变通方法：

在备份前删除视图，视图不是 iTop 本身所需的。
注意，安装程序会重新创建视图，因此之后需要再次删除它们。

视图将在 3.0 中完全移除，对于仍在使用它们的人，将提供一个可选的免费扩展。

原文：https://www.itophub.io/wiki/page?id=3_2_0:install:requirements

版本：3_2_0/install/requirements.txt · Last modified: 2026/06/11 16:17 by 127.0.0.1

Docs: 安装 PHP、Web 服务器和数据库...

Fri, 27 Jun 2025 00:00:00 +0000

本文档介绍如何在不同操作系统上安装 iTop 所需的 PHP、Web 服务器和数据库软件。更多详细内容请参考 iTop 官方文档。

Debian 或 Ubuntu

要在 Ubuntu/Debian 上安装所需软件，请运行以下命令（以 root 身份）：

apt-get install apache2
apt-get install mariadb-server
apt-get install php php-mysql php-ldap php-cli php-soap php-json graphviz
apt-get install php-xml php-gd php-zip libapache2-mod-php php-mbstring php-curl

apt-get install apache2
apt-get install mysql-server
apt-get install php php-mysql php-ldap php-cli php-soap php-json graphviz
apt-get install php-xml php-gd php-zip libapache2-mod-php php-mbstring php-curl

这将安装 Ubuntu/Debian 默认仓库中对应的版本。

RedHat、CentOS 或 Fedora

要在 RedHat / CentOS / Fedora 上安装所需软件，请运行以下命令（以 root 身份）：

yum install httpd
yum install mysql mysql-server
yum install php php-mysql php-xml php-cli php-soap php-ldap php-gd php-zip php-json php-mbstring php-curl graphviz

Windows

在 IIS 上安装 PHP

请查看此页面：iTop 和 IIS

安装 MySQL

如果您还没有 MySQL 数据库服务器，可以将其安装在与应用程序相同的系统上。

访问 MySQL 下载站点：http://www.mysql.com/downloads/mysql/
下载适合您系统的安装程序：选择名为 “MSI Installer” 的安装包，32 位或 64 位版本均可。
通过打开下载的 .msi 文件启动安装。
按照安装向导的说明进行操作。

Windows 上使用 easyPHP 的开发环境

请参见 iTop 在 Windows 上使用 easyPHP 安装

原文：https://www.itophub.io/wiki/page?id=3_2_0:install:install_guides

版本：3_2_0/install/install_guides.txt · Last modified: 2025/07/11 16:22 by 127.0.0.1

Docs: 配置 PHP、Web 服务器和数据库...

Fri, 27 Jun 2025 00:00:00 +0000

本文档介绍 iTop 所需的 PHP、Web 服务器和数据库服务器配置。更多详细内容请参考 iTop 官方文档。

Web 服务器

允许将 OQL 查询作为参数传递

在 iTop 中，许多页面会将 OQL 查询作为参数发送。这是无风险的，因为查询在发送给数据库服务器之前，会先由 iTop 进行解释和定制，并转换为单一的只读 SQL 查询。

换句话说，对于任何查询，iTop 都会：

检查语法和类的有效性
根据用户权限添加适当的过滤器
防止注入攻击

由于 OQL 语法与 SQL 接近，这可能会被 mod_security 等安全系统阻止。您必须允许这些查询才能使用 iTop。例如，使用 mod_security：

SecRule REQUEST_URI "@beginsWith /pages/UI.php" \
"id:'000013', \
phase:1, \
t:none, \
nolog, \
pass, \
ctl:ruleRemoveById=942190, \
ctl:ruleRemoveById=942360" \

SecRule REQUEST_URI "@beginsWith /pages/ajax.render.php" \
"id:'000013', \
phase:1, \
t:none, \
nolog, \
pass, \
ctl:ruleRemoveById=942190, \
ctl:ruleRemoveById=942360, \
ctl:ruleRemoveById=949110, \
ctl:ruleRemoveById=980130, \
ctl:ruleRemoveById=920220, \
ctl:ruleRemoveById=942100"

临时目录的写入权限

确保 Web 服务器对临时目录具有写入权限。

APCu

我们强烈建议启用 APCu！有关更多详细信息，请阅读优化 iTop 性能。

但是，如果您在多个实例上使用 APCu，在执行"移至生产环境"后，必须在所有实例上清除缓存。由于我们没有工具来执行此操作，实际上这意味着：

要么重启所有 Web 服务器
要么不使用 APCu

数据库客户端模块

如果您的 iTop 数据库位于与 Web 服务器不同的外部服务器上，您需要在 Web 服务器上安装 MariaDB（或 MySQL）的客户端安装包。

PHP

必需扩展

其他 PHP 扩展

php-gd 是使用 CKEditor 添加图像以及自动调整 HTML 字段中图像大小所必需的。
PHP LDAP 模块是支持 LDAP 或 Active Directory 认证所必需的。
加密数据：请查看加密数据以了解需要安装什么才能使用 EncryptedString 属性。

php.ini 设置

php.ini 中的推荐值摘要：

memory_limit = 256M ; 如有需要可以增加
max_input_vars = 5000

; upload_tmp_dir : 应指向一个具有写入权限的目录

; 还要检查以下用于附件的选项（请参阅下面的专用章节）
; 根据您的偏好调整值！
; - upload_max_filesize
; - max_file_uploads
; - post_max_size
; - max_input_time

max_input_vars

在各种使用场景中，iTop 会向服务器发送大量数据。特别是某些 XHR 查询会发送当前对象结构的描述：属性列表及所有相应属性。如果您的数据模型在对象上添加了大量属性，您可能会在这些屏幕之一上遇到错误行为：

编辑具有许多关系的对象时（iTop 会创建一个包含所有关系的大表单）
在对象列表中：在"配置此列表"对话框中勾选大量属性后，点击列标题对列表排序
点击列标题对列表排序
在"配置此列表"对话框中勾选大量属性后

此类行为可能由 Web 服务器引起：php.ini 中的参数 max_input_vars 定义了发送到服务器的最大数据量。其默认值为 1000，对于具有许多字段的自定义对象可能不够。如果您遇到此类行为，可以将 max_input_vars 值从 1000 更新为 3000 或 5000，具体取决于需要传输的数据量。

附件上传

iTop 能够上传和存储文档（即文件）作为各种对象（工单、CI 等）的附件。这些文档以二进制大对象的形式存储在 iTop 数据库中。为了安全地上传和存储文档，必须在 PHP 和 MySQL 中一致地调整多个设置。

在 PHP 中，几个变量控制文件上传：

参数	说明
`file_uploads`	设置为 1 允许文件上传，设置为 0 阻止所有文件上传。
`upload_tmp_dir`	服务器上存储上传文件的临时位置。确保此参数指向运行 Web 服务器的进程（或在 IIS 使用 Windows 内置认证的情况下，最终用户）可以访问（和写入）的位置，并且有足够的剩余空间。
`upload_max_filesize`	允许上传的文件的最大大小。值以字节表示。您可以使用 K 表示千字节（=1024 字节）、M 表示兆字节、G 表示千兆字节。例如：4M 表示 4 兆字节。
`max_file_uploads`	单个网页中可同时上传的最大文件数。iTop 通常一次只上传一个文件。您可以安全地使用默认值 20。
`post_max_size`	通过 POST 请求发送到服务器的最大数据量。此值必须大于 `upload_max_filesize`，因为同一请求将包含一些额外信息（文档标题、操作代码…）。因此最好在这里设置更大的值。例如，如果 `upload_max_filesize` 是 4M，那么 `post_max_size` 设置为 5M。
`memory_limit`	文件上传到服务器后，将在存储到数据库之前读入内存。因此，请确保 `memory_limit`（如果启用）至少是 `upload_max_filesize` 的 5 倍。
`max_input_time`	此值定义服务器读取输入的最大允许时间。这包括上传文件所花费的时间。对于通过慢速连接上传大文件，默认的 60 秒可能不够。

大小关系：

`upload_max_filesize`	<	`post_max_size`	<	`max_allowed_packet`	<	`memory_limit`
php.ini		php.ini		my.cnf		php.ini

数据库服务器

数据库服务器用户

从 MySQL 5.7 开始，root 用户在 MySQL 中没有显式密码，因此您需要创建一个具有密码的用户账户来安装 iTop。以下命令创建一个具有所有权限的用户 iTop。这对于测试很有用，但不是生产环境中的最佳配置（因为安全很重要）：

sudo mysql

GRANT ALL PRIVILEGES ON *.* TO 'iTop'@'%' IDENTIFIED BY 'some_password';
FLUSH PRIVILEGES;

iTop 日常使用和安装所需的权限：

SELECT、INSERT、UPDATE、DELETE：iTop 日常使用
CREATE（表）、ALTER、CREATE VIEW：安装和数据模型修改
CREATE（数据库）：如果您要求安装程序为您创建数据库，以及 ITSM Designer 用于测试数据库创建（在这种情况下也需要 DROP）
SHOW VIEW、LOCK TABLES：用于备份
DROP 和 TRIGGER：由 DataSynchro 使用
SUPER：DataSynchro 需要，仅当 MySQL 启用了二进制日志但没有 --log-bin-trust-function-creators 选项时（参见 MySQL Bugs: #39489）
PROCESS：仅由 CMDBSource::LogDeadLock 用于获取死锁上下文（SHOW ENGINE INNODB STATUS 查询）（死锁日志自 iTop 2.7.1 / 3.0.0 起可用，参见 PR #139）

设置

innodb_buffer_pool_size = 512M
query_cache_size = 32M
query_cache_limit = 1M

innodb_default_row_format = DYNAMIC
innodb_large_prefix = true

; max_allowed_packet : 应设置为大于 php.ini 中 upload_max_filesize 的值

国际化

自 iTop 2.5 起，使用的字符集是 utf8mb4，排序规则为 utf8mb4_general_ci。为了让 iTop 正确处理字符串，必须满足以下要求：

MySQL 版本 5.5.3 或更新
innodb_default_row_format 变量设置为 DYNAMIC（默认值）或 COMPRESSED
innodb_large_prefix 设置为 true

附件

上传的文件存储在 MySQL 数据库中，每个文件一个查询。因此，允许的最大查询大小必须大于上传文件的最大大小。这是通过 MySQL 服务器上 my.cnf 配置文件中的变量 max_allowed_packet 配置的。

MySQLDump

此实用程序模块在 MariaDB（或 MySQL）的客户端安装包中可用。

原文：https://www.itophub.io/wiki/page?id=3_2_0:install:php_and_mysql_configuration

版本：3_2_0/install/php_and_mysql_configuration.txt · Last modified: 2025/07/03 12:47 by 127.0.0.1

Docs: 使用 TLS 连接 MySQL

Fri, 27 Jun 2025 00:00:00 +0000

本文档介绍如何配置 iTop 使用 TLS 加密连接到 MySQL 数据库。更多详细内容请参考 iTop 官方文档。

在 iTop 中使用 TLS

如果 iTop 托管在与 MySQL 服务器不同的服务器上，并且使用了共享基础设施，那么您可能希望在应用程序和数据库之间使用加密。

一种方法是使用 MySQL 安全连接。请参阅官方文档：MySQL 5.6 参考手册 :: 6.4 使用加密连接

自版本 2.5 起，iTop 允许使用以下参数：

启用加密：db_tls.enabled
证书颁发机构文件：db_tls.ca

在 iTop 中使用此类连接之前，您需要检查配置。在 phpinfo（调用 setup/phpinfo.php）中，您应该在 “mysqlnd” 部分看到以下内容：

core SSL：supported
extended SSL：supported

Combodo 还强烈建议使用以下脚本测试连接：

<?php
ini_set ('error_reporting', E_ALL);
ini_set ('display_errors', '1');
error_reporting (E_ALL|E_STRICT);

assert_options(ASSERT_ACTIVE, true);
assert_options(ASSERT_WARNING, true);
assert_options(ASSERT_BAIL, true);

$sMySqlHost = 'mysqlserver'; //TODO
$iMySqlPort = 3306;
$sMySqlUser = 'user'; //TODO
$sMySqlPassword = 'password'; //TODO
$iMySqlFlag = MYSQLI_CLIENT_SSL_DONT_VERIFY_SERVER_CERT;
$sTlsKey = '/var/mysql/client-key.pem'; //TODO 修正为正确的值，如未使用则设为 null
$sTlsCert = '/var/mysql/client-cert.pem'; //TODO 修正为正确的值，如未使用则设为 null
$sTlsCa = '/var/mysql/ca.pem'; //TODO 修正为正确的值，如未使用则设为 null

assert(is_readable($sTlsKey), 'Can\'t open SSL Key file');
assert(is_readable($sTlsCert), 'Can\'t open SSL Cert file');
assert(is_readable($sTlsCa), 'Can\'t open SSL CA file');

echo "Trying to connect using :\n host=$sMySqlHost, user=$sMySqlUser, port=$iMySqlPort\n";
echo "TLS options :\n key=$sTlsKey\n cert=$sTlsCert\n ca=$sTlsCa\n";

$oMysqli = new mysqli();
$oMysqli->init();
$oMysqli->ssl_set($sTlsKey, $sTlsCert, $sTlsCa, NULL, NULL);
$oMysqli->real_connect($sMySqlHost, $sMySqlUser, $sMySqlPassword, null, $iMySqlPort, NULL, $iMySqlFlag);

if ($oMysqli->connect_errno)
{
 die ('Connect error (' . mysqli_connect_errno() . '): ' . mysqli_connect_error() . "\n");
} else {
 if (!IsOpenedDbConnectionUsingTls($oMysqli)) {
 $oMysqli->close();
 die ('The connection can be opened but is not TLS encrypted !');
 }

 echo "Successfully connected using TLS !\n";

 $sTlsCipherValue = GetMySqlVarValue($oMysqli, 'ssl_cipher');
 $sTlsVersionValue = GetMySqlVarValue($oMysqli, 'ssl_version');
 echo "TLS cipher=$sTlsCipherValue\n";
 echo "TLS version=$sTlsVersionValue\n";

 $oMysqli->close();
}

/**
 * <p>DB 连接可以在没有加密的情况下透明地打开（没有抛出错误），即使使用了 TLS 参数。<br>
 * 可以调用此方法来确保 DB 连接确实使用了 TLS。
 *
 * <p>我们使用此对象连接：{@link self::$m_oMysqli}
 *
 * @param \mysqli $oMysqli
 *
 * @return boolean true if the connection was really established using TLS
 * @throws \MySQLException
 *
 * @uses IsMySqlVarNonEmpty
 */
function IsOpenedDbConnectionUsingTls($oMysqli)
{
 $bNonEmptySslVersionVar = IsMySqlVarNonEmpty($oMysqli, 'ssl_version');
 $bNonEmptySslCipherVar = IsMySqlVarNonEmpty($oMysqli, 'ssl_cipher');

 return ($bNonEmptySslVersionVar && $bNonEmptySslCipherVar);
}

/**
 * @param \mysqli $oMysqli
 * @param string $sVarName
 *
 * @return bool
 * @throws \MySQLException
 *
 * @uses GetMySqlVarValue
 */
function IsMySqlVarNonEmpty($oMysqli, $sVarName)
{
 $sResult = GetMySqlVarValue($oMysqli, $sVarName);

 return (!empty($sResult));
}

/**
 * @param \mysqli $oMysqli
 * @param string $sVarName
 *
 * @return string
 * @throws \MySQLException
 *
 * @uses 'SHOW STATUS' queries
 */
function GetMySqlVarValue($oMysqli, $sVarName)
{
 $oResults = $oMysqli->query("SHOW SESSION STATUS LIKE '$sVarName'", 1);

 if ($oResults === false) {
 return false;
 }

 $aResults = $oResults->fetch_array(MYSQLI_NUM);
 $sResult = $aResults[1];

 return $sResult;
}

成功时，您应该看到：

Trying to connect using :
host=192.168.10.70, user=sha256user, port=3306
TLS options :
key=/var/www/html/client-key.pem
cert=/var/www/html/client-cert.pem
ca=/var/www/html/ca.pem
Successfully connected using TLS !
TLS cipher=DHE-RSA-AES256-SHA

故障排除

如果您收到关于 --ssl 或 --ssl-mode 的警告或错误，例如：

iTop >= 2.6.2 应该使用 MySQL >= 5.7.0 处理这些警告，如果您仍然遇到这些警告，或者在较低版本或其他 MySQL 供应商中遇到它们，您可以验证：

SELECT Version()

和

SELECT @@version

确保您收到的版本和 MySQL 供应商格式类似于：

10.3.15-MariaDB-log

这些信息将由 iTop 处理，以根据您的 MySQL 供应商/版本选择正确的参数，因此需要正确填写。

如果您在使用 mariadb mysqldump 命令时遇到以下错误，请检查您使用的 mysqldump 版本：

原文：https://www.itophub.io/wiki/page?id=3_2_0:install:php_and_mysql_tls

版本：3_2_0/install/php_and_mysql_tls.txt · Last modified: 2024/09/10 10:25 by 127.0.0.1

Docs: iTop 和反向代理

Fri, 27 Jun 2025 00:00:00 +0000

本文档介绍如何配置 iTop 以在反向代理后面正常工作。更多详细内容请参考 iTop 官方文档。

iTop 和反向代理

自版本 2.7.4 起，iTop 与反向代理兼容，前提是正确配置了反向代理。

HTTP 头

在 iTop 执行的某些阶段（安装、通过 SSO 登录…），应用程序需要有关客户端浏览器请求的原始 URL 的信息。

当运行 iTop 的 PHP/Web 服务器通过反向代理访问时，有关实际 HTTP 请求的信息无法通过正常的 HTTP 头获得，因此反向代理必须提供这些附加信息。提供此信息的事实标准是通过使用 X-Forwarded-* HTTP 头。

iTop 考虑以下头：

头名称	含义
`X-Forwarded-Host`	客户端浏览器看到的主机。（例如 itop.mycompany.com）
`X-Forwarded-Port`	客户端浏览器使用的端口。（例如 80、8080、443…）
`X-Forwarded-Proto`	客户端浏览器使用的协议。http 或 https
`X-Forwarded-Protocol`	X-Forwarded-Proto 的替代头：客户端浏览器使用的协议。http 或 https

安全考虑

这些头中的值只有在来自合法来源（即反向代理）时才应该被信任。

由于 X-Forwarded-* 头是纯文本 HTTP 头，任何 Web 浏览器客户端都可以轻松地在请求中注入这些头。

为了消除对可信来源复杂配置的需要（IPv4 或 IPv6 地址范围），iTop 使用以下策略：

iTop 应用程序的根 URL 在应用程序安装期间计算（基于可用的服务器信息和 HTTP 头）。此值会提示给管理员，管理员负责验证它。在这种情况下，X-Forwarded-* HTTP 头始终被信任。
当计算重定向 URL 时，iTop 将此计算出的 URL 与存储的根 URL 进行比较。如果计算出的 URL 以根 URL 开头，则可以安全地执行重定向。否则，重定向将指向应用程序的起始页面。只有当您将 behind_reverse_proxy 配置参数设置为 true 时，X-Forwarded-* HTTP 头才会被信任。

这意味着您的 Web 服务器必须只能由您的代理访问（换句话说，不能直接由所有公共 IP 地址访问）。

超时、重试和自定义错误

当 iTop 执行某些耗时操作（安装、移至生产环境、数据库完整性检查）时，如果应用程序响应太慢，反向代理可能会放弃请求。根据代理配置，请求将被报告为错误或自动重新启动！这可能会在应用程序中产生意外错误。

为防止此类错误发生，请确保：

为 iTop 请求配置较长的读取超时（某些安装任务在大型到中型数据库上可能需要一个小时才能完成）。
禁用重试（当请求超时时，反向代理可以重试请求，这会破坏 iTop 的某些页面）。
禁用代理的自定义错误（某些代理可以拦截错误代码并替换响应，这会破坏 iTop 的某些页面）。

原文：https://www.itophub.io/wiki/page?id=3_2_0:install:reverse_proxy

版本：3_2_0/install/reverse_proxy.txt · Last modified: 2024/09/10 10:25 by 127.0.0.1

Docs: iTop 与 NGINX

Fri, 27 Jun 2025 00:00:00 +0000

本文档介绍如何在 NGINX 上配置和运行 iTop。更多详细内容请参考 iTop 官方文档。

转换 Apache 配置

你需要手动将 iTop 源代码中的 .htaccess 文件转换为 NGINX 的配置规则。

请注意，每次升级后，都应检查是否引入了新的规则。最简单的方式是通过 GitHub 对比文件变更（示例）。

门户配置

如果你在 NGINX 上运行 iTop 并选择了增强门户（enhanced portal），很可能会在某些门户页面上遇到 404 错误。

默认情况下，当访问类似 http://localhost/dir/script.php/arg1/arg2 的 URL 时，NGINX 会认为 script.php 是一个目录，并尝试执行位于 /dir/script.php/arg1/arg2 的索引文件（该文件并不存在）。

在 iTop 中，这意味着当 NGINX 尝试执行：

http://localhost/pages/exec.php/browse/faq?exec_module=itop-portal.php&exec_page=index.php

NGINX 实际上会尝试执行 /pages/exec.php/browse/faq，而这不是一个真实的脚本。

你需要正确配置 NGINX 服务器，使其能够正确处理这些 URL。

增强门户基于 Symfony 框架，该框架提供了相关的配置文档。你可以根据你的实例进行适配。请记住，门户使用的是 /pages/exec.php 而非 /index.php。

Docs: iTop 与 SELinux

Fri, 27 Jun 2025 00:00:00 +0000

本文档介绍在启用 SELinux 的 Linux 发行版上运行 iTop 所需的配置。更多详细内容请参考 iTop 官方文档。

某些 Linux 发行版（如 Fedora、RedHat、CentOS 等）默认启用了 SELinux。在使用 iTop 之前，需要进行额外的安全配置。

基础 SELinux 配置

# 允许对 iTop 根目录及其子目录进行读写
semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/html/itop(/.*)?"
# 应用策略
restorecon -Rv /var/www/html/itop/
# 查看已应用的策略
ls -lZ /var/www/html/itop/

此基础配置可与 iTop 正常工作。如需应用更严格的权限，你需要具备深入的 SELinux 知识。

文件写入问题

如果安装过程中提示 iTop 的 conf 文件夹已存在但无法写入，且目录权限看起来正确，则可以尝试临时关闭 SELinux 上下文检查：

setenforce 0

这会完全关闭安全上下文检查。这绝对不适合生产环境，但有助于排查问题根源。有关安全上下文的更多信息，请参阅此处或此处。

连接远程 MySQL 服务器

如果 iTop 无法连接到远程 MySQL 服务器，请使用以下命令检查 SELinux 设置：

getsebool -a | grep 'httpd'

输出应类似于：

allow_httpd_anon_write –> off
allow_httpd_bugzilla_script_anon_write –> off
allow_httpd_cvs_script_anon_write –> off
allow_httpd_mod_auth_pam –> off
allow_httpd_nagios_script_anon_write –> off
allow_httpd_prewikka_script_anon_write –> off
allow_httpd_squid_script_anon_write –> off
allow_httpd_sys_script_anon_write –> off
httpd_builtin_scripting –> on
httpd_can_network_connect –> off
httpd_can_network_connect_db –> off
httpd_can_network_relay –> off
httpd_can_sendmail –> on
httpd_disable_trans –> off
httpd_enable_cgi –> on
httpd_enable_ftp_server –> off
httpd_enable_homedirs –> on
httpd_rotatelogs_disable_trans –> off
httpd_ssi_exec –> off
httpd_suexec_disable_trans –> off
httpd_tty_comm –> on
httpd_unified –> on
httpd_use_cifs –> off
httpd_use_nfs –> off

如果看到 httpd_can_network_connect_db –> off，这意味着 Web 服务器被阻止与 MySQL 服务器建立网络连接。

要更改此安全设置，请以 root 身份执行以下命令：

setsebool -P httpd_can_network_connect_db on

从远程连接 iTop

如果你只能从本机连接到 Web 服务器，而无法从远程系统访问，请检查防火墙（iptables）配置。

firewall-cmd --list-services

命令输出应类似于：

dhcp-v6-client http mdns ssh

如果列表中没有 http，则对 Web 服务器的访问将被阻止。要以 root 身份解除阻止，请执行：

firewall-cmd --add-service=http

原文：https://www.itophub.io/wiki/page?id=3_2_0:install:selinux

版本：3_2_0/install/selinux.txt · Last modified: 2024/09/10 10:25 by 127.0.0.1

Docs: iTop 与 Suhosin

Fri, 27 Jun 2025 00:00:00 +0000

本文档介绍 Suhosin 安全扩展与 iTop 的兼容性问题及配置建议。更多详细内容请参考 iTop 官方文档。

Suhosin 是一个额外的安全层，在 PHP 之上执行多项安全检查。如果你的 Web 服务器不暴露在公共互联网上，且你不计划向数百万并发用户交付 iTop 应用，可以考虑适当放宽某些 Suhosin 限制，以换取更多功能。

以下是已知问题及相关 Suhosin 配置参数：

参数	默认值	症状	建议修复方案
`suhosin.post.max_vars`	1000	编辑包含超过 300 个相关 CI 的工单时失败。无法一次性删除/修改超过 997 个对象。	在 Suhosin 配置中提高该限制
`suhosin.get.max_value_length`	< 1024	不可预测的影响。iTop 在安装时会检测到此问题。	在 Suhosin 配置中提高该限制

更多关于 Suhosin 的信息：http://www.hardened-php.net/

原文：https://www.itophub.io/wiki/page?id=3_2_0:install:suhosin

版本：3_2_0/install/suhosin.txt · Last modified: 2024/09/10 10:25 by 127.0.0.1

Docs: 保护 iTop 安装

Fri, 27 Jun 2025 00:00:00 +0000

本文档介绍如何在首次安装后禁用 iTop 安装向导，以减少攻击面。更多详细内容请参考 iTop 官方文档。

为什么

首次安装时使用的安装向导应该被禁用，以减少攻击面。有两个文件特别需要注意：

setup/index.php：当然需要保护
setup/phpinfo.php：会泄露大量系统信息（注意：自 iTop 2.5.2、2.6.1 和 2.7.0 起，通过添加认证已降低了风险）

如何保护

您不应该删除整个 setup/ 目录，因为它包含 iTop 所需的文件。

相反，您可以使用适合您所用 Web 服务器的文件来阻止 Web 访问。data/ 目录中已经有这样的文件，例如：

Apache httpd：https://github.com/Combodo/iTop/blob/develop/data/.htaccess
Microsoft IIS：https://github.com/Combodo/iTop/blob/develop/data/web.config

iTop 更新

为了方便 iTop 更新，您可能希望自动化该过程。请参阅自动化安装。

原文：https://www.itophub.io/wiki/page?id=3_2_0:install:itop_setup_protection

版本：3_2_0/install/itop_setup_protection.txt · Last modified: 2024/09/10 10:25 by 127.0.0.1

Docs: 安装 iTop

Fri, 27 Jun 2025 00:00:00 +0000

本文档介绍如何在 Ubuntu 上快速安装 iTop。更多详细内容请参考 iTop 官方文档。

在 Ubuntu 上快速安装

（其他环境的命令请参阅安装指南）

安装 iTop

运行以下命令在 Ubuntu 上使用 Apache 和 MariaDB 安装 iTop：

sudo apt-get update
apt-get install mariadb-server libapache2-mod-php php php-mysql php-cli php-json graphviz php-xml php-gd php-zip php-curl php-soap php-mbstring php-apcu php-ldap php-imap

wget https://sourceforge.net/projects/itop/files/latest/download -O /tmp/itop.zip
sudo unzip /tmp/itop.zip "web/*" -d /var/www/html/itop
sudo mv /var/www/html/itop/web/* /var/www/html/itop
sudo rmdir /var/www/html/itop/web
sudo setfacl -dR -m u:"www-data":rwX /var/www/html/itop/data /var/www/html/itop/log
sudo setfacl -R -m u:"www-data":rwX /var/www/html/itop/data /var/www/html/itop/log
sudo setfacl -m u:"www-data":rwX /var/www/html/itop/
sudo mkdir /var/www/html/itop/env-production /var/www/html/itop/env-production-build /var/www/html/itop/env-test /var/www/html/itop/env-test-build
sudo chown www-data: /var/www/html/itop/conf /var/www/html/itop/env-production /var/www/html/itop/env-production-build /var/www/html/itop/env-test /var/www/html/itop/env-test-build

启动安装

从 Web 浏览器启动安装，访问此 URL：https://myserver.mydomain.com/itop/setup，然后按照安装向导操作。

安装完成后

确保应用程序可访问并了解用户界面：您首次连接 iTop。
创建 iTop 应用程序可供用户使用的最小对象集：请遵循实施指南。

原文：https://www.itophub.io/wiki/page?id=3_2_0:install:installing_itop

版本：3_2_0/install/installing_itop.txt · Last modified: 2024/09/10 10:25 by 127.0.0.1

Docs: 安装向导 [iTop 文档]

Fri, 27 Jun 2025 00:00:00 +0000

本文档介绍 iTop 安装向导的详细步骤。更多详细内容请参考 iTop 官方文档。

安装向导

确保您有一个配置正确的 Apache/PHP 实例正在运行。
将 “web” 目录的内容解压到 Web 服务器提供服务的目录中（例如 Linux 上的 /var/www/html/itop 或 Windows/IIS 上的 C:\inetpub\wwwroot\itop）。
设置适当的权限（请参阅专用 Wiki 页面）。
将 Web 浏览器指向文件已解压目录对应的 URL（例如 http://localhost/itop），然后按照屏幕上的指示操作。

iTop 提供了一个分步向导来安装应用程序。

第一步：检查配置和先决条件

安装的第一步是检查配置的一致性、Web 服务器用户的权限以及 MySQL、PHP 和可选 PHP 扩展的先决条件。

第二步：选择安装类型

第二步提供选择：升级现有 iTop 实例或从头开始安装应用程序。

如果您选择安装新实例，向导的第三步将提示您接受许可协议。

第四步：数据库连接信息

向导的第四步提示您输入连接 MySQL 的凭据以及用于安装 iTop 的数据库。请确保提供一个具有足够权限的账户来安装和运行 iTop。此账户需要在数据库中创建表、触发器和视图，以及在升级时删除视图。如果您选择让安装程序为您创建新数据库，此账户需要有足够的权限来执行此操作。

您还可以指定一个前缀，该前缀将添加到 iTop 在数据库中创建的所有表和视图的名称中。如果您想在同一个 MySQL 数据库中安装多个 iTop，这很有用，但建议避免这样做。最好创建多个数据库。

请注意，数据库服务器不需要与 PHP/Web 服务器在同一台物理服务器上；如果您喜欢采用双层架构，或者连接到已安装的 MySQL 服务器，它可以是远程主机。

管理员账户

向导的下一步提示您输入管理员账户的信息。iTop 认证可以依赖外部机制（LDAP、Active Directory 或 JASIG-CAS），但安装要求至少创建一个具有本地密码的管理员账户。

其他信息

下一个屏幕提示您输入几个其他信息：

默认语言：这是登录屏幕的语言以及新创建用户账户的默认语言。
访问 iTop 的 URL：如果用户将通过不同的 URL 访问 iTop（通过 DNS 别名、不同的 IP 地址等），请更改此值。
示例数据：如果您想快速体验 iTop，请安装示例数据。示例数据提供一些示例配置项（服务器、应用程序、联系人）以及服务目录的默认设置，以确保应用程序的快速部署。如果您正在部署 iTop 的生产实例并想要一个"干净"的安装，请不要选择此选项。

配置 CMDB

CMDB 由 5 个模块组成：

配置管理核心模块：始终安装。此模块提供 iTop 中必须始终存在的基本对象：组织、位置、联系人以及一些常见的 CI，如服务器、组、应用程序等。
数据中心管理模块：提供用于管理数据中心物流的配置项：机架、机箱、电源（PDU、电源…）。如果您不管理数据中心，可能不需要此模块。
终端用户设备模块：定义与终端用户相关的设备：电话、PC、平板电脑… 如果您不计划在 iTop 中管理此类设备，可以取消选中此选项。
高级存储管理模块：定义与存储设备管理相关的配置项：SAN 交换机、NAS、磁带库和磁带等。它是可选的。
虚拟化管理模块：定义虚拟机、虚拟机管理程序、集群等。如果您不计划在 iTop 中管理虚拟设备，可以取消选中它。

配置服务管理

iTop 中的服务管理有两种风格。选择最能代表您情况的选项：

企业服务管理：最适合描述同一基础设施用于向一组客户交付服务的情况。客户可以是同一组织的内部实体或外部客户。
服务提供商服务管理：最适合用于交付/支持客户的基础设施对每个客户是特定的情况，客户之间几乎没有重叠（共享）。

这两个模块的文档集中在：服务管理（服务、SLA、合同）模块。

配置工单管理

如果您计划在 iTop 中管理工单，基本上有两个选项：

简单工单：最适合实现简单流程，其中事件和用户请求之间几乎没有区别。所有工单共享相同的生命周期，您可以随时更改工单的分类。如果您计划让最终用户通过门户直接创建工单，无论是提交服务请求还是报告事件，这个选择可能是合适的。
ITIL 合规工单：最适合实现严格的 ITIL 合规流程。用户请求和事件工单之间有明确的区别。（您可以选择仅部署其中一个流程或两者都部署。）

当然，您也可以选择不在 iTop 中管理此类工单。在这种情况下，选择第三个选项。

配置变更管理

如果您计划在 iTop 中实施变更管理，也有两个选项：

简单变更管理：提供一种单一类型的通用变更请求工单。
ITIL 合规变更管理：提供完整的 ITIL 合规变更流程集，包括标准、例行和紧急变更工单。

您也可以通过选择第三个选项来完全停用 iTop 中的变更管理。

其他 ITIL 流程

除了变更和事件管理之外，还可以通过选择相应的工单类型来部署另外两种 ITIL 合规流程：

问题管理
已知错误和 FAQ

启动安装

完成所有选择后，将显示摘要。您可以点击每个部分的"加号"按钮来查看您的选择。

要开始实际的 iTop 安装，请点击"安装！“按钮。

安装进度将显示一个移动的进度条。

安装完成后，您可以：通过点击"工单管理手动说明"链接查看关于设置后台任务的说明。或者通过点击"进入 iTop"按钮立即进入 iTop。

恭喜，您已成功安装 iTop！

自动化安装

iTop 的安装通常使用 “setup” 页面以交互方式进行。然而，一旦安装页面收集了有关所需配置的信息，实际的安装过程就是完全无人值守的，因此可以自动化。

安装时的主题预编译

此功能是安装的一个优化，可以显著节省主题处理时间。

有关更多详细信息，请参阅主题预编译。

原文：https://www.itophub.io/wiki/page?id=3_2_0:install:install_wizard

版本：3_2_0/install/install_wizard.txt · Last modified: 2024/09/10 10:25 by 127.0.0.1

Docs: 升级 iTop

Fri, 27 Jun 2025 00:00:00 +0000

本文档介绍如何升级 iTop，包括升级前的检查清单和手动/自动升级步骤。更多详细内容请参考 iTop 官方文档。

升级前检查…

软件要求

仔细阅读要求，自您上次安装/升级 iTop 实例以来，它们可能已经发生了变化：

发行说明

为什么要升级？新版本带来了哪些功能：

iTop 版本	2.7	3.0	3.1	3.2
新功能	2.7 新功能	3.0 新功能	3.1 新功能	3.2 新功能
变更日志	累积变更日志（包含每个子版本的详尽变更列表）

迁移说明

在将 iTop 实例升级到新版本之前，请阅读升级路径上的所有迁移说明！例如，如果您从 2.7.x 升级到 3.2.0，您必须阅读以下迁移说明：2.7 到 3.0 和 3.0 到 3.1 和 3.1 到 3.2。

目标版本	2.7	3.0	3.1	3.2
迁移说明	2.6 到 2.7	2.7 到 3.0	3.0 到 3.1	3.1 到 3.2

扩展兼容性

在升级之前，检查您所有已安装的扩展是否与新版本兼容！

已安装扩展及其版本的列表可以在"关于 iTop…“对话框中找到，位于注销菜单中。

通过打开每个扩展的文档来检查兼容性。

流程：在测试环境中进行试运行

您应该首先在与相同环境（PHP 和 MySQL 版本和配置）和相同数据的测试环境中尝试更新！

iTop 升级

自动升级

如果您安装的 iTop 实例至少为 2.7.0 版本，您将能够使用应用程序升级器来自动化该过程！它位于系统 / 应用程序升级菜单中。这特别推荐用于安全升级，因为通常很少进行更改！

iTop 应用程序升级器将检查系统配置，并在要求未满足时警告您。

如果您因任何原因无法使用 iTop 应用程序更新器（上传大小、写入权限等），请使用以下手动流程。

手动升级

备份您当前的 iTop 目录（您应该排除 /data/backups）
将下载的包解压到您的 iTop 目录中：这将创建一个 /web 子目录
如果您使用了 /webservices/cron.params 文件，请将其复制到 /web/webservices
删除旧版本的核心文件：

rm -rf addons datamodels images lib manifest.xml portal application core dictionaries env-test index.php navigator setup webservices approot.inc.php css js pages synchro documentation bootstrap.inc.php web.config node_modules sources resources templates data/cache-production/*

您的 iTop 目录现在应包含以下子目录：conf、data、env-production、log、extensions、web（以及如果您安装了它们，可能还有 toolkit 或 collectors）
iTop 目录级别没有文件。您可能需要删除 bootstrap.inc.php 和 templates/（如果存在，自 2.7.0 起）
通过运行以下命令复制新版本的核心文件，仍在您的 iTop 目录中：cp -r ./web/* .
检查权限（您的 Web 服务器用户必须具有访问权限）
更改 iTop 配置文件使其可写：chmod 644 conf/production/config-itop.php
启动安装程序（在浏览器中使用：<your_itop_url>/setup）
在第二步，保持"升级"单选按钮选中。检查是否选择了数据库备份
在所有后续步骤中点击下一步
您的 iTop 目录现在应包含以下子目录：conf、data、env-production、log、extensions、web（以及如果您安装了它们，可能还有 toolkit 或 collectors）
iTop 目录级别没有文件
您可能需要删除 bootstrap.inc.php 和 templates/（如果存在，自 2.7.0 起）

原文：https://www.itophub.io/wiki/page?id=3_2_0:install:upgrading_itop

版本：3_2_0/install/upgrading_itop.txt · Last modified: 2025/02/12 15:00 by 127.0.0.1

Docs: 升级向导

Fri, 27 Jun 2025 00:00:00 +0000

本文档介绍 iTop 更新向导的详细步骤。更多详细内容请参考 iTop 官方文档。

更新向导

确保 iTop 配置文件（conf/production 中的 config-itop.php）不是只读的。
将 Web 浏览器指向 http(s)://location_of_itop/setup 并按照屏幕上的说明操作。

用于安装应用程序的分步向导在升级时会被复用，但有一些差异。

第一步：检查配置和先决条件

第一步检查配置的一致性以及 MySQL、PHP 和可选 PHP 扩展的先决条件。在升级过程中可能会失败，因为它可能比以前的版本更严格。例如，在 2.5.0 之后，MySQL 和 PHP 的先决条件将会改变。

第二步：数据库连接和备份

更新的第二步总结了之前在安装中提供的数据库连接信息，并默认建议在应用程序和数据库升级之前创建 iTop 备份。

第三步：其他信息

升级的第三步提示您输入几个其他信息，这些信息在升级期间仍然可以更改。

配置 CMDB

您不能删除在初始安装时安装的模块，但可以添加一些。

配置服务管理

在大多数情况下，这是在初始安装时设置的，不能更改。

配置工单管理

如果您现在想在 iTop 中管理工单，请查看安装中的可选选项。一旦在之前的安装中做出了选择，您就不能在简单和 ITIL 合规工单管理之间切换，也不能停用工单管理模块。

配置变更管理

如果您现在想在 iTop 中管理变更，请查看安装中的可选选项。一旦在之前的安装中做出了选择，您就不能在简单和 ITIL 合规变更管理之间切换，也不能停用变更管理。

其他 ITIL 流程

您不能删除在初始安装时安装的模块，但可以添加一些。

其他模块/扩展

如果您已添加模块/扩展，它们可以在升级过程的此步骤中安装，但不能删除。

启动升级

完成所有选择后，将显示摘要。您可以点击每个部分的"加号"按钮来查看您的选择。

要开始实际的 iTop 升级，请点击"安装！“按钮。

升级进度将显示一个移动的进度条。

升级完成后，您会看到：

恭喜，您已成功升级 iTop！

内部机制

在安装开始时，iTop 通过 <itop>/data 下的名为 .readonly 的文件进入只读模式。应用程序不再可写，因为数据库结构可能会被大幅修改。然后在数据模型编译期间，iTop 通过在同一位置放置名为 .maintenance 的文件进入维护模式。因为在此阶段不再有有效的 iTop 代码可以使用，即使是只读模式。

此机制适用于：

安装
当 iTop Hub 推送扩展时
当 ITSM Designer 推送新数据模型时（针对 Combodo 客户）
应用程序升级时

原文：https://www.itophub.io/wiki/page?id=3_2_0:install:update_wizard

版本：3_2_0/install/update_wizard.txt · Last modified: 2024/09/10 10:25 by 127.0.0.1

Docs: 3.1.x 到 3.2.0 迁移说明

Fri, 27 Jun 2025 00:00:00 +0000

本文档重点介绍将 iTop 迁移到此版本时可能出现的问题。更多详细内容请参考 iTop 官方文档。

3.1.x 到 3.2.0 迁移说明

本文档重点介绍将您的 iTop 迁移到此版本时可能出现的问题。

有关新功能的重点，请查看新功能
有关变更的详尽列表，请查看变更日志
有关 3.2 Beta 版本的已知问题
Combodo 3.2 兼容扩展版本

3.2.3 特定说明

安全修复：自定义扩展迁移

由于安全修复，您可能需要调整您的扩展：需要做什么以及如何做。

要确定您的扩展是否需要一些调整，您可以将 iTop 的错误级别设置为 DEBUG，需要修复的 PHP 页面将被记录。

如果您的 iTop 的所有扩展都已准备就绪，我们建议您将配置参数 security.disable_exec_forced_login_for_all_enpoints 更改为 false，以增强 iTop 的安全性，而无需等待后续版本更改默认参数值。

安全修复：参数文件位置

由于安全修复，可选的 --param_file 参数（可用于 CRON、备份、导入、导出等）现在必须位于 iTop 文件夹之外。这在 CRON 页面中已经是推荐做法，现在已被强制执行。

安全修复：电子表格中的报告

由于安全修复，电子表格导出中的值现在以单引号 (’) 为前缀，以避免 CSV 注入。有关更多信息，请参阅该功能的问答部分。

安全：SMTP 服务器证书验证强制执行

如果您使用 SMTP 服务器的别名通过 iTop 使用 TLS 协议发送电子邮件，请注意 iTop 现在会检查证书的有效性。如果您收到类似 Unable to connect with STARTTLS: stream_socket_enable_crypto(): Peer certificate CN='some.vertified.domain' did not match expected CN='some.uncertified.domain.alias' 的错误，请将 email_transport_smtp.verify_peer 配置参数设置为 true。

数据模型：事件类的权限

由于安全修复，Event 类（及其子类）以前对任何配置文件都可访问。自 iTop 3.2.3 / 3.3.0 起，它们默认仅对 Administrator 和 SuperUser 配置文件可访问。

如果您希望允许其他配置文件读取它们，您应该将 Event 组添加到所需的配置文件中。
如果您添加了子类，您应该将它们添加到 grant_by_profile 类别中，以便它们遵循与原生类相同的安全规则。

数据模型：SuperUser 配置文件

SuperUser 配置文件（ID 117）已更新，添加了缺失的权限。如果您在自定义中更改了它们，请注意我们更改了以下 XPath 的默认数据模型：/itop_design/user_rights/profiles/profile[(@id="117")]/groups/group[@id='Incident' or @id="Ticket"]

通知：通过 OAuth 和 SSL 的 SMTP

iTop 3.2.3 带来了一个新的出站/入站邮件组件，此组件比以前的组件更严格，这意味着如果您的配置尚未符合 RFC，您可能需要调整它。通常，如果您将电子邮件传输配置如下：

'email_transport' => 'SMTP_OAuth',
'email_transport_smtp.encryption' => 'tls',
'email_transport_smtp.host' => 'some.smtp-server.com',
'email_transport_smtp.port' => '587'

您尝试发送电子邮件时可能会收到以下错误：

Errors: Connection could not be established with host "ssl://some.smtp-server.com:587": stream_socket_client(): SSL operation failed with code 1. OpenSSL Error messages: error:0A00010B:SSL routines::wrong version number

要避免/修复此问题，只需将 email_transport_smtp.encryption 参数从 tls 更改为 ssl，如 SMTP OAuth 故障排除部分中所述。

扩展：邮件到工单自动化 - “邮箱（用于 IMAP）“属性

自扩展 v3.9.0 起，指定要扫描的文件夹（“邮箱（用于 IMAP）“属性）时，该值必须遵循 RFC 3501，这意味着以前容忍的某些格式不再受支持：

根文件夹不得以分隔符开头，例如 /INBOX 或 /foo 不受支持，请使用 INBOX 或 foo
路径不得以分隔符开头，例如 /INBOX/foo 不受支持，请使用 INBOX/foo

3.2.1 特定说明

此版本更改了未提供值时强制日期和日期时间属性的处理方式。

之前：当前日期时间（now）会自动设置到此类字段中（导致用户忽略日期并留下无效值）
从 iTop 3.2.1 版本起：如果未提供值，对象创建/更新将失败。但现在可以在 XML 中为此类属性定义相对默认值：NOW() → 对象创建时的当前日期（时间）；DATE_ADD(NOW(), INTERVAL 7 DAY) → 当前日期（时间）+ 7 天；或任何 OQL 支持的计算日期的语法

何时重要？

如果这些字段是向用户请求的，此 iTop 更改没有影响。
如果这些字段是通过覆盖 OnInsert 或 OnUpdate 方法自动填充的，同样此 iTop 更改没有影响。
如果这些字段未向用户展示且未由任何代码设置，那么您需要在这些字段的 XML 标签 default_value 中设置 NOW() 以恢复之前的行为。

如何修复？

这可以在 Designer 中快速完成，或者通过 iTop 扩展完成。
这可以在升级之前完成，即使在旧版本如 2.7.x 上也可以，因为在 3.2.1 之前，日期和日期时间属性上的默认值会被静默忽略。

对用户的影响

除了新功能中描述的新内容外，与 iTop 3.1.x 版本相比，现有 iTop 行为没有破坏性更改。

升级前检查

系统

iTop 根文件夹下有一个新文件夹 “resources” 和一个新文件 “app.php”。如果必要，请更新您的迁移/备份脚本。

PHP 版本

新的 PHP 最低版本：8.1.0
新的 PHP 最高版本：8.3.x

PHP 扩展

PHP 扩展 APCu 现在强烈推荐使用，否则性能可能会略有下降。

MySQL / MariaDB 版本

MariaDB 最低版本提高到：10.6+
MySQL 最低版本保持不变：5.7，但 MySQL 不再是推荐选择

数据库

数据库更新操作

N°6619 - 附件：将 contact_id 从 AttributeExternalField 改为 AttributeExternalKey

alter_algorithm 参数设置为 “COPY” 或 “INPLACE”。
在较旧版本的 MariaDB 上构建的 attachment 表，自那以后从未重建

有关更多信息，请参阅 MariaDB-InnoDB 在线 DDL

以下操作由安装程序执行，但可能相当慢，且不在您期望的时间点。您可以在升级前使用以下命令手动运行操作：

SET SESSION alter_algorithm='INSTANT';
ALTER TABLE `attachment` ADD `contact_id` INT(11) DEFAULT 0;
ALTER TABLE `attachment` ADD INDEX `contact_id` (`contact_id`);

然后使用此查询填充联系人信息：

UPDATE attachment att
JOIN priv_user us ON att.user_id = us.id
SET att.contact_id = us.contactid
WHERE att.contact_id = 0;

扩展/自定义代码

像往常一样，某些扩展必须同时升级，其中 4 个需要在之后升级。

如果您使用 XML 和自定义代码开发了自定义扩展，请检查：开发者检查清单

需要升级的扩展

检查每个 Combodo 扩展的 3.2 兼容版本，您需要在升级前安装。

门户主题

如果您为最终用户门户创建了替换 bootstrap-theme-combodo.scss 的自定义主题，您需要重新生成它。否则某些元素可能无法正确显示（HTML 编辑器）。

包含在 iTop 中

XML 数据模型

配置文件 117

iTop Community 3.2.1 中添加了一个 ID 为 117 的新配置文件 “Super User”。

此配置文件允许委派大多数 iTop 管理员任务，但系统方面除外。
扩展在定义其带来的对象/功能的访问权限时，应考虑此配置文件。

用户请求

用户请求和事件类的 “Solution” 字段现在支持 HTML。要恢复此数据模型更改，请将以下 XML 添加到扩展中，或要求 Combodo 在 Designer 中为您注入：

<class id="UserRequest" _delta="if_exists">
 <fields>
 <field id="solution" xsi:type="AttributeText" _delta="if_exists">
 <format _delta="delete_if_exists"/>
 </field>
 </fields>
</class>
<class id="Incident" _delta="if_exists">
 <fields>
 <field id="solution" xsi:type="AttributeText" _delta="if_exists">
 <format _delta="delete_if_exists"/>
 </field>
 </fields>
</class>

安装程序

配置文件

升级后检查/操作

重命名您的触发器

由于新的取消订阅机制，触发器 “Description” 字段将对控制台用户可见，作为他们收到的通知的标识符，因此该描述应该解释何时生成此触发器（他们可能会根据触发器类型猜测，但显式文本可能更容易理解）以及谁接收它们。

连接新闻

iTop 3.2.0 带有 3 个新的 “通过 Newsroom 通知” 操作：

提及人员通知：自动链接到所有现有的 “Trigger (on object mention)"，在 “Mentioned filter” 字段中搜索 “Person”
工单分配时通知代理：与 “Trigger (on entering a state)” 链接，类为 “User Request”，状态为 “assigned”
通过门户更新公共日志时通知：与 “Trigger (when updated from the portal)” 和 “Trigger (when updated by mail)” 链接，两者类均为 “User Request”

所有 “Trigger (on object mention)” 触发器的 “Subscription policy” 字段（在 3.2.0 中添加的字段）设置为 “Force at least one channel (News or Email)"，因为默认情况下我们不希望 iTop 用户在某个对象日志中提到他们的名字时取消订阅所有渠道。

移除搜索 Brick

如果您不希望在标准门户中看到新的搜索 brick，请在 Designer 中添加以下行（针对 Combodo 客户），或创建一个执行此操作的 iTop 扩展。

<module_design id="itop-portal" xsi:type="portal">
 <bricks>
 <brick id="manage-all-tickets-for-portal-user" xsi:type="Combodo\iTop\Portal\Brick\ManageBrick" _delta="delete"/>
 <brick id="search-within-tickets-for-portal-user" xsi:type="Combodo\iTop\Portal\Brick\FilterBrick" _delta="delete"/>
 </bricks>
</module_design>

X-Content-Type-Options HTTP 头和 CORB 保护

自 iTop 2.7.10 / 3.0.4 / 3.1.2 / 3.2.0 起，X-Content-Type-Options HTTP 头以 nosniff 值发送。这可能会触发某些资源的 CORB 保护，阻止它们加载（参见 Chromium CORB 说明）。

为缓解此问题，在 iTop 核心中对应的资源上禁用发送此 HTTP 头。由于某些扩展可能会受到影响，可以将 security.enable_header_xcontent_type_options 配置参数设置为 false 以防止发送该头。

降级

🚧 进行中

原文：https://www.itophub.io/wiki/page?id=3_2_0:install:migration_notes

版本：3_2_0/install/migration_notes.txt · Last modified: 2026/06/24 10:08 by 127.0.0.1

Docs: 将 iTop 移动到不同的 URL [iTop 文档]

Fri, 27 Jun 2025 00:00:00 +0000

本文档介绍如何将 iTop 移动到不同的 URL。更多详细内容请参考 iTop 官方文档。

将 iTop 移动到不同的 URL

在某些情况下，更改 iTop 的 URL 可能会有帮助。更改目录、更改服务器名称或 IP、创建别名都是需要进行此操作的情况。

更改后，请在配置文件中设置 app_root_url 字段，否则应用程序将停止工作！

此字段必须包含用于在应用程序中导航的根 URL。
此值也用于创建 iTop 生成的电子邮件中的 Web 链接。
您可以使用 $SERVER_NAME$ 作为服务器名称的占位符。

请注意，更改此配置参数后，必须重新运行安装程序。

原文：https://www.itophub.io/wiki/page?id=3_2_0:install:moving_itop

版本：3_2_0/install/moving_itop.txt · Last modified: 2024/09/10 10:25 by 127.0.0.1

iTopCN – 安装/升级 iTop

Docs: 安装您的第一个 iTop

安装您的第一个 iTop

下载和安装

实施部署

Docs: 硬件和软件要求

最低硬件要求

iTop 兼容性列表

Web 浏览器

Web 服务器

配置您的 Web 服务器

GraphViz

数据库服务器

MariaDB 与 iTop 备份的不兼容性

Docs: 安装 PHP、Web 服务器和数据库...

Debian 或 Ubuntu

RedHat、CentOS 或 Fedora

Windows

在 IIS 上安装 PHP

安装 MySQL

Windows 上使用 easyPHP 的开发环境

Docs: 配置 PHP、Web 服务器和数据库...

Web 服务器

允许将 OQL 查询作为参数传递

临时目录的写入权限

APCu

数据库客户端模块

PHP

必需扩展

其他 PHP 扩展

php.ini 设置

max_input_vars

附件上传

数据库服务器

数据库服务器用户

设置

国际化

附件

MySQLDump

Docs: 使用 TLS 连接 MySQL

在 iTop 中使用 TLS

故障排除

Docs: iTop 和反向代理

iTop 和反向代理

HTTP 头

安全考虑

超时、重试和自定义错误

Docs: iTop 与 NGINX

转换 Apache 配置

门户配置

推荐配置

Docs: iTop 与 SELinux

基础 SELinux 配置

文件写入问题

连接远程 MySQL 服务器

从远程连接 iTop

Docs: iTop 与 Suhosin

Docs: 保护 iTop 安装

为什么

如何保护

iTop 更新

Docs: 安装 iTop

在 Ubuntu 上快速安装

安装 iTop

启动安装

安装完成后

Docs: 安装向导 [iTop 文档]

安装向导

第一步：检查配置和先决条件

第二步：选择安装类型

第四步：数据库连接信息

管理员账户

其他信息

配置 CMDB

配置服务管理

配置工单管理

配置变更管理

其他 ITIL 流程

启动安装

自动化安装