Ir para o conteúdo

Importando Servidores Virtuais

Se você estiver executando um cluster SolusVM 1, poderá importar sua infraestrutura existente do SolusVM para o SolusVM 2.

Neste tópico, você aprenderá sobre o seguinte:

  • O que envolve a importação.
  • Por que é uma boa ideia importar.
  • Riscos e limitações associados.
  • Pré-requisitos necessários.
  • Como importar.

Visão geral da importação

Este documento presume que você está executando um cluster SolusVM 1 e deseja atualizar para SolusVM 2. Uma atualização local não está disponível. Em vez disso, você pode importar sua infraestrutura SolusVM existente para o SolusVM 2.

A importação é um processo único que permite ao SolusVM 2 reconhecer e gerenciar nós escravos e VPSes hospedados em um cluster SolusVM 1. Envolve a criação de um novo nó mestre (chamado de "nó de gerenciamento" no SolusVM 2) e a conexão de todos os nós escravos existentes (chamados de "recursos de computação" no SolusVM 2) a ele. Aqui está como deve ser o resultado de uma importação bem-sucedida:

  • Você tem um nó de gerenciamento SolusVM 2 totalmente operacional conectado e capaz de gerenciar todos os recursos de computação e servidores virtuais existentes.
  • Todos os servidores e clientes virtuais existentes (chamados de "clientes" no SolusVM 2) são transferidos e podem ser gerenciados no SolusVM 2 (com certas limitações listadas abaixo).
  • Os clientes existentes podem fazer login no SolusVM 2 e gerenciar seus servidores.
  • A integração com WHMCS (se houver) é preservada. Você pode vender seus serviços, conquistar novos clientes e continuar cobrando os existentes.

Assim que a importação terminar, recomendamos fortemente que você interrompa o agente SolusVM 1 em todos os nós importados executando o seguinte comando

/usr/local/solus/bin/agent services-solusvm1 off

e gerenciá-los apenas através do nó de gerenciamento SolusVM 2. Se você importou todos os nós escravos no SolusVM 1 e não há servidores virtuais hospedados no próprio nó mestre, o nó mestre SolusVM 1 pode ser desativado.

Razões para Importar

É sempre preferível executar a versão mais recente do software, que esteja sendo ativamente desenvolvida e suportada. Depois de importar sua infraestrutura existente do SolusVM 1 para o SolusVM 2, você poderá aproveitar os seguintes benefícios:

  • Aproveite novos recursos e melhorias, bem como suporte para novos sistemas operacionais.
  • Fique tranquilo com correções de bugs e patches de segurança frequentes.
  • Ofereça aplicativos como serviços com modelos integrados de personalização de aplicativos. Ofereça produtos baseados em cPanel e Plesk prontos para uso com sistemas de licenciamento Plesk e cPanel.
  • Mantenha seus dados seguros com uma solução de backup integrada para nó de gerenciamento e servidores virtuais. Gerencie backups de administradores e clientes na Interface do Usuário com apenas alguns cliques.
  • Atraia novos clientes com uma UI moderna e clara.
  • Atenda às solicitações de assistência dos clientes com mais eficiência com o portal de autoatendimento integrado.
  • Gerencie todos os recursos disponíveis por meio da API para uma integração fácil e poderosa.
  • Use armazenamento thin, como QCOW2 e ThinLVM, pronto para uso, o que permite obter mais densidade de servidor virtual por nó.
  • Servidores virtuais que usam LVM podem ser convertidos em armazenamento thin (ThinLVM ou QCOW2) usando migração. A conversão ao vivo no local do tipo de armazenamento e formato de imagem não está disponível no momento, mas pode ser adicionada em versões futuras.
  • Esteja na vanguarda com um conjunto de tecnologias modernas:
    • O nó de gerenciamento embalado em contêineres melhora a segurança.
    • O binário do agente de recurso de computação escrito em Go garante uma boa isolamento do sistema operacional, o que torna a atualização muito mais estável.
    • Open vSwitch fornece uma interface única para a camada de rede.
    • Cloudinit torna possível o provisionamento genérico de servidores virtuais.

Riscos e Limitações

Aviso

Antes de importar, certifique-se de ler esta seção com atenção!

