橙色人力资源管理 | TurnKey GNU/Linux

橙色人力资源管理升级

假设和限制

橙色人力资源管理和TurnKey基操作系统

这个文件明确涵盖将橙色人力资源管理 v4.x(TurnKey v17.x)和/或橙色人力资源管理 v5.x(TurnKey v18.x)升级为最新的橙色人力资源管理稳定发布(在撰写本报告时为v5.7). 不错 NOT 密码 覆盖将基础的TurnKey/Debian OS升级到最新发布的版本.

TurnKey v17.x基于Debian 11/Bullseye. Bullseye目前处于"LTS"(长期支持)状态,至少会收到安全更新,直到 2026年8月31日 (中文(简体) ).. TurnKey v18.x 是基于 Debian 12/Bookdrom. 书虫至少会得到支持,直到 2028年6月30日 (中文(简体) )..

医生还假定:

TKLBAM是启用的(或者您启用) - 注意这并非必要,而是被高度推荐的.
您的服务器有足够的自由空间进行升级 - 2GB被推荐, 但更多的总是更好的。

此 doc 在大多数过程中使用终端命令。许多步骤可以通过 Webmin 实现, 但终端命令简洁, 并且可以复制/ 粘贴, 所以很容易遵循。任何步骤,如果你知道如何通过Webmin实现同样的结果,可以随意使用.

建议您通过“ SSH”(安全壳)访问您的 TurnKey 服务器的 CLI 。最近的Windows 11发布,Mac OSX和所有Linux桌面风味全部装有OpenSSH客户端的飞船预先安装,但有一些替代的SSH客户端也运作良好.

或者在 TurnKey v17.x 上,您可以通过您的浏览器使用您的服务器的“ Webshell ” ; https on port 12320. E. TurnKey v18.x上,您可以使用Webmin“合适的”交互式终端模块(v18.x不包括WebShell).

Do NOT使用 TurnKey v17.x Webmin终端! 它不是一个真正的交互式终端,将造成问题.

一般来说,本地的SSH客户端会给用户更好的体验(例如. 复制/粘贴应该可靠工作),但v17.x的Webshell或v18.x的Webmin交互式终端模块应该工作精良.

启动 SSH 会话:

ssh root@DOMAIN_OR_PUBLIC_IP

如果您使用认证密钥而不是密码, 您可能需要在本地系统中明确包含私有密钥的路径 :

# Linux/OSX
ssh -i ~/path/to/my_private_key root@DOMAIN_OR_PUBLIC_IP

# Windows
C:\Users\ME\path\to\my_private_key root@DOMAIN_OR_PUBLIC_IP

AWS 采购网用户的说明

AWS 市场实例默认禁用 " root " 账户。所以启用根或登录为“admin”然后变成这样:

sudo su -

第一步----准备

在开始橙色人力资源管理升级之前,确保您拥有当前备份和足够的空闲空间. 我还建议您在开始升级前, 更新所有系统包并重新启动系统。

备份

我建议既建立一个“弹幕”又建立一个“适当”的后援。截图在技术上不是备份,但装入截图是快速和容易的方式,如果需要,可以回到你现在的确切位置。

如果您的服务器正在运行于 TurnKey Hub , 您可以通过 Hub 触发快照 “服务器”页请注意, 完成这项工作需要一些时间。其他虚拟化/ 云层平台也应该有这种功能：如果您不确定如何完成, 请查阅相关文件。裸体金属服务器可以使用诸如克洛尼西利亚.

假设您正在使用 TKLBAM, 手动触发您的服务器的 TKLBAM 完整备份。您可以通过 Webmin 或通过终端进行 :

tklbam-backup --full-backup now

检查空闲空间, 必要时清理

检查空闲空间 :

df -h /

示例输出( Hub 服务器, 带有 10GB 根卷) :

Filesystem                Size   Used Avail Use% Mounted on
/dev/xvda                 10.0G  2.1G  8.0G  21% /

观察“Avail”栏(以上示例中的8.0G ) 。我建议至少1GB 最小自由空间,最好是至少2GB 。如果您没有足够的, 请先按下面的顺序清理。请在第二个( 自動移動) 命令上盲目输入 NOT :

