Tiki经理

Tiki Manager允许您管理Tiki的各种实例。您可以安装、升级、备份、克隆、检查文件完整性以及执行各种其他操作。这可以在同一台服务器或远程服务器上完成。大多数操作都可以在cron作业上无人值守运行。它可以通过命令行或web界面使用。

Tiki经理取代装饰.

即将到达蒂基25:Tiki管理器包

要求

• SQLite3公司用于数据存储
• 带有命令行访问（CLI）的PHP 7.4+。（之前2023-07-04，需要PHP 7.1

它使用Symfony控制台组件.

• 它使用作曲家用于依赖关系管理。
• 吉特
• rsync、unzip等标准服务器工具。
• 它是在GNU/Linux上开发的，设计用于PHP、SQLite和Git可用的任何地方（Windows、MacOS、*BSD等）

你可以使用检查验证服务器是否可以运行Tiki或Tiki Manager

安装

这些是Linux的一般说明。您可能需要适应您的操作系统。另请参见其他配置如下所示。

在高水平上：

1. 使用服务器检查查看并获取所有服务器依赖项
2. 从Git中获取不可web访问的目录中的代码：https://gitlab.com/tikiwiki/tiki-manager.git
3. 使用运行Tiki Managerphp tiki-manager.php以完成设置。它将指导您如何执行此操作（例如：运行Composer以获取PHP依赖项）

示例命令（在Debian 9上对我有效)

#导航到您的工作目录（__Do not install in a web accessable directory__）并运行以下git命令$git克隆--深度1--分支主节点https://gitlab.com/tikiwiki/tiki-manager.git#使用“cd tiki-manager”导航到tiki-mmanager目录#然后运行以下命令。第一次运行时，它将完成设置（获取Composer并获取PHP依赖项、创建SQLite数据库等）$php tiki-manager.php管理器：信息

文档

下面是可以使用的基本命令的简要说明。所有命令都遵循向导模式。

php tiki-manager.php实例：创建--help

实例

实例：创建

添加要由Tiki Manager管理的实例，这可能意味着：

• 创建一个新的Tiki实例（包括一个数据库），从Git（也可以是SVN）获取文件
• 或检测通过Git或Subversion（SVN）安装的现有Tiki并“采用”它。
• 您可能需要将Tiki实例从FTP转换为吉特.

参数

php tiki-manager.php实例：创建

非交互式命令：

php tiki-manager.php实例：创建--type=local--url=http://manager.tiki.org--name=manager.tiki.org--电子邮件=manager@example.org--webroot=/www/manager--tempdir=/tmp/trim_temp--branch=branches/19.x--备份用户=www数据--备份组=www数据--备份权限=750--db主机=localhost--db用户=root--db pass=secret--db前缀=manager

实例：列表

php tiki-manager.php实例：列表

实例：访问

向远程主机打开shell。
由于Tiki Manager管理所有连接，因此使用此命令可以避免记住密码。

参数

php tiki-manager.php实例：访问

实例：备份

Tiki Manager执行Tiki实例的完整备份。
备份包括远程主机上的所有文件（使用rsync进行有效的带宽管理）（包括用户文件和存储在web根目录之外的文件）以及数据库的转储。每个备份都作为.tar.bz2文件存档在backup/archive文件夹中，Tiki Manager安装在该文件夹中。
备份文件包含：

• manifest.txt：指示文件夹在远程主机上的位置
• database_dump.sql：自我解释
• [a-f0-9]{32}：使用哈希命名的文件夹。远程主机上文件夹的内容。manifest.txt文件列出了这些散列。

参数

php tiki-manager.php实例：备份

实例：空白

比如：创建但实际上没有添加Tiki。它只创建一个实例，可以用来恢复或克隆另一个实例。

php tiki-manager.php实例：空白

php tiki-manager.php实例：创建空白

实例：检出

CheckoutCommand：允许签出主Tiki co的特定Git分支和修订例如，降低主题或在本地签出主题。原始提交.

参数

php tiki-manager.php实例：签出

这对于在Git中管理的主题

实例：克隆

制作Tiki的另一个相同副本。这基本上是在一个操作中进行备份和恢复的组合。
目标实例可以是空白的，也可以是另一个配置和管理的Tiki实例。在使用现有的另一个Tiki实例时，请务必小心，因为此处的数据将被擦除并替换为源实例中的数据。

由于两个具有相同设置的Tiki实例（例如：都指向相同的Elasticsearch索引可能会导致问题），建议阅读：分期开发生产中的不同偏好