Há uma série de fatores que você precisa levar em consideração antes de iniciar a importação:

  • Complicações imprevistas podem ocorrer durante o processo de importação.
  • Algumas funcionalidades podem funcionar de forma diferente no SolusVM 1 e no SolusVM 2, ou estar ausentes no SolusVM 2.
  • Nem todas as configurações e dados podem ser importados.

Certifique-se de compreender totalmente as implicações da importação do SolusVM 1 para o SolusVM 2 para evitar surpresas desagradáveis e a interrupção dos seus processos de negócios.

Riscos

A importação do SolusVM 1 é bastante simples. No entanto, sempre existem certos riscos. Certifique-se de entendê-los antes de prosseguir.

  • Certifique-se de ler atentamente as informações sobre as limitações de importação e as alterações entre a lógica de negócios SolusVM 1 e SolusVM 2 encontradas neste tópico e considerá-las tendo em vista o seu negócio. Se um determinado recurso ausente do SolusVM 2 for vital para seus clientes, isso pode se tornar um bloqueador para importação, ou pelo menos exigir uma consideração cuidadosa de sua parte.

  • Existe a possibilidade de o SolusVM configurar incorretamente os limites da rede durante a importação.

  • Existe a possibilidade de que a criação de novos servidores virtuais em recursos de computação importados via WHMCS não seja 100% tranquila. Recomendamos testar esse cenário antes de disponibilizá-lo aos clientes.

  • Embora a importação tenha sido projetada desde o início para causar zero tempo de inatividade do VPS, em teoria, algum tempo de inatividade é possível.

  • Há sempre um risco, por menor que seja, de não termos considerado algum caso extremo que possa causar complicações em condições altamente específicas.

Limitações

A importação do SolusVM 1 apresenta uma série de advertências e limitações. Considere-os e planeje de acordo.

  • Os servidores virtuais baseados em KVM importados do SolusVM 1 requerem a instalação de Guest Tools. As Guest Tools podem ser instaladas a partir da interface de administração do SolusVM 2. Os seguintes recursos do SolusVM 2 não estarão disponíveis se as Guest Tools não estiverem instaladas:

    • Suporte a endereços IP adicionais.
    • A capacidade de alterar o nome do host de um servidor virtual.
    • A capacidade de alterar a senha root de um servidor virtual.

    Estas limitações não se aplicam a novos servidores virtuais criados no SolusVM 2 e hospedados em recursos computacionais importados do SolusVM 1.

    A instalação das Ferramentas Convidadas agora é compatível com os seguintes sistemas operacionais convidados:

    • AlmaLinux 8, AlmaLinux 9
    • CentOS 7, CentOS 8 Stream, CentOS 9 Stream
    • CloudLinux 7, CloudLinux 8
    • Debian 9, Debian 10, Debian 11, Debian 12
    • RockyLinux 8
    • Ubuntu 18, Ubuntu 20, Ubuntu 22
    • VzLinux 7, Vzlinux 8

    O suporte de instalação de Guest Tools para CentOS 6 será adicionado em breve. Se precisar de suporte para outros sistemas operacionais, entre em contato com o suporte técnico.

  • Certos recursos do SolusVM 1 estão ausentes do SolusVM 2 e não são importados:

    • Grupos de mídia.
    • Registros DNS personalizados para servidores virtuais.
    • Tipo de seleção automática de nó ("Aleatório" ou "Primeiro disponível").
    • Ajuste de memória KVM ("hard-limit" e "soft-limit").

    Além disso, os modelos de Sistema Operacional KVM existentes não são importados. SolusVM 2 vem com imagens de Sistema Operacional que têm a mesma função.

  • Você só pode importar nós escravos inteiros com todos os VPSes hospedados. Você não pode importar VPSes individuais.

  • Você só pode importar um nó escravo se todos os VPSes hospedados nele puderem ser importados. Mesmo um único VPS que não pode ser importado desqualifica todo o nó.

  • Somente recursos de computação e servidores virtuais OpenVZ/Virtuozzo e KVM podem ser importados. XEN não é compatível com SolusVM 2.

  • Nós escravos baseados em CentOS 5 e 6 não podem ser importados.

  • Os backups de servidores virtuais criados no SolusVM 1 não são importados.

  • Os revendedores não são suportados no SolusVM 2 e, portanto, não são importados.

  • Os dados estatísticos não são importados.

  • SolusVM 2 não oferece suporte a vários servidores PowerDNS.

  • Live migration of a virtual server from imported node to native compute resource is not possible now.

  • SolusVM 2 cria registros DNS reversos para endereços IPv4 no formato padrão como 1.0.168.192.in-addr.arpa onde a parte 1.0.168.192 é gerada automaticamente a partir de todos os quatro octetos do endereço IPv4. Se uma zona contém octetos de endereço IP como 168.192.in-addr.arpa, então o registro 1.0 será criado usando os dois últimos octetos. SolusVM 1 cria registros usando apenas o último quarto octeto. Se você precisar saber como o SolusVM 1 funciona, você pode personalizar o Modelo de nome de Registro DNS reverso nas configurações do bloco IP usando a variável {{ fourth-octet }}.

  • Os valores de “Max Disk” para nós escravos são convertidos de MB para GiB, arredondados para baixo.

  • Webhooks criados no SolusVM 1 não são importados e devem ser recriados manualmente. Aprenda como criar webhooks no SolusVM 2.

  • Enabled Two-factor authentication in SolusVM 1 is not supported and must be recreated again. Learn how to enable 2FA in SolusVM 2.