apt clean
apt autoremove

`自动移动 ' 命令只应列出几个软件包,可能包括旧内核(以QQ0X-image开头的软件包)。如果它列出大量软件包或列出任何核心软件包,请确认检查它们的功能,如果有引起担心,您可以手动删除显示的软件包安全删除使用“ apt remove PKG1 PKG2... ” 。如果您有顾虑且有足够的空闲空间, 请暂时跳过此步骤。

OS软件升级(可选)

将系统软件更新到最新的包装版本:

apt update
apt upgrade

如果您真的运行了这一步骤, 我建议重新运行以上的清理命令, 重新启动您的服务器, 并双检查空闲空间。

手动本地备份( 可选)

既有快照又有TKLBAM备份,制作 另外一个 备份可能看起来是过度的,不过我还是认为多层冗余总是可取的。如果出了问题,您有多种恢复选项和路径来恢复功能。无论如何,这一步骤完全是可选的,快照和完整的TKLBAM备份提供了充分的恢复选项.

手动 DB 垃圾堆

mysqldump orangehrm > orangehrm_db.sql.orig

将橙色人力资源管理v4.x升级为v4.10.1

编写时最新发布的OrangeHTML版本为v5.7. 但你必须运行v4.10.1(最新版本 v4.x)才能升级为v5.x. 如果您已经运行 v4. 10.1 或稍后, 请跳过此步骤。

橙色人力资源管理升级文档但我会提供更详细的和TurnKey 具体的一步一步。

下载 v4.10.1

wget https://sourceforge.net/projects/orangehrm/files/stable/4.10.1/orangehrm-4.10.1.zip

移动已有安装

mv /var/www/orangehrm /var/www/orangehrm.orig

解包新版本

unzip orangehrm-4.10.1.zip
mv orangehrm-4.10.1 /var/www/orangehrm

给网络服务器写入所需的橙色人力资源管理文件:

chown -R www-data:www-data /var/www/orangehrm/lib/{confs,logs}
chown -R www-data:www-data /var/www/orangehrm/symfony/{config,apps/orangehrm,cache,log}

获取现有的 DB 用户密码( 从旧配置文件) :

grep -m 1 password /var/www/orangehrm.orig/symfony/config/databases.yml

安装并启用 php zip 扩展 :

apt install --yes php-zip
systemctl restart apache2

在您的网页浏览器中装入升级页面

在您的网页浏览器中打开浏览您的橙色人力资源管理网站域名的“升级”页面:

https://DOMAIN_OR_PUBLIC_IP/upgrader/web

举例来说:

https://orangehrm.domain.com/upgrader/web

除非您想要安装“ 干净” 的 DO NOT , 否则您只需加载您的域名, 而不包含 X/upgrader/webX。否则它会覆盖您现有的数据。

输入 DB 细节

Host*:          127.0.0.1
Port:           3306
Username*       orangehrm
Password        <password from the above 'grep' command>
Database Name:  orangehrm

然后单击“成功”按钮。

系统检查

系统检查页面上有绿色“OK”。

假设一切都好,请单击“成功”按钮。

选择当前橙色人力资源管理版本

从下架开始,选择当前/老的橙色人力资源管理版本。除非你已经升级,TurnKey v17.1应该有橙色人力资源管理版本的‘4.9’。无论如何,您可以使用此命令确认当前/旧版本 :

grep -m 1 'OrangeHRM ver' /var/www/orangehrm.orig/CHANGELOG.TXT

默认情况下,它应返回:

New & Changed Features for OrangeHRM ver 4.9

选择相关版本,并单击“已成功”按钮。

应用手动修改 - 如果需要

下一页将显示您可能需要执行的任何手动步骤/ 更改。在我测试时, 唯一一个被提醒用于数据加密的手动步骤。

如果您启用了数据加密, 请从您旧的 OrangeHRM 目录复制密码密钥。例如 :

cp /var/www/orangehrm.orig/lib/confs/cryptokeys/key.ohrm /var/www/orangehrm/lib/confs/cryptokeys/

完成任何额外的手动步骤后,请单击“成功”按钮。

更新数据库

下一页将实际进行数据库升级。如前所述,升级可能需要一段时间,VERY很重要,在进度达到100%和“启动”按钮更改为“启动”之前,你不应关闭或重新装入该页面。 a “成功”按钮。

点击“启动”按钮,完成后,点击“成功”按钮。

创建新配置文件

下一页将生成新的配置文件。这一步骤不会花费很长时间, 但根据上一个数据库升级页面, DO NOT 关闭或重新加载该页面。

点击“启动”按钮,完成后,点击“成功”按钮。

完成升级

向您致意的网页是“恭喜!” ,指出您现在正在运行OrangeHRM v4.10.1。

如该页所述,确保任何人工步骤都完整(应在以前的“人工修改”步骤内处理,但可以从“人工修改”步骤中双倍检查。您的橙色人力资源管理目录中已注解的文件 :

cat /var/www/orangehrm/upgrader/log/notes.log

单击“成功”按钮。

校验您升级的橙色人力资源管理数据

上一个步骤之后,您将被重新定向到页面中的日志。登录时使用您的“ admin” 用户和密码。

正如在最后的“恭喜!”页上所指出的: > [.]进行一轮完整的数据核查,以了解是否从以前的 > 版本中正确输入了数据。

特别是检查这些页面是否可用,并包含您的数据: - 管理员 - PIM - 离开

橙色人力资源管理 v4.10.1升级为v5.7

升级到v5.7的一些步骤与之前的升级非常相似,这些步骤很可能也适用于后来的v5.x更新. 然而,OrangeHRM v5.x包括一个CLI安装器/升级器,这些指令将涵盖这些设备。

根据v4.10.1升级,橙色人力资源管理中心提供升级文档 ,但仅覆盖了webUI升级。这些指令将使用 CLI 工具提供 TurnKey 特定注释。

筹备

双检查空闲空间,并创建新的OS备份和快照,按照OrangeHRM v4的初始升级.

并创建人工数据库本地备份 :

mysqldump orangehrm > orangehrm_v4.10.1_db.sql

下载 v5.7

wget https://sourceforge.net/projects/orangehrm/files/stable/5.7/orangehrm-5.7.zip

移动已有安装

mv /var/www/orangehrm /var/www/orangehrm-4.10.1

解包新版本

unzip -o orangehrm-5.7.zip
mv orangehrm-5.7 /var/www/orangehrm

通过 CLI 升级安装

CLI升级速度快得多,IMO也更容易.

确保您拥有您现有的数据库密码 :

grep -m 1 password /var/www/orangehrm.*/symfony/config/databases.yml

然后,修改到新的橙色人力资源管理目录(您在上面下载和解开),运行 CLI 工具。请注意,您需要替换。” 使用您实际的 DB 密码( 从上面的命令) 。另外, 如果您正在从“ 4. 10.1” 以外的版本升级, 也改变“ 当前版本” 的值。

cd /var/www/orangehrm
php installer/console upgrade:run \
    --dbHost=127.0.0.1 \
    --dbPort=3306 \
    --dbName=orangehrm \
    --dbUser=orangehrm \
    --dbUserPassword=<db password> \
    --currentVersion=4.10.1

校验环境

上面的命令会输出相当一点的文字。大部分文字可以安全忽略, 但请双倍检查“ 系统检查 ” 部分。所有数值都应该是绿色(或者如果没有使用黄色的话).

如果系统检查是红色的,则您需要回答“n” 并首先解决,然后才能重运行上面的升级命令。

假设所有系统检查都顺利, 请点击 Enter (“ 是” 是默认值 ) 。

升级可能需要一点时间,但最终会完成并退出,而不会出现任何错误消息.

校验您升级的橙色人力资源管理数据

一旦升级脚本完成,通过您的网页浏览器登录到您的橙色人力资源管理实例,并验证您的所有数据都在那里,一切都在正常运行。

也希望您能以最佳方式使用「橙色人力资源管理」。