克隆过程中不包括以下内容：

• db/local.php（数据库访问信息需要指向另一个数据库）
• 用于的.ini.php文件（如果有）系统配置

参数

php tiki-manager.php实例：克隆

实例：cloneandredact

此命令允许您克隆实例并编辑克隆，
克隆一个实例并对其进行编辑。

参数

php tiki-manager.php实例：cloneandredact

实例：cloneandupgrade

比如：克隆，但需要额外的升级操作。

由于两个具有相同设置的Tiki实例（例如：都指向相同的Elasticsearch索引可能会导致问题），建议阅读：分期开发生产中的不同偏好

克隆过程中不包括以下内容：

• db/local.php（数据库访问信息需要指向另一个数据库）
• 用于的.ini.php文件（如果有）系统配置

参数

php tiki-manager.php实例：cloneandupgrade

实例：控制台

允许运行任何慰问Tiki的命令。

php tiki-manager.php实例：控制台

清除缓存的示例（它将请求实例ID）：

php tiki-manager.php实例：控制台--命令=“缓存：清除所有”

所选实例的示例：

php tiki-manager.php-instance:console--instances=5--command=“cache:clear all”

实例：copysshkey

将SSH密钥复制到远程实例。这是作为其他命令的一部分使用的，但也可以单独使用-通过询问您要连接的密码，将Tiki Manager SSH密钥复制到远程计算机，以便Tiki Manager可以通过其公钥/私钥对进行身份验证，并跳过对所有后续操作的密码询问。

php tiki-manager.php实例：copysshkey

实例：删除

通过命令行删除实例（也可以通过web界面删除）。这不会删除您的Tiki。它只是删除与它的实例连接。

php tiki-manager.php实例：删除

实例：检测

检测Tiki分支或标记以及PHP版本。出于调试目的。如果您手动进行svn切换，并且Tiki Manager需要更新有关Tiki实例的内部数据库，也很有用。

php tiki-manager.php实例：检测

实例：编辑

允许修改实例。

php tiki-manager.php实例：编辑

实例：修复权限

使用自动参数在远程主机上运行setup.sh。它在大多数情况下都应该有效。如果命令建议使用my setup.sh而不需要参数或超级用户权限，则应使用“instance:access”手动连接到远程主机。

php tiki-manager.php实例：修复权限

实例：导入

如果检测到Tiki实例，并且该实例尚未由Tiki Manager管理，请将其导入实例列表。

参数

php tiki-manager.php实例：导入

非交互式命令：

php tiki-manager.php实例：导入--type=local--url=http://manager.tiki.org--name=manager.tiki.org--电子邮件=manager@example.org--webroot=/www/manager--tempdir=/tmp/trim_temp

实例：维护

将实例置于维护或实时模式。

php tiki-manager.php实例：维护

实例：补丁

https://gitlab.com/tikiwiki/tiki-manager/-/merge_requests/271

实例：补丁：列表

php tiki-manager.php实例：补丁：列表

实例：修补程序：删除

php tiki-manager.php实例：补丁：删除

实例：修补程序：应用

php tiki-manager.php实例：补丁：应用

GitLab和GitHub都支持Merge/Pull请求的补丁和差异输出：

• https://patch-diff.githubusercontent.com/raw/jasonmunro/cypht/pull/548.patch
• https://patch-diff.githubusercontent.com/raw/fintech-systems/virtualmin-api/pull/19.diff
• https://gitlab.com/tikiwiki/tiki/-/merge_requests/1245.补丁

例子：

php tiki-manager.php实例：补丁：应用https://gitlab.com/tikiwiki/tiki/-/merge_requests/1245.补丁

实例：配置文件：应用

将配置文件应用于实例。

php tiki-manager.php实例：配置文件：应用

实例：恢复

在空白安装上恢复。Ref:instance:blank如果您有未存储在数据库中的数据文件，则应使用理想的场景来存储数据文件和相对路径。

php tiki-manager.php实例：恢复

实例：还原

将特定实例的工作目录恢复到其原始分支状态（也称为git硬重置）。因此，它会删除所有应用的补丁

php tiki-manager.php实例：还原

实例：setup-scheduler-cron

此命令允许您启用cron来运行调度程序

php tiki-manager.php实例：setup-scheduler-cron

它可以交互使用，也可以不交互使用。前任。：

php tiki-manager.php实例：setup-scheduler-cron-i 1--time=“*/10***”

可能的选项：

--update//更新现有cronjob--enable//从cronjob行取消#注释--使用#cronjob行禁用//注释--检查//只检查是否配置了cronjob