Alterações na terminologia

Algumas entidades familiares a você no SolusVM 1 têm nomes diferentes, SolusVM 2, embora conceitualmente permaneçam os mesmos.

Nome SolusVM 1 Nome SolusVM 2
Nó mestre Nó de gerenciamento
Nó escravo Recursos de computação
VPS Servidor virtual
Cliente Cliente
Modelo de sistema operacional Imagem do Sistema Operacional

Mudanças na lógica de negócios

Existem algumas diferenças importantes entre a lógica de negócios SolusVM 1 e SolusVM 2. Certifique-se de entendê-los antes de importar.

  • Assim que a importação for concluída, todas as operações realizadas no SolusVM 2 seguirão a lógica de negócios do SolusVM 2, mesmo se você ainda estiver usando o SolusVM 1 para gerenciar sua infraestrutura SolusVM.

    Aviso

    Removing an imported customer's account in SolusVM 2 will result in all of that customer's virtual servers being removed. However, if a server had a backup - it can be used to restore the server.

  • No SolusVM 2, os backups de servidores virtuais podem ser criados tanto pelo administrador quanto pelos clientes.

  • SolusVM 2 não envia notificações por e-mail quando um recurso de computação fica offline.

  • A API e CLI do SolusVM 2 não são compatíveis com as do SolusVM 1. Se você usar qualquer um deles em suas integrações, essas integrações precisarão ser atualizadas.

Pré-requisitos para importação

Antes de começar, há uma série de etapas que você precisa seguir.

  • Configurar um nó de gerenciamento SolusVM 2 em um novo servidor. Este será o seu novo nó de gerenciamento. Para licenciar o nó de gerenciamento, entre em contato com a equipe de suporte do SolusVM ou solicite uma licença temporária.

    Note

    Você não pode usar o servidor que hospeda o nó mestre SolusVM 1 para o nó de gerenciamento SolusVM 2 ou desativá-lo antecipadamente. O nó mestre SolusVM 1 deve permanecer disponível até o término da importação.

  • Atualize o nó mestre SolusVM 1 para a versão 1.27.27 ou posterior.

  • Certifique-se de que haja conectividade de rede entre o nó de gerenciamento SolusVM 2 de destino, o nó mestre SolusVM 1 de origem e cada nó escravo que você planeja importar.

  • Certifique-se de que seja possível efetuar login no nó mestre SolusVM 1 a partir do nó de gerenciamento SolusVM 2 via SSH usando autenticação de chave pública como o usuário root ou um usuário diferente que tenha privilégios de root.

  • Certifique-se de que as configurações de rede de cada nó escravo que você planeja importar estejam corretas. Você pode verificar isso em SolusVM 1 > Nós > Editar nó > Interface de rede.

  • Se você tiver a integração PowerDNS configurada no cluster SolusVM 1, configure também a integração PowerDNS no cluster SolusVM 2.

  • Por padrão, a função "CLIENTE" será definida para usuários importados. Se você precisar definir uma função personalizada com um conjunto personalizado de permissões para contas de usuários que serão importadas do cluster SolusVM 1, use a configuração "A função padrão para novos usuários" (em Configurações > **Área do Usuário **).

  • Recomendamos fortemente que você crie novos backups de todos os servidores virtuais hospedados em nós escravos que você planeja importar e certifique-se de poder restaurá-los. Dessa forma, você poderá retornar seu cluster SolusVM 1 à condição de funcionamento caso algo dê errado.

  • Recomendamos fortemente que você bloqueie os nós escravos durante a importação para garantir que nenhum novo VPS seja provisionado para eles durante a importação.

