后台任务

为了正常运行，必须定期执行iTop维护操作和异步任务。为了简化安装，已将所有的后台任务集中到单一文件（webservices/cron.php）中运行。

以下功能依靠cron.php的激活：

• Notification(通知) 如果没有调用该web服务，则不会在单据到达阈值（TTO/TTR）时发送通知。 (Task:CheckStopWatchThresholds)
• 检查ticket SLA. 到达限制的单据将进入升级TTO/TTR状态。
• 自动备份。
• 自动删除在一个对象创建或编辑时被取消期间的无用附件和插入的图片 (Task: InlineImageGC 每小时运行)
• 异步的电子邮件。默认情况下，该选择处于禁用状态。要启用它，将配置文件里'email_asynchronous'参数设置为 1。(Task: ExecAsyncTask)
  
  

许多扩展插件也依赖于cron文件，例如，从邮件创建单据，自动审批，联系客户等

Windows上的调度安排

使用schedtask.exe 或者用 'at' 命令安排cron.php 每5分钟执行一次。

schtasks.exe /create /sc minute /mo 5 /tn "iTop CRON" /tr "\"/var/www/itop/webservices/cron.cmd\""


Linux上的调度安排

编辑 crontab 每5分钟执行一次脚本:

*/5 * * * * www-data /usr/bin/php /var/www/html/itop/webservices/cron.php --param_file=/etc/itop/params >>/var/log/itop-cron.log 2>&1

不要使用root用户运行cron.php！

从网站调度安排

也可以通过网页 服务器执行 cron.php。如果你无权限访问系统（例如在共享主机上），这将非常有用。在这种情况下，你可以依靠一个Web cron服务调用它。但同本地计划任务相比，频率和执行次数可能会受到限制。

参数

参数	描述	默认值
param_file	参数文件的路径	cron.params
auth_user	用户登录 - 仅CLI 模式，如果未使用参数文件	-
auth_pwd	用户密码 - 仅CLI 模式，如果未使用参数文件	-
verbose	如果设置为1，将提供更多信息，请使用此信息进行故障排除。请注意：由于该进程在后台连续运行，因此日志文件往往很快就会变得很大。请勿长时间将此选项设置为1。	0
status_only	(iTop 2.0.1中的新增功能) 如果设置为1，则会显示有关计划任务的状态，并且该过程将立即停止（可以在cron.php正常执行时被执行）	0

参数文件

由于在命令行上传递给cron.php的参数对系统上的其他用户可见，因此建议的做法是将所有敏感参数从命令行移开。这就是“参数文件”的目的。

参数param_file可以与大多数REST / CLI Web服务一起使用。按照约定，cron.php服务搜索参数文件名«cron.params»以读取其参数。

• 参数文件包含键/值对
• 注释以＃开头（在＃之后找到的任何字符都将被忽略）
  
  

iTop软件包包含一个名为cron.distrib的文件，该文件可用作创建自己的参数文件的模板。

例如：