该命令对运行Windows的实例无效。

实例：统计

从选定实例中提取统计信息（KPI）作为csv。可以选择将该信息推送到另一个Tiki实例。

参数

#显示所有实例统计信息php tiki-manager.php实例：统计

#将统计信息保存到csv文件php tiki-manager.php实例：stats--instances=all--file=instance_stats.csv

#将实例统计信息上传到另一个tiki实例#使用TIKI_ROOT将匹配实例webrootphp tiki-manager.php实例：stats--instances=all--exclude=1--file=tiki_ROOT/temp/instance_stats.csv--push-to=1

实例：更新

• 首先进行dry-run，然后中止任何冲突
• 使用svn-up更新该分支（或主干）中的最新代码，从而合并任何更改
• 所有操作都应该在更新代码后完成
  • 相应地更新文件哈希。如果对实例进行了修改，哈希验证/更新可能会提示某些包含冲突的文件。
  • 执行数据库更新。
  • 运行setup和Composer，
  • 清除缓存
  • 重建搜索索引

在更新过程中，使用.htaccess文件（保留前一个文件）禁用实例，使站点在更新完成之前不可用。

参数

php tiki-manager.php实例：更新

实例：升级

与更新类似。请求分支切换到更新。您将有多种分支机构可供选择。请注意，您应该不是降级，因为Tiki不支持降级数据库脚本。升级是一条单行道！您应该在升级前进行备份，以便在出现问题时可以返回到此版本。

如果您选择手动升级（使用svn开关）。

参数

php tiki-manager.php实例：升级

实例：验证

这相当于安全数据库请检查，但它更安全，因为它是由受信任的主机制作的，并且会考虑到您在主机上的自定义修改。第一次运行时，检查将询问从何处获取散列。
参数

php tiki-manager.php实例：验证

实例：监视

此命令执行哈希检查（实例：verify）。如果发生可疑的文件更改（可能是入侵或合法更改服务器上文件的人），脚本将提示联系人电子邮件地址以通过日志通知。

参数

php tiki-manager.php实例：监视

备份

备份：设置

等同于管理器：设置备份.

php tiki-manager.php备份：设置

备份：删除

删除Tiki Manager备份文件夹和内容。此文件夹包含由Tiki Manager管理的实例的备份。

php tiki-manager.php备份：删除

隐藏物

缓存：清除

删除Tiki Manager缓存文件夹。对开发有用。

php tiki-manager.php缓存：清除

数据库

数据库：删除

• 删除Tiki Manager数据库。对开发有用。

php tiki-manager.php数据库：删除

数据库：视图

• 查看Tiki Manager数据库。用于调试目的，对开发有用。

php tiki-manager.php数据库：视图

日志

日志：清除

清除Tiki Manager日志文件夹。

php tiki-manager.php日志：清除

经理

经理：信息

• 显示Tiki Manager使用的运行OS、PHP版本和二进制文件

php tiki-manager.php管理器：信息

经理：检查

• 检查操作系统要求以执行Tiki Manager

php tiki-manager.php管理器：检查

管理器：报告

• 报告，并使用数据通道将报告发送到Tiki实例。

php tiki-manager.php管理器：报告

管理器：setup-clone

• 设置cronjob以执行实例克隆。

php tiki-manager.php管理器：setup-clone

经理：测试发送电子邮件

• 测试发送电子邮件。

php tiki-manager.php管理器：测试发送电子邮件

tiki:版本

• 显示Tiki的所有版本。

php tiki-manager.php tiki:版本

管理器：重置

• 删除Tiki Manager备份、缓存和日志文件。对开发有用。

php tiki-manager.php管理器：重置

管理器：设置备份

设置cronjob以每天在特定时间执行自动实例备份（实例：备份）。脚本将提示运行cron的时间以及这些自动备份将忽略的实例（默认情况下选择所有实例）。

• 自动备份cronjob不应与“manager:setup-update”cron-job命令同时运行。确保选择不同的运行时间。

参数

php tiki-manager.php管理器：安装备份

管理器：设置更新

设置cron作业以每天在特定时间执行自动实例更新（实例：更新）。脚本将提示运行cron的时间以及受此自动更新影响的实例。

参数

php tiki-manager.php管理器：设置更新

管理器：setup-watch

在Tiki Manager主机上设置一个cron作业，每天自动执行哈希检查（instance:verify）。如果发生可疑的文件更改（可能是入侵或有人合法更改了服务器上的文件），脚本将提示输入一个联系人电子邮件地址，以便与日志一起通知脚本应该运行的时间。