Importando seu Cluster SolusVM

Para importar seu cluster SolusVM 1 para SolusVM 2, primeiro você precisa criar um processo de importação. Você pode usar um único processo de importação para importar qualquer número de nós escravos e VPSes hospedados, desde que todos façam parte de um único cluster SolusVM 1. Para importar de vários clusters SolusVM 1, crie um processo de importação separado para cada um.

Para criar uma importação:

  1. Acesse Importações de Cluster e clique em Adicionar.
  2. Nomeie sua importação. Use o nome que quiser. Isso ocorre para que você possa diferenciar os diferentes processos de importação.
  3. Forneça o endereço IP ou nome do host do nó mestre SolusVM 1.
  4. Se a porta 8080 estiver em uso no nó mestre SolusVM 1, forneça um número de porta disponível diferente. Esta porta será utilizada futuramente pelo agente SolusVM 2.
  5. Por padrão, o processo de importação é executado sob o usuário root. Você pode fornecer um nome de usuário diferente, mas a menos que esse usuário tenha privilégios de root, a importação falhará. Este usuário será usado para efetuar login nos nós mestre e escravo durante a importação.
  6. Se você estiver usando uma porta SSH personalizada, forneça-a.
  7. Forneça a parte privada de uma chave SSH (somente chaves RSA são suportadas) para o usuário especificado durante a etapa quatro que pode ser usada para efetuar login no nó mestre e nos servidores de nós que você irá importar.
  8. Clique em Adicionar.

Esta é a aparência de um formulário preenchido corretamente:

SolusVM 2 tentará se conectar ao nó mestre SolusVM 1 usando as informações que você forneceu. Isso geralmente leva alguns segundos. Se depois disso o resultado for “Preparado”, você está pronto para começar. Caso contrário, você precisará resolver quaisquer problemas antes de continuar.

  1. Clique em "Erro na importação" para ver o(s) erro(s) que o SolusVM 2 encontrou ao tentar se conectar. Muito provavelmente, o problema está na conectividade de rede, autenticação ou autorização.
  2. Clique no ícone , verifique novamente as informações fornecidas e tente novamente.

Assim que o resultado estiver "Preparado", você estará pronto para prosseguir. Agora você pode importar um ou mais nós escravos do cluster SolusVM 1 com todos os VPSes hospedados.

Observação

Você pode excluir com segurança um processo de importação a qualquer momento, sem perda de dados.

Para importar servidores virtuais:

  1. Acesse Importações de Cluster, encontre o processo de importação que deseja retomar e certifique-se de que seu status seja "Preparado".
  2. Se o processo de importação foi criado há algum tempo, clique no ícone para atualizar as informações sobre o cluster SolusVM 1 de origem.
  3. Clique no ícone para continuar.
  4. Selecione um ou mais nós para importar todos os servidores virtuais hospedados neles e clique em Executar.

O status do processo de importação mudará para “Importando” para indicar que os nós escravos selecionados estão sendo importados. Assim que o status voltar para "Preparado", significa que os nós escravos selecionados foram importados para o SolusVM 2. Você pode encontrar os nós escravos importados em Recursos Computacionais e todos os VPSes hospedados neles em Servidores Virtuais.

Aviso

Não remova nenhuma entidade (VPSes, clientes e assim por diante) que você importou, seja do SolusVM 2 ou do SolusVM 1, a menos que esteja preparado para perdê-los. As entidades importadas são governadas pelo SolusVM 2 ou SolusVM 1 com autoridade total. Portanto, excluir um VPS importado no SolusVM 2 não apenas o remove da interface do SolusVM 2, mas resulta na exclusão do VPS e na perda de todos os dados associados.

