TURNKEYGNU / LINUX
Português

Documentação

LaranjaHRM

Actualização do OrangeHRM

Suposições e limitações

Sistema operacional base OrangeHRM e TurnKey

Este documento cobre explicitamente a atualização do OrangeHRM v4.x (TurnKey v17.x) e/ou OrangeHRM v5.x (TurnKey v18.x) para a última versão estável do OrangeHRM (v5.7 no momento da escrita). - Sim, é verdade. NOT cobrir a atualização do sistema operacional TurnKey/Debian subjacente para a versão mais recente.

TurnKey v17.x é baseado em Debian 11 / Bullseye. Bullseye está atualmente em "LTS" (suporte de longo prazo) e receberá atualizações de segurança pelo menos até 31 de agosto de 2026. TurnKey v18.x é baseado no Debian 12/Líbrido. O leitor de livros será suportado até pelo menos 30 de junho de 2028.

Este documento também assume:

  • TKLBAM está habilitado (ou você habilitá-lo) - note que isso não é necessário, mas é altamente recomendado.
  • Seu servidor tem espaço livre suficiente para a atualização - 2GB é recomendado, mas mais é sempre melhor.

Este documento usa comandos de terminal para a maior parte do processo. Muitos passos podem ser possíveis via Webmin, mas os comandos de terminal são concisos e podem ser copiados/pastados, por isso são muito fáceis de seguir. Qualquer passo em que você saiba como alcançar os mesmos resultados via Webmin, sinta-se à vontade para usar isso em vez disso.

O acesso ao CLI do seu servidor TurnKey através de "SSH" (concha segura) é recomendado. Recentes versões do Windows 11, Mac OSX e todos os sabores Linux desktop todos os navios com cliente OpenSSH pré-instalado, mas há um número de clientes SSH alternativos que também funcionam bem.

Alternativamente, no TurnKey v17.x, você pode usar o servidor “Webshell” através do seu navegador; https na porta 12320. Por exemplo, https://your.domain.com:12320. No TurnKey v18.x você pode usar o módulo de terminal interativo Webmin “proper” (v18.x não inclui WebShell).

DO NOT use o terminal TurnKey v17.x Webmin! Não é um terminal interativo verdadeiro e causará problemas.

Geralmente, um cliente SSH local dará uma melhor experiência ao usuário (por exemplo, copy/paste deve funcionar de forma confiável), mas o módulo de terminal interativo Webmin do v17.x ou do v18.x deve funcionar bem.

Para iniciar uma sessão SSH:

ssh root@DOMAIN_OR_PUBLIC_IP

Se você estiver usando chaves de autenticação em vez de uma senha, você pode precisar incluir explicitamente o caminho para a chave privada em seu sistema local:

# 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

Nota para usuários do AWS Marketplace

As instâncias do AWS Marketplace têm a conta ‘root’ desabilitada por padrão. Assim, qualquer um dos dois habilitar o root ou faça login como 'admin' e depois se torne root como este:

sudo su -

Primeiros passos - preparação

Antes de iniciar a atualização OrangeHRM, certifique-se de que você tenha um backup atual e espaço livre suficiente. Eu também recomendo que você atualize todos os pacotes do sistema e reinicie o sistema antes de iniciar a atualização.

Cópia de Segurança

Eu recomendo a criação de um "snapshot" e um "propriedade" backup. Um instantâneo tecnicamente não é um backup, mas carregar um instantâneo é uma maneira rápida e fácil de voltar exatamente onde você está agora, se necessário.

Se o seu servidor estiver em execução através do TurnKey Hub, você pode ativar um instantâneo através do Hub Página “servidores”. Por favor, note que pode levar algum tempo para completar. Outras plataformas de virtualização/nuvem também devem ter essa funcionalidade - consulte os documentos relevantes se você não tem certeza de como. Servidores de metal sem fio podem usar uma ferramenta como Clonezilla.

Assumindo que você está usando o TKLBAM, ative manualmente uma cópia de segurança completa do seu servidor TKLBAM. Você pode fazer isso via Webmin, ou através de um terminal:

tklbam-backup --full-backup now

Verificar espaço e limpeza livres se necessário

Para verificar espaço livre:

df -h /

Saída de exemplo (servidor Hub com volume de raiz de 10GB):

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

Veja a coluna “Avail” (8.0G no exemplo acima). Recomendo pelo menos 1GB de espaço livre mínimo, de preferência pelo menos 2GB. Se você não tiver o suficiente, primeiro faça uma limpeza como abaixo. Por favor, faça o NOT apenas insira 'y' cegamente no segundo comando (remove):

apt clean
apt autoremove

O comando ‘autoremove’ deve listar apenas alguns pacotes, provavelmente incluindo kernels antigos (pacotes que começam com ‘linux-image’). Se ele lista um grande número de pacotes ou lista quaisquer pacotes principais, por favor, certifique-se de verificar a sua função e se alguma preocupação levantar você pode remover manualmente os que aparecem seguro para remover usando 'apt remover PKG1 PKG2 ...'. Se você tem preocupações e tem espaço livre suficiente, apenas pular este passo por agora.

Atualizar software OS (opcional)

Para atualizar o software do sistema para as versões mais recentes em pacote:

apt update
apt upgrade

Se você executar esta etapa, eu também recomendo re-executar os comandos de limpeza acima apt, reiniciar o servidor e verificar novamente o espaço livre.

Cópia de segurança local manual (opcional)

Com um instantâneo e um backup TKLBAM, fazendo outro No entanto, eu diria que várias camadas de redundância são sempre desejáveis. Então, se algo der errado, você tem várias opções de recuperação e caminhos para restaurar a funcionalidade. Independentemente disso, este passo é puramente opcional e um instantâneo e um backup TKLBAM completo fornecer opções de recuperação suficientes.

Descarte manual do DB

mysqldump orangehrm > orangehrm_db.sql.orig

Actualizar o OrangeHRM v4. x para v4. 1. 1

A última versão do OrangeHRM no momento da escrita é v5.7. Mas você deve estar executando v4.10.1 (a última versão v4.x) para atualizar para v5.x. Se você já estiver executando v4.10.1 ou posterior, então pule este passo.

LaranjaHRM fornecer atualizar documentação Mas vou fornecer um passo-a-passo mais detalhado e TurnKey específico aqui.

Baixar v4.10.1

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

Mover a instalação existente

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

Desembalar nova versão

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

Dê acesso de escrita ao servidor web aos arquivos OrangeHRM necessários:

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}

Obter a senha de usuário existente do DB 'alangehrm' (a partir do arquivo de configuração antigo):

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

Instale e ative a extensão zip php:

apt install --yes php-zip
systemctl restart apache2

Carregar a página de atualização no seu navegador web

Abra no seu navegador e navegue para a página de "atualização" do seu domínio do site OrangeHRM:

https://DOMAIN_OR_PUBLIC_IP/upgrader/web

Por exemplo:

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

A menos que você queira fazer uma instalação “limpa” DO NOT basta carregar seu domínio sem o ‘/upgrader/web’ URL. Caso contrário, ele irá substituir seus dados existentes.

Indique os detalhes do DB

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

Em seguida, clique no botão "Proceder".

Verificação do sistema

Tudo deve estar bem, mas verifique se cada linha tem um “OK” verde na página de verificação do sistema.

Assumindo que tudo está bem, clique no botão "Proceder".

Selecione a versão atual do OrangeHRM

Na lista, selecione a versão atual/antiga OrangeHRM. A menos que você já tenha atualizado, TurnKey v17.1 deve ter a versão OrangeHRM ‘4.9’. Independentemente disso, você pode confirmar a versão atual/antiga com este comando:

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

Por padrão, deve retornar:

New & Changed Features for OrangeHRM ver 4.9

Selecione a versão relevante e clique no botão "Proceder".

Aplicar alterações manuais - se necessário

A página seguinte irá mostrar quaisquer passos/alterações manuais que você possa precisar executar. Durante meus testes, o único passo manual adicional observado foi aplicado à criptografia de dados.