参数

php tiki-manager.php管理器：setup-watch

管理器：更新

将Tiki Manager更新到可用的最新版本。这将更新Git中的PHP代码，并更新Composer依赖项。

参数

php tiki-manager.php管理器：更新--检查

php tiki-manager.php管理器：更新-y

对于安装（不带Phar或Git），要启用更新，请添加以下文件.版本Tiki-Manager根。

{“版本”：“bf63ffa”，“日期”：“2020-05-03T23:32:58+01:00”}

其他配置

要轻松配置Tiki Manager应用程序，请将`.env.dist`文件复制到`.env`并插入未注释（#）项的配置。

版本控制系统

默认情况下，Tiki Manager使用git和公共存储库。如果您想使用SVN（但不应该使用SVN，因为不再支持SVN）作为默认vcs或其他存储库，请在.env文件中使用以下行。

默认值_VCS=svnGIT_TIKIWIKI_URI=<CUSTOM_GIT_REPOSITORY_URL>SVN_TIKIWIKI_URI=<CUSTOM_SVN_REPOSITORY_URL>

在代理后面或没有互联网连接

当没有连接到GitLab或SourceForge等外部服务器时，Tiki Manager可以使用Tiki的分布式版本包作为替代方案。

将默认VCS设置为src，Tiki Manager将使用data/Tiki_src文件夹中的现有包（默认）。

默认_VCS=src

从以下站点下载分布式Tiki软件包https://sourceforge.net/projects/tikiwiki/files网站/，并将它们保存到data/tiki_src文件夹中。

电子邮件设置

要配置Tiki Manager电子邮件发件人地址，请在.env文件中添加以下行。

FROM_EMAIL_ADDRESS=<发件人_EMAIL-ADDRESS>

配置SMTP服务器

默认情况下，Tiki Manager使用sendmail发送电子邮件通知。如果您打算使用SMTP，请在.env文件中添加以下行。

SMTP_HOST=<服务器_ADDRESS>SMTP_PORT=<服务器端口>SMTP_USER=（如果需要身份验证，则为可选）SMTP_PASS=（如果需要身份验证，则为可选）

Web管理器设置

如果要设置默认文件夹以安装web manager或apache user:group与apache:apache不同，则可以将以下设置添加到.env文件中。

WWW_PATH=<WEB_MANAGER_FOLDER>WWW_USER=<APACHE_USER>WWW_GROUP=<APACHE_GROUP>

要更改Web Manager上失败登录尝试的最大次数，请将以下设置添加到.env文件中。

MAX_FAILED_LOGIN_ATTEMPTS=<数字>

长时间运行操作期间的超时

在长时间操作（如克隆或克隆和升级）期间，您可能会收到HTTP错误代码503，并显示消息“Service Unavailable”，您可以将Apache的代理超时时间增加到更合适的值。
要在虚拟主机级别执行此操作（因此仅为tiki管理器启用），您需要执行以下操作：

添加Apache指令代理超时到Tiki Managers VirtualHost配置文件。
例子：代理超时300将代理超时设置为5分钟

挂钩

Tiki经理自2024-02-08支持hook系统，在命令之前或之后执行脚本（shell脚本）。
这对于执行备份加密或将备份移动到不同的文件夹，甚至触发通知都很有用。

每个命令都可以有前置和后置脚本。

请参阅功能请求中的更多上下文：https://gitlab.com/tikiwiki/tiki-manager/-/issues/22

添加挂钩

要在命令之前或之后添加要执行的脚本，需要将脚本文件添加到以下结构的文件夹中：
/hooks/<命令>/<操作>/<文件名>.sh

命令是正在执行的命令的名称，替换:具有-

在这个示例中，让我们创建一个执行后挂钩，例如：create command
路径将是/hooks/instance-create/post/notify.sh

挂钩变量

每个命令可以注册不同的变量。与实例交互的命令将添加实例属性。

INSTANCE_IDS#包含实例ID的列表，这些实例ID在环境变量中可用（以逗号分隔）INSTANCE_TYPE_<安装_ID>INSTANCE_VCS_TYPE_安装INSTANCE_NAME_<安装_ID>INSTANCE_WEBROOT_<INSTANCE-ID>INSTANCE_WEBURL_<安装_ID>INSTANCE_TEMPDIR_<INSTANCE-ID>INSTANCE_PHPEXEC_<INSTANCE-ID>INSTANCE_PHPVERSION_<安装_ID>INSTANCE_BACKUP_USER_<INSTANCE-ID>INSTANCE_BACKUP_GROUP_<INSTANCE-ID>INSTANCE_BACKUP_PERM_<INSTANCE-ID>INSTANCE_BRANCH_<INSTANCE-ID>INSTANCE_LAST_ACTION_<安装_ID>INSTANCE_LAST_ACTION_DATE_<INSTANCE-ID>