Se, após a conclusão de um processo de importação, o nó importado e os servidores virtuais estiverem com o status "indisponível" no SolusVM 2, houve problemas durante a importação. Esses servidores virtuais estão funcionando normalmente, mas não podem ser gerenciados a partir do SolusVM 2.

Para corrigir servidores virtuais "indisponíveis":

  1. Acesse Tarefas.
  2. Encontre a tarefa "instalar agente" com falha correspondente e clique no ícone para ver por que a tarefa falhou.
  3. Resolva o problema e clique no ícone para tentar novamente a tarefa.

Depois que a tarefa de "instalar agente" for concluída com êxito, o(s) recurso(s) de computação e servidore(s) virtual(is) importados não serão mais marcados como "indisponíveis" no SolusVM 2.

Observação

Você pode executar a importação novamente para um nó que já foi importado. Como resultado, as entidades (endereços e blocos IP, planos, clientes, etc.) criadas desde a última importação também serão importadas. Entidades que já foram importadas não serão ressincronizadas ou atualizadas no SolusVM 2, mesmo que tenham sido alteradas desde a última importação.

Ações pós-importação

  • Ativar backups para o nó de gerenciamento.

  • Ativar backups nos recursos de computação importados.

  • Se você estiver satisfeito com os resultados da importação e não planeja mais gerenciar o(s) nó(s) escravo(s) importado(s) por meio do SolusVM 1, recomendamos interromper os serviços do SolusVM 1 nesses nós executando o seguinte comando:

    /usr/local/solus/bin/agent services-solusvm1 off

  • Para reverter as alterações feitas em um nó escravo durante a importação, execute o seguinte comando nesse nó escravo:

    /usr/local/solus/bin/agent services-solusvm1 on

Se algum nó escravo pertencente ao mesmo cluster SolusVM 1 ainda não tiver sido importado, você pode repetir as etapas acima para importá-los usando o mesmo processo de importação. Se todos os nós escravos no cluster SolusVM 1 tiverem sido importados, o processo de importação não terá mais nenhuma finalidade e poderá ser excluído com segurança.

Converting SolusVM 1 WHMCS Data to SolusVM 2

Se você estiver usando WHMCS, para poder continuar cobrando dos clientes que você importa do SolusVM 1, você precisa atualizar seus produtos. Você pode fazer isso automaticamente usando o conversor SolusVM 2, ou manualmente através da interface WHMCS. Você também pode converter seus produtos SolusVM 1 em produtos SolusVM 2. De qualquer forma, você precisa primeiro integrar o SolusVM 2 ao WHMCS.

Para integrar SolusVM 2 com WHMCS:

  1. Instale o módulo SolusVM 2 WHMCS em sua instância WHMCS.
  2. Configurar o módulo SolusVM 2 WHMCS.

Agora você pode começar a atualizar os produtos de seus clientes.

Observação

Para poder atualizar produtos importados automaticamente, o php-cli deve estar instalado no servidor que hospeda sua instância WHMCS.

Convert single SolusVM 1 product into SolusVM 2 product

Para atualizar automaticamente um único produto importado para todos os clientes:

Observação

This will convert all services related to the product

  1. Faça login em sua instância WHMCS.

  2. Crie um produto SolusVM 2 correspondente se ainda não tiver sido criado.

  3. Faça login no servidor que hospeda sua instância WHMCS via SSH e, em seguida, altere o diretório de trabalho para aquele em que o módulo de provisionamento SolusVM 2 está instalado (modules/servers/solusvm2vps).

  4. Execute o comando php converter.php products para ver a lista de todos os produtos SolusVM 1 e 2. Por exemplo, esta pode ser a aparência da saída:

    Produtos SolusVM v1 existentes:
Nome de identificação
10 Produto SolusVM foo
Produto de barra 20 SolusVM
Disponível para conversão de produtos SolusVM v2:
Nome de identificação
30 Produto SolusVM 2 foobar

  5. Execute o comando php converter.php run <SolusVM 1 ID> <SolusVM 2 ID> para converter todos os clientes que usam o produto SolusVM 1 especificado para o produto SolusVM 2 especificado. No exemplo acima, execute php converter.php run 10 30 para converter todos os clientes que usam o "produto SolusVM foo" para o "produto SolusVM 2 foobar".

Os clientes importados agora serão cobrados pelo produto SolusVM 2.