[ ttps://www.itophub.io/wiki/page?do=export_code&id=2_6_0%3Aadmin%3Acron&codeblock=2]cron.params[/url]


# This is a parameter file## If a parameter is given both in the file and in the arguments,# then the value given as argument is retained# # Authenticationauth_user = qwertyuiopauth_pwd = ded!catedL0g1n # My web servicesize_min = 20 # Megabytestime_limit = 40 # Minutes

确保无法从网上访问参数文件 ！可以将其移动到Web服务器范围之外的目录中（例如， /etc/itop/在Linux系统上将是一个不错的位置），或者在Web服务器的配置中制定特殊的排除规则。只有从命令行运行cron.php的进程才能访问此文件。

设定值

这些设置已配置到主要的iTop配置文件中：“itop-config.php”

设置	描述	默认值
cron_max_execution_time	cron.php页面的持续时间（秒），必须短于php设置max_execution_time且短于Web服务器响应超时要求	600
cron_sleep	cron.php再次检查是否必须执行某些操作之前的持续时间（秒）	2
email_asynchronous	如果设置为1，则电子邮件将离线发送，这需要激活cron.php。例外：电子邮件测试实用程序等某些功能将强制执行序列化模式 If set to 1, the emails are sent off line, which requires cron.php to be activated. Exception: some features like the email test utility will force the serialized mode	0

授权用户Allowed users

只允许管理员执行 cron.php.

排除故障

当任务不再运行时，需要了解以下几点：

cron.php在做什么?

• cron.php程序启动后，要求实现该php接口的任务，并将其记录在priv_backgroundtask表中。
• 该表中存在的条目取决于安装的iTop扩展。
• priv_backgroundtask 包含每个任务的多个信息，例如：
  
  
  • 当它最后一次运行时,
  • 下一次运行应该何时开始，
    
  • 该任务的平均执行时间是多少？
    
  • 当前管理员要求的任务是active还是 paused（字段状态）
    
  • …
    
• cron.php程序，查找活动的任务并通过下一次运行
  
  
  • 一个接一个地执行任务，又要求每个任务停止执行在超过 cron_max_execution_time之后。该任务当然会在有意义的时候停止，例如对于Mail To Ticket Automation，它可以在处理2个收到的邮件之间停止。
  • 在下一次运行时要求任务将该信息存储在表中，
    
• 然后，它检查自身启动cron_max_execution_time是否大于 ，如果是，它会自己停止（这是因为 的进程通常会消耗未完全释放的内存）
• 否则，它会等待一cron_sleep秒钟，然后再次检查表以查找准备好执行的任务。
  
  

当...

一个任务似乎永远不会执行：

当特定任务遇到使其陷入无限循环的问题时，cron.php可能会被php的max_execution_time参数停止（通常在CLI中运行时不会停止 ）；在所有情况下，紧随其后的任务将永远不会执行。在cron.php接下来的运行中，由于任务总是以相同的顺序执行，因此可能会再次出现相同的问题。为了识别故障任务，您应该 暂停 通过在priv_backgroundtask表中设置它们的状态来查看一个怀疑有此问题的任务， 然后再查看是否停止了该故障任务。这种情况通常是由于扩展程序带来的错误所致，该任务面临非计划的情况。

日志文件应该被监控以生成警报，以提前通知此类问题。

2_6_0/admin/cron.txt · Last modified: 2019/01/09 16:40 (external edit)

后台任务

为了正常运行，必须定期执行iTop维护操作和异步任务。为了简化安装，已将所有的后台任务集中到单一文件（webservices/cron.php）中运行。

以下功能依靠cron.php的激活：

• Notification(通知) 如果没有调用该web服务，则不会在单据到达阈值（TTO/TTR）时发送通知。 (Task:CheckStopWatchThresholds)
• 检查ticket SLA. 到达限制的单据将进入升级TTO/TTR状态。
• 自动备份。
• 自动删除在一个对象创建或编辑时被取消期间的无用附件和插入的图片 (Task: InlineImageGC 每小时运行)
• 异步的电子邮件。默认情况下，该选择处于禁用状态。要启用它，将配置文件里'email_asynchronous'参数设置为 1。(Task: ExecAsyncTask)
  
  

许多扩展插件也依赖于cron文件，例如，从邮件创建单据，自动审批，联系客户等

Windows上的调度安排

使用schedtask.exe 或者用 'at' 命令安排cron.php 每5分钟执行一次。

schtasks.exe /create /sc minute /mo 5 /tn "iTop CRON" /tr "\"/var/www/itop/webservices/cron.cmd\""


Linux上的调度安排

编辑 crontab 每5分钟执行一次脚本:

*/5 * * * * www-data /usr/bin/php /var/www/html/itop/webservices/cron.php --param_file=/etc/itop/params >>/var/log/itop-cron.log 2>&1

不要使用root用户运行cron.php！

从网站调度安排

也可以通过网页 服务器执行 cron.php。如果你无权限访问系统（例如在共享主机上），这将非常有用。在这种情况下，你可以依靠一个Web cron服务调用它。但同本地计划任务相比，频率和执行次数可能会受到限制。

参数

参数	描述	默认值
param_file	参数文件的路径	cron.params
auth_user	用户登录 - 仅CLI 模式，如果未使用参数文件	-
auth_pwd	用户密码 - 仅CLI 模式，如果未使用参数文件	-
verbose	如果设置为1，将提供更多信息，请使用此信息进行故障排除。请注意：由于该进程在后台连续运行，因此日志文件往往很快就会变得很大。请勿长时间将此选项设置为1。	0
status_only	(iTop 2.0.1中的新增功能) 如果设置为1，则会显示有关计划任务的状态，并且该过程将立即停止（可以在cron.php正常执行时被执行）	0

参数文件

由于在命令行上传递给cron.php的参数对系统上的其他用户可见，因此建议的做法是将所有敏感参数从命令行移开。这就是“参数文件”的目的。

参数param_file可以与大多数REST / CLI Web服务一起使用。按照约定，cron.php服务搜索参数文件名«cron.params»以读取其参数。

• 参数文件包含键/值对
• 注释以＃开头（在＃之后找到的任何字符都将被忽略）
  
  

iTop软件包包含一个名为cron.distrib的文件，该文件可用作创建自己的参数文件的模板。

例如：

[ ttps://www.itophub.io/wiki/page?do=export_code&id=2_6_0%3Aadmin%3Acron&codeblock=2]cron.params[/url]


# This is a parameter file## If a parameter is given both in the file and in the arguments,# then the value given as argument is retained# # Authenticationauth_user = qwertyuiopauth_pwd = ded!catedL0g1n # My web servicesize_min = 20 # Megabytestime_limit = 40 # Minutes

确保无法从网上访问参数文件 ！可以将其移动到Web服务器范围之外的目录中（例如， /etc/itop/在Linux系统上将是一个不错的位置），或者在Web服务器的配置中制定特殊的排除规则。只有从命令行运行cron.php的进程才能访问此文件。

设定值

这些设置已配置到主要的iTop配置文件中：“itop-config.php”

设置	描述	默认值
cron_max_execution_time	cron.php页面的持续时间（秒），必须短于php设置max_execution_time且短于Web服务器响应超时要求	600
cron_sleep	cron.php再次检查是否必须执行某些操作之前的持续时间（秒）	2
email_asynchronous	如果设置为1，则电子邮件将离线发送，这需要激活cron.php。例外：电子邮件测试实用程序等某些功能将强制执行序列化模式 If set to 1, the emails are sent off line, which requires cron.php to be activated. Exception: some features like the email test utility will force the serialized mode	0

授权用户Allowed users

只允许管理员执行 cron.php.

排除故障

当任务不再运行时，需要了解以下几点：

cron.php在做什么?

• cron.php程序启动后，要求实现该php接口的任务，并将其记录在priv_backgroundtask表中。
• 该表中存在的条目取决于安装的iTop扩展。
• priv_backgroundtask 包含每个任务的多个信息，例如：
  
  
  • 当它最后一次运行时,
  • 下一次运行应该何时开始，
    
  • 该任务的平均执行时间是多少？
    
  • 当前管理员要求的任务是active还是 paused（字段状态）
    
  • …
    
• cron.php程序，查找活动的任务并通过下一次运行
  
  
  • 一个接一个地执行任务，又要求每个任务停止执行在超过 cron_max_execution_time之后。该任务当然会在有意义的时候停止，例如对于Mail To Ticket Automation，它可以在处理2个收到的邮件之间停止。
  • 在下一次运行时要求任务将该信息存储在表中，
    
• 然后，它检查自身启动cron_max_execution_time是否大于 ，如果是，它会自己停止（这是因为 的进程通常会消耗未完全释放的内存）
• 否则，它会等待一cron_sleep秒钟，然后再次检查表以查找准备好执行的任务。
  
  

当...

一个任务似乎永远不会执行：

当特定任务遇到使其陷入无限循环的问题时，cron.php可能会被php的max_execution_time参数停止（通常在CLI中运行时不会停止 ）；在所有情况下，紧随其后的任务将永远不会执行。在cron.php接下来的运行中，由于任务总是以相同的顺序执行，因此可能会再次出现相同的问题。为了识别故障任务，您应该 暂停 通过在priv_backgroundtask表中设置它们的状态来查看一个怀疑有此问题的任务， 然后再查看是否停止了该故障任务。这种情况通常是由于扩展程序带来的错误所致，该任务面临非计划的情况。

日志文件应该被监控以生成警报，以提前通知此类问题。

2_6_0/admin/cron.txt · Last modified: 2019/01/09 16:40 (external edit)