Se você habilitou a criptografia de dados, copie as chaves criptográficas da sua antiga pasta OrangeHRM. ou seja:

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

Depois de ter realizado quaisquer passos manuais adicionais, clique no botão "Proceder".

Atualizar banco de dados

A próxima página irá realmente realizar a atualização do banco de dados. Como observado, a atualização pode levar um pouco de tempo e é importante que VERY que você não feche ou reload que página até que o progresso atinge 100% eo botão "Iniciar" muda para um botão “Proceed”.

Clique no botão "Iniciar" e uma vez concluído, clique no botão "Proceder".

Criar novos ficheiros de configuração

A página seguinte irá gerar os novos arquivos de configuração. Este passo não deve demorar muito, mas como na página de atualização do banco de dados anterior, DO NOT fechar ou recarregar essa página.

Clique no botão "Iniciar" e uma vez concluído, clique no botão "Proceder".

Finalizar atualização

Você deve ser saudado com uma página intitulada “Parabéns!”, observando que você está agora executando OrangeHRM v4.10.1.

Como observado nessa página, certifique-se de que quaisquer passos manuais estejam completos (deveria ter sido tratado dentro do passo anterior “Aplicar alterações manuais”, mas você pode verificar novamente a partir do ficheiro registado dentro do seu directório OrangeHRM:

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

Clique no botão "Proceder".

Validar os dados OrangeHRM atualizados

Após o passo anterior, você será redirecionado de volta para a página de login. Faça login usando seu usuário e senha de administração.

Como foi observado na página final “Parabéns!”: > [...] faça uma rodada completa de verificação de dados para ver se os dados da versão anterior > foram importados corretamente.

Em particular, verifique se estas páginas estão disponíveis e inclua seus dados: - Admin. - PIM - Deixe

Actualizar o OrangeHRM v4.10.1 para v5.7

Um número de passos para atualizar para v5.7 são muito semelhantes à atualização anterior. Estes passos provavelmente também se aplicarão a atualizações posteriores v5.x. No entanto, OrangeHRM v5.x inclui um instalador/upgrader CLI que estas instruções cobrirão.

De acordo com a atualização v4.10.1, OrangeHRM fornecer atualizar documentação mas isso só cobre a atualização do webUI. Estas instruções fornecerão notas específicas TurnKey usando a ferramenta CLI.

Preparação

Verifique o espaço livre e crie um novo backup e instantâneo do sistema operacional de acordo com o upgrade inicial do OrangeHRM v4.

Também criar um backup manual de banco de dados local:

mysqldump orangehrm > orangehrm_v4.10.1_db.sql

Baixar v5.7

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

Mover a instalação existente

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

Desembalar nova versão

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

Actualizar a instalação através do CLI

A atualização CLI é muito mais rápida e fácil IMO.

Certifique-se de que você tem sua senha de banco de dados existente:

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

Depois mude para o novo directório OrangeHRM (que você baixou e desfigurou acima) e execute a ferramenta CLI. Lembre- se que terá de substituir '’ com sua senha DB real (a partir do comando acima). Além disso, se você está atualizando de uma versão diferente de ‘4.10.1’, também alterar o valor de “–currentVersion”.

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

Verificar o ambiente

O comando acima irá produzir um pouco de texto. Muito dele pode ser ignorado com segurança, mas por favor verifique novamente a secção 'Verificação do Sistema'. Todos os valores devem ser verdes (ou amarelos se não for utilizado).

Se alguma das verificações do sistema for vermelha, você precisará responder “n” e resolvê-las primeiro antes de repetir o comando de atualização acima.

Assumindo que todas as verificações do sistema estão ok, clique em Enter (“sim” é o padrão).

A atualização pode demorar um pouco, mas eventualmente ela irá terminar e sair sem qualquer mensagem de erro.

Validar os dados OrangeHRM atualizados

Uma vez que o script de atualização termine, faça login em sua instância OrangeHRM através de seu navegador da web e valide que todos os seus dados estão lá e tudo está funcionando como deveria.

Assumindo que sim, parabéns - você está agora executando o mais recente OrangeHRM! :)