Para atualizar manualmente um único produto importado para um único cliente:

  1. Faça login em sua instância WHMCS.

  2. Crie um produto SolusVM 2 correspondente se ainda não tiver sido criado.

  3. Acesse Clientes, localize o cliente e clique na entidade Produto/Serviço correspondente.

  4. Altere o tipo de produto/serviço para o produto da etapa 2.

  5. Clique em Sincronizar conta na página do produto.

O cliente importado agora será cobrado pelo produto SolusVM 2. Para cada cliente importado que você deseja manter faturando via WHMCS, repita este procedimento para cada produto importado que ele possuir.

Convert all SolusVM 1 products and services to SolusVM 2

Para converter seus produtos SolusVM 1:

  1. Faça login no servidor que hospeda sua instância WHMCS via SSH e, em seguida, altere o diretório de trabalho para aquele em que o módulo de provisionamento SolusVM 2 está instalado (modules/servers/solusvm2vps).

  2. Execute o comando php converter.php reconfigure com a opção "--mn-server" para converter seus produtos SolusVM 1 em produtos SolusVM 2. Por exemplo:

    php converter.php reconfigure --mn-server=2

    Aqui, --mn-server=2 é o ID do nó de gerenciamento SolusVM 2. Você pode procurá-lo em sua instância WHMCS Configurações do Sistema > Servidores.

Observação

Em alguns casos, pode ser necessário fornecer IDs de planos, imagens de sistema operacional e/ou locais, caso eles não possam ser recuperados automaticamente. Neste caso, execute php converter.php help para aprender sobre as opções necessárias.

Os clientes agora serão cobrados pelos produtos SolusVM 2 convertidos.

Partial conversion of WHMCS SolusVM 1 services to one SolusVM 2 product

This option allows conversion only of those WHMCS services, that have their related SolusVM 1 virtual servers imported. Services of not imported virtual servers will not be changed.

  1. Create Cluster Import in SolusVM 2 and import necessary nodes.

  2. Faça login em sua instância WHMCS.

  3. Crie um produto SolusVM 2 correspondente se ainda não tiver sido criado.

  4. Create Location configurable option for the product from step 3. Do not fill its sub options.

  5. Create custom fields for the product from step 3. Names of custom fields:

    Field Name Field Type Tick Box
    VCPU Text Box Admin Only
    Memória Text Box Admin Only
    Disk Space Text Box Admin Only
    Total traffic limit
    monthly    		 Text Box Admin only

  6. Log in to the server hosting your WHMCS instance via SSH, and then change the working directory to the one the SolusVM 2 provisioning module is installed in (/whmcs_root/modules/servers/solusvm2vps).

  7. Execute php converter.php get-import-info to fetch information about imported virtual servers and locations from SolusVM 2 cluster import and display WHMCS services available for conversion. Available flags:

     ``--mn-server`` - ID of SolusVM 2 Management node added in **WHMCS > System Settings > Servers**. (optional)

 ``--cluster-import`` - ID of cluster import that should be used. It can be found in **SolusVM 2 > Cluster Imports**. (optional)

  8. Execute php converter.php get-vps-resources. This command fetches resources of imported virtual servers from SolusVM 2. Resources are - vCPU, RAM, Disk Space, Total traffic limit monthly, location ID and location name. Available flags:

     ``--mn-server`` - ID of SolusVM 2 Management node added in **WHMCS > System Settings > Servers**. (optional)

  9. Execute php converter.php create-location-suboption - it fills Location configurable option for the product you want to use for conversion with imported locations. Available flags:

     ``--product-id`` - ID of SolusVM 2 Product for option creation. Can be found in URL of a product page in **WHMCS > System Settings > Product/Services >necessary product**, for example `https://example.com/admin/configproducts.php?action=edit&id=5`. 5 is ID. (required)

 ``--mn-server`` - ID of SolusVM 2 Management node added in **WHMCS > System Settings > Servers**. (optional)

  10. Execute php converter.php convert-to-one-product - converts SolusVM 1 services of imported virtual servers to SolusVM 2 and creates custom fields for each service. Available flags:

    --product-id - ID of SolusVM 2 Product for option creation. Can be found in URL of a product page in WHMCS > System Settings > Product/Services > necessary product, for example https://example.com/admin/configproducts.php?action=edit&id=5. 5 is ID. (necessário)