Práticas recomendadas para a atualização do Server
Embora a atualização de uma versão do Alteryx Server para outra seja um processo simples, existem várias considerações e etapas de preparação que podem ajudar a garantir uma atualização descomplicada. Esta página fornece uma visão geral do processo, incluindo links para documentação útil e uma abordagem passo a passo a considerar ao planejar sua atualização.
Nem todas as etapas ou recomendações deste documento são aplicáveis a todos os ambientes ou instalações. Seu plano pode ser diferente.
Em geral, o processo de atualização deve consistir nas seguintes etapas de alto nível:
As seções a seguir descrevem essas etapas e adicionam narrativa para ajudar no planejamento do seu trabalho. Os links para instruções detalhadas, quando existirem, serão mostrados no texto, e uma lista agregada de todos os links fornecidos neste documento pode ser encontrada na seção Guias e artigos de ajuda.
Encontre uma lista de verificação dessas etapas na Lista de verificação para atualização do Server.
A Alteryx e seus parceiros estão disponíveis para ajudar no planejamento e execução de uma atualização. Fale com o seu executivo da conta se precisar de assistência com esse processo.
Nova terminologia
Com o lançamento do Server 2022.3, o termo "Gallery" foi descontinuado e substituído por "IU do Server". Embora o termo herdado ainda exista no software e na documentação no momento da elaboração deste texto, este documento usa "IU do Server" para se referir aos serviços, nós, configurações e outros itens aplicáveis.
Seção 1. Documentar seu ambiente
Capture sua arquitetura e configuração
É necessário ter uma compreensão (e documentação) completa do seu ambiente. No mínimo, você precisa saber:
Quantos servidores estão instalados e quais são suas funções?
Quantos controladores, instâncias da IU do Server, trabalhadores, nós MongoDB e SQL você possui em cada um dos seus ambientes (Desenvolvimento/Teste/Produção)?
Você executa um ambiente de alta disponibilidade (HA)?
Existe um diagrama arquitetônico que visualiza o ambiente? Se não, esta é uma boa oportunidade para criar um.
Que versão de software do Alteryx Server está sendo executada em seu ambiente?
Que software adicional foi instalado?
Bibliotecas R personalizadas
Bibliotecas Python personalizadas
Utilitários de terceiros
Conectores
Nem todos os conectores precisam ser atualizados, e alguns podem não ter uma atualização disponível.
Pacotes de dados: insights de local, insights de negócios, Intelligence Suite e assim por diante.
A prática recomendada é instalar versões correspondentes desses add-ons durante a atualização, se disponíveis.
Ferramentas personalizadas projetadas por seus usuários ou baixadas da Comunidade, outras ferramentas e conectores de terceiros comprados ou gratuitos. Faça uma lista desses itens, juntamente com suas versões.
As opções de configuração que foram definidas por meio da ferramenta de configuração Configurações de sistema do Alteryx, incluindo, mas não se limitando a:
Espaços de trabalho
Diretórios de log
Configurações de habilitação do Scheduler e do motor
Configurações de persistência, incluindo:
Tipo de banco de dados
Pasta de dados
Opções de retenção
Configurações da IU do Server (URLs e segurança)
Métodos de autenticação e informações de IDP
SMTP
Usuário executar como
Nota
Essas opções de configuração (como configurações do Scheduler, motor, persistência, IU do Server, SMTP, usuário executar como e muito mais) são capturadas em C:\ProgramData\Alteryx\RuntimeSettings.xml, portanto, um administrador não precisa registrar configurações separadamente. Uma cópia de "RuntimeSettings.xml" fornece tudo isso em um arquivo XML de texto sem formatação.
Usuário de logon de serviço
Especificações do servidor físico e virtual
Núcleos e memória
Versão do SO
Para obter mais informações, acesse Requisitos do sistema para o Server.
Bancos de dados e versões do Python:
MongoDB gerenciado pelo usuário: a versão do MongoDB gerenciado pelo usuário é independente de uma atualização do Server. Talvez seja necessário atualizar separadamente seu MongoDB gerenciado pelo usuário em paralelo a uma atualização do Server. No caso da instância gerenciada pelo usuário, a Alteryx não fornece suporte. Para obter mais informações, acesse Política de suporte para versões.
MongoDB integrado: as versões de Python e Mongo integrado seguem a versão do Server e não precisam ser anotadas separadamente. Para obter mais informações sobre as versões do MongoDB integrado, acesse Referência de esquema do MongoDB ou Política de suporte para versões.
SQL DB gerenciado pelo usuário: a versão do SQL DB gerenciado pelo usuário é independente de uma atualização do Server. Talvez seja necessário atualizar separadamente seu SQL DB gerenciado pelo usuário em paralelo a uma atualização do Server. No caso da instância gerenciada pelo usuário, a Alteryx não fornece suporte. Para obter mais informações, acesse Política de suporte para versões.
Nota
Se você estiver usando a ferramenta Python, consulte Ambiente de ferramentas Python em atualizações do Server antes da atualização.
Nota
Sua lista de trabalhos agendados, coleções, fluxos de trabalho e funções de membro faz parte do MongoDB e não é perdida durante a atualização.
Preparamos uma Configuration and Architecture Checklist para facilitar essa etapa para você. A conclusão dessa lista de verificação irá fornecer uma visão geral da sua infraestrutura e configuração.
Identifique fluxos de trabalho críticos para os negócios
Uma parte importante do planejamento de sua atualização é identificar fluxos de trabalho críticos para os negócios que você deseja proteger e testar como parte do processo de atualização. Geralmente, esses são fluxos de trabalho executados em um cronograma, funcionam como dependências do trabalho em etapas posteriores (dentro ou fora do Alteryx) e/ou fornecem saída/dados críticos para as principais partes interessadas da empresa. Essencialmente, é importante identificar qualquer fluxo de trabalho que, se não estiver disponível por algum tempo significativo, terá um efeito deletério em seu negócio.
Identificar fluxos de trabalho críticos pode ajudar você a escolher a versão correta. Se o fluxo de trabalho crítico contiver ferramentas ou conectores que não são compatíveis com uma versão específica, você deve levar isso em consideração ao selecionar sua versão (consulte a Seção 3 a seguir para acessar o Guia versão por versão de atualização do Server: versões compatíveis). Esses fluxos de trabalho também podem ser modificados para testes pós-atualização (abaixo) e incluídos em seu plano de QA.
Crie versões de teste de fluxos de trabalho críticos para negócios
Ao testar fluxos críticos durante o controle de qualidade pós-atualização, será necessário desabilitar ou editar quaisquer saídas que gravem dados em outros sistemas de produção ou que gerem resultados que ficarão no ambiente de produção.
Uma metodologia comum aqui é criar versões de teste dedicadas desses fluxos que ainda acessam os sistemas e diretórios de destino, mas não substituirão dados em arquivos de produção e tabelas.
Para operações de dados, altere as saídas para gravar em versões de teste dedicadas das tabelas.
Para operações de arquivo, grave arquivos com uma convenção de nomenclatura de arquivo diferente ou em uma subpasta de teste.
Isso permite fazer testes de ponta a ponta que não afetam a produção. Esses fluxos de trabalho de teste devem ser usados em testes de produção pela mesma razão.
Considerações adicionais
Planeje e agende suas atividades de atualização para minimizar a interrupção das operações contínuas da sua organização. Agende a janela de atualização fora do horário comercial normal (se possível) e durante períodos de utilização "mais leve". Por exemplo, não agende durante o fechamento do ano fiscal, processamento de final de trimestre, auditorias mensais etc.
Alguns clientes usam uma janela de atualização para revisitar as versões do sistema operacional (SO) em suas máquinas Alteryx. Trabalhe com seu departamento de TI se isso for algo que você deseja fazer e revise os Requisitos do sistema. Certifique-se de documentar em seu plano de atualização se você está atualizando o sistema operacional ao mesmo tempo. Se ocorrerem problemas após a atualização do Alteryx, os engenheiros de suporte serão informados sobre eles.
Seção 2. Executar uma verificação de integridade do Server (opcional)
Uma verificação de integridade do Alteryx Server é um recurso valioso para entender os padrões de uso de um ambiente do Alteryx Server. Ele analisa padrões de uso históricos para determinar o quão ocupado o ambiente do Server está, que tipo de atividades de otimização podem ser necessárias e se o ambiente está dimensionado adequadamente.
Se quiser saber mais, entre em contato com seu executivo de contas da Alteryx.
Seção 3. Selecionar uma versão ou versões
Escolha a versão do Server para a qual você planeja atualizar. Dependendo do ciclo de atualização da sua organização, você pode estar várias versões atrás da versão mais recente. O número de versões entre sua versão atual e de destino afeta sua abordagem de atualização, portanto, planeje-se adequadamente.
Muitas organizações não atualizam a cada lançamento, especialmente porque múltiplas versões podem ser lançadas a cada ano. No entanto, manter-se razoavelmente atualizado é importante. As atualizações regulares fornecem atualizações críticas de segurança, melhorias de desempenho e novos recursos.
Uma estratégia comum é padronizar a versão mais recente ou anterior para equilibrar a estabilidade com o acesso oportuno aos aprimoramentos.
Nota
Todas as versões principais têm suporte por 24 meses. Se sua organização adotou atualizações pouco frequentes, isso deve ser crítico para sua decisão.
Analise as notas de versão
A primeira etapa do processo de seleção é ler as Notas de versão. Essas notas detalham novos recursos e alterações de programação nas potenciais versões de escolha, correções de bugs e problemas conhecidos.
Entenda o caminho da atualização: onde você está agora e para onde deseja ir
Algumas versões têm considerações adicionais se forem provenientes de determinadas versões anteriores, e algumas não são apropriadas para todos os clientes. Por exemplo, você pode ser obrigado a atualizar seu MongoDB para atravessar entre as versões, ou no caso da versão 2022.3, precisará atualizar o Server e o Designer juntos por causa de aprimoramentos de criptografia de dados no software que tornam essa versão do Server incompatível com versões anteriores.
O site "Suporte e ajuda da Alteryx" dispõe de um Guia versão por versão de atualização do Server: Versões compatíveis (para versões não compatíveis, acesse Guia versão por versão de atualização do Server: Versões não compatíveis), que destaca as tarefas e considerações que você precisa ter em mente ao atualizar entre versões do Alteryx Server. O guia é especialmente útil se você estiver atualizando entre várias versões ao mesmo tempo, como migrar da 2019.1 para a 2022.1. Para garantir uma atualização descomplicada, talvez seja necessário executar algumas etapas incrementais.
Selecione sua versão
Agora que você se educou sobre as várias versões disponíveis e as considerações especiais em seu caminho de atualização, você está pronto para selecionar sua versão. A partir daqui, siga para o site Downloads.
Seção 4. Baixar o software
Visite o Portal de Licenças e Downloads da Alteryx. Você precisa de uma conta para visitar o site. Uma vez lá, você encontrará todos os downloads disponíveis, incluindo, mas não limitando-se a:
Alteryx Server (versões atual e anteriores)
Alteryx Designer
Alteryx Intelligence Suite e dados de insights
Drivers de banco de dados compatíveis com o Alteryx
Baixe todo o software necessário e avance para a próxima etapa do processo. Para obter ajuda para baixar, visite a página de ajuda Baixar e instalar um produto.
Paridade de versão
Em geral, a prática recomendada é manter o Server e o Designer na mesma versão. Então, baixar o instalador do Designer correspondente neste momento faz mais sentido. No entanto, como a atualização do Designer em uma grande base de usuários requer planejamento e recursos adicionais, talvez você não queira concluir a atualização ao mesmo tempo que a atualização do Server.
A partir da versão 2025.2, a Alteryx separou as atualizações do Designer e do Server para modernizar o processo de atualização e reduzir a carga de trabalho da equipe de TI. Agora você pode atualizar o Designer independentemente do Server.
O Server é geralmente compatível com versões mais antigas do Designer, com a ressalva de que novos recursos compatíveis com a versão escolhida do Server não estarão disponíveis em versões mais antigas do Designer.
No caso do Server e do Designer 2022.3, essa compatibilidade com versões anteriores não existe devido a aprimoramentos de criptografia de dados em toda a plataforma. Se você está planejando atualizar para ou além desta versão, o Designer deve ser atualizado ao mesmo tempo. Existem instruções especiais encontradas na página de ajuda Ferramenta de preparo para migração para preparar uma atualização para essa versão. Se você estiver tentando baixar uma versão mais antiga que não esteja mais disponível na página Downloads, entre em contato com o departamento Atendimento.
Seção 5. Executar uma atualização do sandbox ou uma implantação azul-verde
Atenção
A atualização direta do Server de produção poderá resultar em tempo de inatividade se ocorrerem problemas durante a atualização ou durante o teste pós-atualização.
Se um backup não está disponível, talvez não seja possível reverter, deixando seu ambiente de produção inativo até que o problema de atualização seja resolvido.
As práticas recomendadas incluem...
Atualização do sandbox
O teste da atualização em um ambiente que não seja de produção e a documentação das etapas do processo antes de atualizar o Server de produção ajuda a garantir uma atualização suave. Isso também ajuda a confirmar se fluxos de trabalho críticos para os negócios e ferramentas de terceiros continuam a ser executados conforme esperado. Caso isso não aconteça, há a oportunidade de explorar e corrigir esses problemas e adicionar essas etapas de correção ao seu plano de atualização de produção. As etapas que você seguir nesta atualização de teste, além de quaisquer medidas corretivas adicionais que você incluir na fase de controle de qualidade, constituirão o seu “roteiro” de atualização para a produção. Entre em contato com a equipe de contas para solicitar uma licença do sandbox.
Implantação azul-verde
Uma atualização do servidor do sandbox se torna o novo ambiente de produção após a validação. Isso elimina o risco de o Server de produção ficar inativo por um período indeterminado, pois ele não é atualizado no local. O ambiente de produção original é azul e o ambiente novo/de sandbox é verde, onde as atualizações podem ser implantadas e testadas. A implantação azul-verde valida se o ambiente do Server e os drivers de banco de dados, DSNs, conectores e outras configurações necessários são totalmente compreendidos, pois devem ser configurados no sandbox para validação.
A tabela abaixo mostra uma lista em camadas de recomendações mínimas para cada caso ao atualizar o Server:
Backup do Mongo integrado | Mínimo | Melhor | best | Benefícios |
|---|---|---|---|---|
Backup do MongoDB | ☑ | ☐ | ☐ | Preserva as informações do banco de dados para reversão em caso de erros durante a atualização. A reversão pode incluir etapas manuais e pode exigir a assistência do Suporte da Alteryx. |
Instantâneo de TI da máquina do Windows Server | ☐ | ☑ | ☐ | Fornece reversão rápida e fácil sem etapas manuais. Etapas: sua equipe de TI fará backup de uma instância completa da máquina do Alteryx Server. Observação: o serviço deve ser interrompido para que o instantâneo não capture o banco de dados enquanto ele está sendo atualizado. Isso pode deixá-lo em um estado não funcional quando restaurado. |
Implantação azul-verde | ☐ | ☐ | ☑ | Um backup de banco de dados é necessário em uma implantação azul-verde para migrar máquinas que hospedam (máquinas host), mas um instantâneo de TI não é necessário. |
Backup do SQL Server ou do Mongo gerenciado pelo usuário | Mínimo | Melhor | best | Benefícios |
Backup do banco de dados | ☐ | ☐ | ☑ | As atualizações realizam migrações de esquema em coleções de bancos de dados. O banco de dados original é necessário para poder reverter a atualização. |
Atualizar | Mínimo | Melhor | best | Benefícios |
Atualização no local do Server de produção | ☑ | ☐ | ☐ | Mais fácil de executar, mas com o maior risco de tempo de inatividade imprevisível do Server de produção no caso de um problema de atualização. |
Teste da atualização em um Server do sandbox | ☐ | ☑ | ☐ | Elimine problemas de atualização e teste fluxos de trabalho e conectores críticos no ambiente atualizado sem tempo de inatividade na produção. Etapas: execute uma recuperação do host para um ambiente sandbox:
Após a validação do processo de atualização, execute uma atualização no local do Server de produção. |
Implantação azul-verde | ☐ | ☐ | ☑ | A implantação azul-verde elimina o risco e o tempo de inatividade potencial de uma atualização no local, pois o ambiente de produção original não é atualizado. Etapas: execute uma atualização do sandbox, valide fluxos de trabalho críticos e, em seguida, alterne o URL do seu ambiente de produção para o sandbox (fazendo dele o novo ambiente de produção). |
Idealmente, comece com o Server de sandbox/desenvolvedor/teste da mesma versão e atualize-o. Consulte o artigo da Comunidade do ambiente de sandbox do Alteryx Server para obter mais informações sobre ambientes de sandbox.
Se você tiver um ambiente de múltiplos nós, o teste ainda será eficaz em uma única máquina que execute controlador + IU do Server + trabalhador. Da mesma forma, se você tiver um MongoDB gerenciado pelo usuário, restaurar um backup de banco de dados para o MongoDB integrado da máquina de teste pode ajudar a validar a atualização. Entre em contato com seu executivo de contas para obter informações sobre uma licença de sandbox.
No mínimo, você deve instalar a versão escolhida do Designer na máquina de um usuário para testar fluxos de trabalho críticos na nova versão. As instruções podem ser encontradas na página de ajuda Instalar duas versões do Designer na mesma máquina.
1. Executar um backup
Execute um backup para:
MongoDB e SQL DB gerenciados pelo usuário
Observe que a criação de um backup é responsabilidade do cliente e não é compatível com o Alteryx.
2. Concluir as verificações pré-atualização
Você pode evitar muitos problemas de atualização do Server executando as verificações pré-atualização/fluxo de trabalho encontradas no artigo Alteryx Server: verificações pré-atualização da Comunidade. Este procedimento aborda os problemas mais comuns que um cliente enfrentará ao realizar uma atualização e lista as soluções/etapas recomendadas para cada um.
É importante executar as verificações pré-atualização em cada um dos seus ambientes antes de executar a atualização. Por exemplo, você está testando em uma máquina de desenvolvimento, então desejará executar novamente as verificações em seu ambiente de produção e realizar as etapas indicadas antes de concluir essa atualização.
Como parte do planejamento pré-atualização, chegue a um acordo com as partes interessadas da empresa sobre quanto tempo a atualização poderá ser executada antes de acionar uma reversão.
Para obter melhores resultados, evite realizar uma atualização do Server e uma migração de host ao mesmo tempo. Execute uma operação por vez, permitindo um período de validação completo após a conclusão antes de iniciar a próxima.
Desabilite o Scheduler nos nós de trabalho durante as atualizações
Por padrão, os agendamentos que deveriam ter sido executados enquanto o Server estava sendo atualizado serão retomados assim que o Server e os nós forem reiniciados. Tenha isso em mente ao executar a atualização de teste em seu sandbox, pois você provavelmente não quer que os fluxos de trabalho sejam executados e impactem seus sistemas de produção.
Recomendamos desabilitar todos os agendamentos antes da atualização e determinar o que deve ser executado individualmente.
Se você não quiser que os agendamentos sejam executados quando o serviço for iniciado:
Execute as Configurações do sistema Alteryx em cada Trabalhador (e nó principal do Server).
Desmarque Trabalhador > Geral > Executar trabalhos não atribuídos.
Forneça ao Trabalhador uma tag de trabalho exclusiva (por exemplo, "UPGRADETESTING").
Como alternativa, entre em contato com o Suporte ao Cliente para obter assistência na exclusão de todos os agendamentos.
3. Executar a atualização
Executar a atualização é um processo simples se você estiver atualizando no local. Existem etapas diferentes se você estiver executando uma nova instalação da nova versão em uma máquina de destino, incluindo a aplicação de licenças que não fazem parte do caminho de atualização. As licenças ativas existentes continuam a funcionar em máquinas atualizadas sem intervenção. As etapas gerais de atualização são mostradas em Instalar ou atualizar o Server.
As diferentes instruções para novas instalações e atualizações no local são detalhadas, e o documento inclui links para arquivos/artigos de ajuda associados sobre licenciamento, requisitos do sistema, listas de verificação preparatórias, atualizações do MongoDB e muito mais. Muitos deles estão incluídos na seção Guias e artigos de ajuda no final deste documento.
Tenha em mente que as Ferramentas preditivas devem ser atualizadas com a instalação principal. Se você tinha um conjunto de usuários de logon de serviço, precisa configurá-lo novamente após a atualização; as atualizações removem e reinstalam o Alteryx Service.
Atualizar um ambiente de múltiplos nós
Em ambientes de múltiplos nós, todos os nós devem ser atualizados para a mesma versão e devem ser desligados na ordem mostrada na seção "Shutdown" do documento no artigo How to Restart the Services in a Multi-Node Alteryx Server da Comunidade.
Depois de atualizar todos os nós, siga a ordem de reinicialização adequada listada na seção "Inicialização" do mesmo documento.
Quando tudo estiver funcionando, atualize todos os conectores, pacotes de dados, drivers, add-ons (como o Intelligence Suite) e ferramentas de terceiros necessários.
4. Teste a atualização
Agora que o software do Server e todos os conectores aplicáveis foram atualizados, é hora de começar a testar.
Alteryx Services
Os primeiros testes são básicos e você pode encontrá-los na seção “Teste” da Lista de verificação para atualização do Server.
O Alteryx Service está em execução?
Você pode:
Acessar o URL do Server?
Navegar pelas páginas de administração e visualizar usuários, coleções e assim por diante?
Publicar um fluxo de trabalho do Designer para o Server?
Executar o fluxo de trabalho?
Se sua configuração permitir, salve e execute um fluxo de trabalho especificando suas credenciais.
Opções de configuração
Em seguida, examine as opções de configuração na ferramenta de configuração Configurações do sistema Alteryx para garantir que nenhuma configuração foi perdida. Essas configurações foram documentadas na seção Documentar seu ambiente. Se há alguma alteração que você precisa fazer, como configurações de persistência, configurações SMTP etc., agora é hora de fazê-las. Além disso, anote essas alterações para reutilizá-las em seu ambiente de produção atualizado.
Nota
Algumas configurações são alteradas ativamente em algumas das atualizações. Por exemplo, a versão 2022.1 definiu o AMP para o Server e alterou o número de fluxos de trabalho permitidos para serem executados simultaneamente.
Verifique sempre as Notas de versão para obter mais informações.
Conectores e drivers
A próxima etapa é testar seus conectores e drivers para sistemas críticos, como conectores do SharePoint e O365, e conectores ODBC/OleDB para SQL Server, Snowflake, Databricks e assim por diante. Verifique se você pode conectar, ler e gravar dados.
Fluxos de trabalho críticos
Agora, teste os fluxos críticos para os negócios e os que utilizam os conectores também documentados na seção Documentar seu ambiente. Esse conjunto de testes usará as versões de teste dos fluxos de trabalho criados na seção Crie versões de teste de fluxos de trabalho críticos para negócios deste guia. Se você executar versões de produções não modificadas desses fluxos, seus destinos de produção serão afetados como se esses fluxos estivessem sendo executados normalmente.
Scheduler e IU do Server
Por fim, se você estiver executando o Scheduler e a IU do Server, teste também:
Um fluxo de trabalho pode ser agendado e é executado?
Os aplicativos analíticos são executados corretamente?
Importante
Certifique-se de que os aplicativos que você publicar e agendar/executar neste ambiente não sejam versões de produção. Se você executar versões de produções não modificadas desses fluxos, seus destinos de produção serão afetados como se esses fluxos estivessem sendo executados normalmente.
5. Anote os erros e obtenha ajuda
Catalogue os problemas que seus testes descobrirem, como:
Serviços que não iniciam ou relatam erros.
Falhas no esquema do MongoDB ou migrações de criptografia.
Fluxos de trabalho que não são executados ou que são executados com resultados ou erros inesperados.
Conectores que não funcionam.
Erros no MongoDB.
A Lista de verificação para atualização do Server inclui algumas etapas comuns de solução de problemas na última seção. O Suporte ao Cliente pode ajudar se você tiver um erro no processo de atualização e não conseguir resolvê-lo com as etapas comuns de solução de problemas mostradas no guia. Seu executivo de contas pode fornecer opções, se você quiser assistência no planejamento ou na execução de uma atualização.
6. Execute uma reversão/restauração
Se não foi possível resolver os problemas identificados durante a fase de testes e controle de qualidade, é hora de reverter as alterações ou restaurar o sistema. Antes de reverter ou restaurar, talvez seja necessário reunir arquivos de log das máquinas do Server para fornecer ao Suporte ao Cliente ou para revisão interna antes da próxima tentativa de atualização. Se você tiver um snapshot/backup, poderá reverter para ele agora e planejar sua próxima tentativa de atualização. Se uma metodologia de instantâneo não é possível, você pode seguir a metodologia de reversão convencional mostrada no artigo "Tutorial: downgrade do Alteryx Server" da Comunidade.
Seção 6. Agende a atualização de produção
Uma vez testada com sucesso a atualização em seu ambiente de não produção e documentado seu processo de atualização, é hora de planejar a atualização do ambiente de produção.
Nota
Sua atualização de produção deve seguir o "roteiro" que você criou em seu ambiente de teste, com alterações específicas para diferenças de arquitetura entre os ambientes. Por exemplo, se o ambiente testado for uma arquitetura de nó único, mas o ambiente de produção tiver nós separados para Trabalhadores e a IU do Server, o ambiente de produção terá etapas de instalação adicionais. Esteja ciente disso durante o planejamento.
Dica profissional: use Notificações do Server por meio da IU do Alteryx Server como um canal de comunicação adicional para informar os usuários sobre atualizações pendentes. Você também pode postar informações de atualização em sua Comunidade Alteryx interna (por exemplo, SharePoint, Confluence, Yammer, Teams e assim por diante).
Você precisará agendar uma quantidade adequada de tempo de inatividade e informar aos usuários que os fluxos de trabalho no Server não serão executados durante a atualização. Para fluxos críticos para os negócios, os usuários podem executá-los em seu ambiente de teste recém-atualizado, executá-los localmente ou simplesmente planejar a interrupção e informar os públicos afetados em etapas posteriores sobre o atraso.
Se você está planejando atualizar também o Designer, seja por meio de métodos de empacotamento/automação ou processo de instalação manual, planeje o tempo extra e os recursos necessários para concluir as instalações, e informe sua base de usuários também. Lembre-se de que o Server é compatível com versões anteriores do Designer, até a versão 2022.3, mas as versões mais recentes do Designer não funcionam com versões mais antigas do Server. Assim, as atualizações do Server devem sempre preceder as atualizações do Designer.
Importante
Lembre-se de planejar sua atualização em um momento que minimize as interrupções em seu negócio. Consulte Considerações adicionais para obter mais detalhes e recomendações.
Seção 7. Executar a atualização de produção
Atualizar o Server
As etapas de nível elevado nesta seção são um espelho das etapas 1 a 6 na Seção 5. Consulte a seção apropriada para obter detalhes adicionais e links de ajuda.
Teste/Controle de qualidade da atualização.
Verifique se trabalhos agendados, coleções, funções de membro e fluxos de trabalho publicados ainda existem e funcionam conforme esperado (quando podem ser testados).
Execute uma reversão/restauração, se necessário.
Restaure a partir de backups ou siga o processo no artigo Tutorial: Downgrade do Alteryx Server da Comunidade.
Atualizar o Designer (opcional)
Uma vez que seu ambiente de produção esteja funcionando, você pode atualizar suas instalações do Designer, se elas forem parte de seu plano. Lembre-se de que o Designer não pode estar em uma versão superior à que foi instalada do Server, e essa atualização afeta diretamente as máquinas dos usuários. As etapas para atualizar o Designer podem ser encontradas em Fazer upgrade do Designer.
Compatibilidade do Designer e do Server
A versão do Designer precisa ser igual ou mais antiga do que a versão do Server à qual está conectada. A exceção é o Server 2022.3 (ou posterior), que requer pelo menos o Designer 2022.3 devido a alterações na criptografia.
A versão do Designer NÃO pode ser mais recente do que a do Server ao qual ele está conectado.
Apenas a versão (Ano.Versão) precisa corresponder, não o patch específico.
Semelhante a uma atualização do Server, as versões atualizadas do Designer devem ser testadas para garantir que os fluxos de trabalho continuem a ser executados e que as conexões com o Server ainda possam ser feitas. Tal como acontece com as práticas recomendadas para atualizações do Server, planeje testar sua atualização do Designer em um pequeno subconjunto de máquinas de usuário.
O que fazer se a atualização falhar
Se a atualização do Server falhar ou encontrar problemas críticos, não reinicie o processo de atualização repetidamente. Em vez disso, siga as etapas abaixo para coletar informações de diagnóstico e entre em contato com o Suporte ao Cliente da Alteryx para obter assistência.
1. Envie um tíquete de suporte
Abra um caso com o Suporte ao Cliente da Alteryx e inclua os seguintes detalhes:
A versão do Server de e para a qual você atualizou.
Uma breve descrição do que falhou (por exemplo, durante a instalação, após o início do serviço ou durante a migração do esquema).
Tipo de ambiente: esta é uma configuração de nó único ou de múltiplos nós?
Houve uma tentativa de migração de host ao mesmo tempo que a atualização?
Este é um ambiente de servidor de produção?
O carimbo de data/hora da falha e todas as mensagens de erro visíveis.
Alguma etapa de solução de problemas já foi realizada? (por exemplo, reinicialização do serviço, reinicialização do sistema ou tentativa de reversão manual)
Você tem um backup atual dos seus dados do Alteryx Server e do banco de dados?
Inclua os arquivos de log listados abaixo das últimas 24 horas (ou os 2 a 3 arquivos de log mais recentes) para solução de problemas:
Logs do Server (Gallery)
Local:
\%ProgramData%\Alteryx\Gallery\LogsLogs do serviço
Local:
\%ProgramData%\Alteryx\Service\AlteryxServiceLog.logSe disponíveis, inclua múltiplos arquivos
.log.RuntimeSettings.xml
Local:
\%ProgramData%\Alteryx\RuntimeSettings.xmlLog de migração do esquema AlteryxGallery configurado em Configurações de sistema do Alteryx > IU do Server > Diretório de log.
Versões 2025.1 e posteriores:
C:\ProgramData\Alteryx\Service\alteryx-gallery-migration.csvVersões 2024.2 e anteriores:
C:\ProgramData\Alteryx\Gallery\Logs\alteryx-migration.csv
Log de migração do esquema AlteryxService configurado em Configurações de sistema do Alteryx > Controlador > Registrar em log.
Versões 2025.1 e posteriores:
C:\ProgramData\Alteryx\Service\alteryx-service-migration.csvVersões 2024.2 e anteriores:
C:\ProgramData\Alteryx\Service\alteryx-migration.csv
AlteryxServiceMigrator_#.logs (necessário ao atualizar para ou por meio da versão 2022.3), encontrado em:
Logs da ferramenta de preparo:
C:\ProgramData\Alteryx\ServiceLogs de início do serviço: Configurações de sistema do Alteryx > Controlador > Geral > pasta Registrar em log
2. Informações adicionais (opcional)
Se possível, inclua também:
Capturas de tela de quaisquer mensagens de erro.
Arquivos de log do instalador (normalmente em
%TEMP% ou %LOCALAPPDATA%\Temp).A saída de qualquer ferramenta de preparo para migração usada antes da atualização.
3. Próximas etapas
Não desinstale nem reverta, a menos que instruído pelo Suporte da Alteryx.
Aguarde o Suporte analisar os logs e fornecer as orientações de correção.
Guias e artigos de ajuda
Nesta lista, você pode encontrar links para todos os recursos mencionados neste documento, bem como recursos adicionais que podem ser úteis no processo de atualização do Server.