每个命令的附加变量

实例：修补程序：应用

INSTANCE_BACKUP_FILE_安装_备份_文件补丁程序包补丁_ URL

实例：备份

INSTANCE_BACKUP_FILE_安装_备份_文件

实例：克隆

源_INSTANCE_ID源_安装_备份

实例：维护

INSTANCE_MAINTENANCE_STATUS_安装

实例：配置文件：应用

实例_配置文件

实例：setup-scheduler-cron

INSTANCE_JOB_ENABLED_<INSTANCE-ID>INSTANCE_JOB_TIME_＜INSTANCE_ID＞INSTANCE_JOB_COMMAND_<INSTANCE-ID>

实例：统计

INSTANCE_STATS_

实例：升级

INSTANCE_PREVIOUS_BRANCH_<INSTANCE-ID>

实例：监视

INSTANCE_REVISION_<安装_ID>INSTANCE_REVISION_ERROR_<安装_ID>

其他注释

Tiki经理vs MultiTiki

使用实例：控制台命令，您可以访问远程实例中的multitiki命令，如下所示。假设我们使用的是实例#42，虚拟域是example.com，并且每个分支都在同一目录中（即。tiki/分支/20.x和tiki/分支/21.x在这个例子中。

细节

$php tiki-manager.php实例：控制台-i42-c'multitiki:list/20.x英寸tiki-dev/21.x中的调用命令结果：example.comstaging.example.com其他.example.com

$php tiki-manager.php实例：console-i42-c'multitiki:move example.com/20.x英寸tiki-dev/21.x中的调用命令结果：将把：/home/auser/tiki/brances/20.x/db/example.com移到/home/auster/tiki/brances/21.x/db/example.com将把：/home/auser/tiki/brances/20.x/dump/example.com移到/home/auser/tiki/frances/21.x/dump/example.com将把：/home/auser/tiki/brances/20.x/img/wiki/example.com移到/home/auster/tiki/brances/21.x/img/wiki/example.com将把：/home/auser/tiki/brances/20.x/img/wiki_up/example.com移到/home/auser/tiki/frances/21.x/img/wiki_up/example.com将把：/home/auser/tiki/brances/20.x/img/trackers/example.com移到/home/auster/tiki/brances/21.x/img/trackers/example.com将把：/home/auser/tiki/brances/20.x/modules/cache/example.com移到/home/auster/tiki/brances/21.x/modumes/cache/example.com将把：/home/auser/tiki/brances/20.x/temp/example.com移到/home/auster/tiki/brances/21.x/temp/example.com将把：/home/auser/tiki/brances/20.x/temp/cache/example.com移到/home/auster/tiki/brances/21.x/temb/cache/example.com将把：/home/auser/tiki/brances/20.x/temp/public/example.com移到/home/auster/tiki/brances/21.x/temp/public/example.com将把：/home/auser/tiki/brances/20.x/templates/example.com移到/home/auster/tiki/brances/21.x/tembrates/example.com将把：/home/auser/tiki/brances/20.x/themes/example.com移到/home/auser/tiki/frances/21.x/themes/example.com将移动：/home/auser/tiki/branches/20.x/whilp/example.com到/home/auser/tiki/branches/21.x/whilp/example.com将把：/home/auser/tiki/brances/20.x/mods/example.com移到/home/auser/tiki/frances/21.x/mods/example.com将把：/home/auser/tiki/brances/20.x/files/example.com移到/home/auster/tiki/brances/21.x/filess/example.com将把：/home/auser/tiki/brances/20.x/tiki_tests/tests/example.com移到/home/auster/tiki/brances/21.x/tiki测试/tests/example.com使用--confirm执行移动

故障排除

如果您有奇怪的错误和/或无法更新，可能是

• Tiki Manager依赖关系混乱。只需删除供应商/目录并重试（Tiki Manager将重新下载它们）
• 您已经修改了代码。您可以与联系git状态和差异比较

源代码

源代码在此处进行管理：
https://gitlab.com/tikiwiki/tiki-manager网站/

路线图

• 经理

相关的

• https://wikisuite.org/Virtualmin-Tiki-Manager网站

• Tiki经理