Importante
Consulte a Lista de verificação para atualização do Server para ajudar a planejar e executar uma atualização bem-sucedida do Server, incluindo o fluxo de trabalho Verificações pré-atualização para identificar problemas que provocam falha nas atualizações.
Como este documento ajuda?
Este documento destaca as tarefas e alterações que você precisa conhecer ao atualizar versões do Alteryx Server. Os problemas são cumulativos, portanto, leia cada seção à medida que você atualiza as múltiplas versões. Este documento não substitui as Notas de versão (acesse os links em cada seção).
As versões semestrais adicionam recursos, mas também podem alterar o gerenciamento do Server, exigindo que você ou seus usuários mudem de comportamento.
As versões/patches de manutenção trimestrais abordam problemas encontrados na versão inicial. Por exemplo, a primeira versão de manutenção para 2022.3 seria 2022.3.2.
PONTO DE PARADA | Mudança significativa que requer atualização para esta versão antes de atualizar para uma versão posterior. |
Upgrade do MongoDB | A versão do banco de dados do Mongo foi atualizada. Uma atualização do Alteryx Server pode incluir apenas UMA atualização de versão do MongoDB entre a sua versão atual e a versão de atualização desejada. |
CRÍTICO | Problema crítico: os administradores devem analisar ou estar cientes de quando mudam para esta versão ou passam por ela. |
Critérios para entradas nesta lista
Esta lista resume as notas de cada versão para realçar quando:
os administradores ou usuários devem executar uma ação;
o item é importante na escolha de uma versão de atualização (ou seja, alteração de comportamento ou defeito);
uma mudança significativa foi feita na administração do Server.
O que há de novo / Notas de versão / Blog da Comunidade do Server / Visão geral no Blog da Comunidade
Versão | Ações necessárias ao atualizar para esta versão ou ao passar por ela. |
|---|---|
2022.3 CRÍTICO | Requisito de atualização para defeito TCPE-1100 da 2022.1: na atualização da 2022.1 para esta ou uma versão posterior, um patch é obrigatório. Impacto: se a versão atual é 22.1, você deve ter o 22.1.1.9.42691_Patch_9 ou posterior antes de atualizar para a versão 22.3, ou passar por ela, para evitar o defeito TCPE-1100. Esse defeito afeta os números de revisão de fluxo de trabalho, definindo todos como "1". Tarefa: aplique o patch 22.1 mais recente antes de prosseguir com a atualização se você ainda não estiver no Patch_9 ou posterior. |
2022.3 CRÍTICO | Nova criptografia do MongoDB: as coleções de bancos de dados devem ser recriptografadas com o padrão de hash AES256 e SHA256 antes da atualização Impacto: a ferramenta de preparo para a migração de criptografia deve ser executada antes da atualização para a versão 2022.3, ou posterior, para recriptografar os fluxos de trabalho em segundo plano enquanto o Server continua em operação. Após a execução da ferramenta de preparo, a primeira vez que o serviço for iniciado depois de atualizar mais algumas coleções e o RuntimeSettings.xml, ele também passará pela migração de criptografia. Tarefa: O Server deve ter a versão 2021.2 ou posterior antes de iniciar esse processo. Se a sua versão for anterior, faça a atualização para uma versão entre 2021.2 e 2022.1 antes de tentar atualizar para a versão 2022.3 ou posterior. Execute a ferramenta de preparo para migração de criptografia antes de atualizar o Server e verifique no log do Migrator se há linhas de erro com Após a atualização, você poderá excluir as coleções antigas não criptografadas. Entre em contato com o suporte para obter informações sobre como limpar os arquivos temporários criados e reduzir o tamanho do banco de dados do Mongo (consulte aqui os CSEs). Se você precisar reverter a atualização, restaure o backup do RuntimeSettings.xml feito durante a atualização: C:\ProgramData\Alteryx\. |
2022.3 CRÍTICO | Requisito de versão do Designer: Designer 2022.3 obrigatório Impacto: os métodos de criptografia utilizados pelo Server 2022.3 exigem o Designer 2022.3. Tarefa: os usuários devem atualizar o Designer para salvar os fluxos de trabalho no Server. |
2022.3 CRÍTICO | Alteração de configuração: o ponto de extremidade ACS de SAML deve ser em minúsculas Impacto: o ponto de extremidade ACS agora é em minúsculas (/saml2/acs), mas antes era uma combinação de maiúsculas e minúsculas (/Saml2/Acs). Isso impede que o serviço seja iniciado. [O TCPE-940 está solicitando que as duas formas, antiga e nova, sejam aceitas sem erros]. Tarefa: altere o ponto de extremidade ACS no IDP para que fique totalmente em letras minúsculas. |
2022.3 patch 2 | Alteração administrativa: opção para permitir que os usuários executem fluxos de trabalho por meio de conexões de banco de dados compartilhadas do Server Impacto: foi adicionada a opção Permitir acesso a fluxos de trabalho sem credenciais compartilhadas para permitir que um fluxo de trabalho que usa uma conexão de banco de dados compartilhada do Server seja executado por qualquer pessoa com quem o fluxo de trabalho foi compartilhado por meio de uma coleção. Os outros usuários não requerem o compartilhamento explícito da conexão do Gallery. Tarefa: vá para IU do Server > Administrador > Configurações > Ativos. Em seguida, marque a caixa de seleção Permitir acesso a fluxos de trabalho sem credenciais compartilhadas. |
2022.3 | Alteração de administração: balanceador de carga Impacto: foram adicionadas as opções Configurações de sistema do Alteryx > IU do Server > Endereço canônico para garantir que as mensagens de e-mail do Server usem o URL que seus usuários utilizam para acessar a IU do Server. Tarefa: se você usa um balanceador de carga, defina esses valores como o URL que os usuários normalmente usam para acessar a IU ou a API do Server. |
2022.3 | O relatório de uso do Server foi descontinuado Impacto: o relatório de uso do Server não tem mais suporte no Alteryx. As versões anteriores podem continuar funcionando. |
2022.3 | Gerenciamento de senhas: foi adicionado suporte ao cofre de senhas HashiCorp e CyberArk |
2022.3 | Acesso à ferramenta Baixar para renegociação de handshake menos seguro: o arquivo de configurações permite um controle específico do site Impacto: use a Lista de permissões para validação de pares se receber o "erro de conexão SSL" (em inglês, SSL connect error) da ferramenta Baixar. Ferramenta Baixar atualizada para OpenSSL 3.0.7. |
2022.3 | Alteração interna: tamanho do token do controlador Impacto: o Server 2021.4 introduziu um token do controlador mais longo e mais seguro, no entanto, as atualizações da versão 2021.3 mantiveram o token mais curto. Se o token não foi gerado para um tamanho maior em algum momento, ele será automaticamente gerado na atualização para a versão 2022.3. Isso será feito da mesma maneira em todos os nós para que eles criem o mesmo token mais longo e possam se comunicar com o controlador após a atualização. Tarefa: use o novo token do controlador para adicionar novos nós à arquitetura do Server no futuro. |
2022.3 | Defeito TGAL-7199: todas as versões de fluxo de trabalho com o rótulo "1" (corrigido no 2022.3.1_Patch2) Impacto: ao visualizar a lista de versões de um fluxo de trabalho, todas as versões exibem "1" em vez de um número de versão sequencial. Esse é um problema da interface do usuário e a versão correta está sendo usada para executar trabalhos. |
O que há de novo / Notas de versão
Versão | Ações necessárias ao atualizar para esta versão ou ao passar por ela. |
|---|---|
2023.1 CRÍTICO | Versão mínima do Designer Impacto: o Designer 2022.3 Patch 3 ou posterior é obrigatório para se conectar ao Server. Consulte as Notas de versão do Server 2023.1. |
2023.1 | Alteração administrativa: opção para permitir que os usuários executem fluxos de trabalho por meio de conexões de banco de dados compartilhadas do Server Impacto: foi adicionada a opção Permitir acesso a fluxos de trabalho sem credenciais compartilhadas para permitir que um fluxo de trabalho que usa uma conexão de banco de dados compartilhada do Server seja executado por qualquer pessoa com quem o fluxo de trabalho foi compartilhado por meio de uma coleção. Os outros usuários não requerem o compartilhamento explícito da conexão do Gallery. Tarefa: IU do Server > Administrador > Configurações > Ativos > marque a caixa de seleção Permitir acesso a fluxos de trabalho sem credenciais compartilhadas. |
2023.1 | Gerenciamento de senhas: foi adicionado suporte ao cofre de senhas AWS Secrets Manager Impacto: AWS Secrets Manager |
2023.1 | Adições de API: para servidores de autenticação do Active Directory (AD), um grupo do AD pode ser adicionado a um grupo personalizado Impacto: pontos de extremidade adicionados:
|
2023.1 | Alteração administrativa: suporte a grupos do Azure Active Directory com autenticação SAML Impacto: agora os administradores podem sincronizar o acesso de usuários e grupos ao Server usando o Azure Active Directory (Azure AD) e o protocolo SCIM. Tarefa: configurar o Azure Active Directory com SCIM no Alteryx Server |
2023.1 | Recurso de DCM: opção para desabilitar a sincronização do DCM entre o Designer e o Server Impacto: esse recurso é útil em um Server de produção para garantir que os usuários não sincronizem nem usem inadvertidamente uma credencial de produção no Designer local. Tarefa: Configurações de sistema do Alteryx > DCM > marque a caixa de seleção Bloquear a sincronização de conexões do DCM entre o Server e o Designer. Para obter mais informações, acesse DCM - Server. |
2023.1 | Alteração administrativa: os trabalhadores podem se conectar ao MongoDB gerenciado pelo usuário com credenciais exclusivas. Impacto: permite a auditoria por trabalhador. |
2023.1 | Conexões de banco de dados: fim da vida útil para conexões de banco de dados de 32 bits Impacto: perguntas frequentes sobre fim do suporte para conexões de banco de dados de 32 bits. As conexões de 32 bits deixarão de funcionar. |
2023.1 Instalador do R CRÍTICO | Atualização do R: atualizações da versão iintegrada do R de 4.1.3 para 4.2.3 no RInstaller_2023.1.1.200.exe ou posterior Impacto: a versão do R será 4.1.3 ou 4.2.3 conforme mostrado abaixo:
Tarefa:
Como usar a ferramenta R com pacotes compatíveis com o R versão 4.2.3 |
2023.1 | Defeitos de aplicativo analítico (corrigido no 2023.1_Patch_2) Impacto:
|
2023.1 CRÍTICO | Produto Connect: o Connect não é compatível com a versão inicial 2023.1 Impacto: as Notas de versão indicam o patch que é compatível com a versão 2022.3. |
O que há de novo / Notas de versão
Versão | Ações necessárias ao atualizar para esta versão ou ao passar por ela. |
|---|---|
2023.2 MongoDB 6.0.5 | Atualização do MongoDB: atualizações do MongoDB integrado da versão 4.2.15 para 6.0.5 Impacto: atualizações do MongoDB integrado para 6.0.5 Tarefa: se você usa o MongoDB integrado, a atualização para essa versão ou posterior atualizará o MongoDB para a versão 6.0.5. Observe os requisitos de espaço livre em disco de 1-2 vezes o tamanho atual do MongoDB. |
2023.2 CRÍTICO | Caixa de diálogo de atualização do MongoDB: a caixa de diálogo para iniciar a atualização do MongoDB integrado é minimizada Impacto: ao atualizar para 2023.2, depois de selecionar "Finalizar" na atualização, a caixa de diálogo de migração do MongoDB integrado é aberta, mas logo depois é minimizada, o que parece que a atualização foi concluída [TGAL-9041]. Para obter mais informações, consulte Error in Service logs when upgrading to Server version 23.2: Invalid feature compatibility version value, expected '5.0' or '5.3' or '6.0' (Erro nos logs do serviço ao atualizar para o Server versão 23.2: valor de versão de compatibilidade com recurso inválido, esperado "5.0", "5.3" ou "6.0"). Tarefa: torne essa caixa de diálogo visível e clique para iniciar a atualização do MongoDB. O serviço não será iniciado até que o MongoDB seja atualizado. |
2023.2 | Alteração do MongoDB: campo __ServiceDataBlob removido das coleções do AlteryxGallery Impacto: o campo __ServiceDataBlob foi removido das coleções do AlteryxGallery. Agora eles aparecem como campos padrão do MongoDB. Tarefa: se você tiver fluxos de trabalho administrativos que usavam a macro ServiceDataParser para desempacotar dados deste blob, eles precisarão ser refatorados. |
2023.2 | Alteração de administração do DCM: as conexões do DCM agora podem ser compartilhadas para colaboração Impacto: ao compartilhar uma conexão do DCM na IU do Server, a opção "Compartilhar para colaboração" permite que a conexão do DCM seja utilizada por outros utilizadores no Designer. Para obter mais informações, acesse Gerenciador de Conexões de Dados: IU do Server > Compartilhar no Designer. Tarefa: esta alteração facilita a colaboração de fluxos de trabalho compartilhados e a criação de novos fluxos de trabalho usando a conexão do DCM de um colega. |
2023.2 | Atualização do Python: atualizações do Python integrado da versão 3.8.5 para 3.8.16 Impacto: os usuários devem testar o Python nos fluxos de trabalho novamente. O motor ainda usa o Python versão 3, portanto deve haver pouco impacto nos scripts. Tarefa: para obter mais informações, consulte Python integrado ao Alteryx. |
O que há de novo / Notas de versão
Versão | Ações necessárias ao atualizar para esta versão ou ao passar por ela. |
|---|---|
2024.1 | Recurso administrativo: capacidade de transferir a propriedade de ativos por meio da IU e da API Os administradores podem transferir a propriedade de fluxos de trabalho e agendamentos entre usuários por meio da IU do Server ou usando os pontos de extremidade V3 da API do Server. Impacto:
Nota
|
2024.1 | Novo recurso: nova opção de banco de dados adicionada (SQL DB) É possível usar o banco de dados do SQL Server gerenciado pelo usuário em vez do MongoDB. No momento, as únicas versões com suporte oficial do SQL são MSSQL Server 2019 e 2022. Impacto: |
2024.1 CRÍTICO | Atualização do Python: atualizações do Python integrado da versão 3.8.16 para 3.10.13 Impacto: A seguinte mensagem de erro aparece se uma versão incompatível de conector é usada no Designer: "A versão 3.8 não foi encontrada em nossa distribuição do Alteryx. Selecione outra versão. Erro interno – deadlock detectado." Tarefa:
|
2024.1 CRÍTICO | Alteração do campo de data/hora do MongoDB (carimbos de data/hora do serviço movidos para o formato UTC nos bancos de dados do Server) Impacto: mudamos todos os campos de data/hora para a UTC para melhorar o processamento de alterações de fuso horário e horário de verão. Para obter mais informações, consulte as Notas de versão do Server 2024.1.
Tarefa: analise como os campos de data/hora são processados em aplicativos que acessam o MongoDB ou a API. Talvez seja preciso ajustá-los para esperar data/hora em UTC. |
2024.1 | Gerenciamento do Server de produção/DCM de desenvolvimento: o Server de produção pode redirecionar o DCM de desenvolvimento para conexões de produção Impacto: "Conexões do DCM" e "Tratamento de conexões do DCM" adicionadas ao menu de administração. Para obter mais informações, visite as seguintes páginas de ajuda: Tarefa: adiciona redirecionamentos do DCM ao Server de produção para permitir que fluxos de trabalho migrados do desenvolvimento acessem fontes de dados de produção sem alterações nos fluxos de trabalho. |
2024.1 | Administração do DCM: granularidade da permissão do usuário Impacto: novas permissões do DCM adicionadas. Para obter mais informações, acesse a página de ajuda Funções e permissões de usuário. |
2024.1 | Administração do DCM: cofre externo genérico do DCM adicionado Impacto: você pode configurar um cofre genérico capaz de recuperar segredos de qualquer cofre com uma interface programática usando autenticação básica. |
2024.1 | Alteração de administração: compartilhamento simultâneo no DCM Impacto: você pode compartilhar a mesma conexão do DCM para colaboração e, separadamente, para execução. Antes era possível escolher apenas uma opção de compartilhamento. Para obter mais informações, acesse Gerenciador de Conexões de Dados: IU do Server. |
2024.1 | Fim de vida da ferramenta Insights Impacto: os insights não estão mais disponíveis no Alteryx Server. Acesse nossa páginas de perguntas frequentes para obter mais informações. |
O que há de novo / Notas de versão
Versão | Ações necessárias ao atualizar para esta versão ou ao passar por ela. |
|---|---|
2024.2 PONTO DE PARADA CRÍTICO | Atualização do MongoDB integrado para a versão 7 Impacto: como parte da instalação do Server 2024.2, o MongoDB integrado é atualizado para a versão 7.0. A versão mínima do Server para atualização é 23.2 (MongoDB versão 6.0). Tarefa: certifique-se de que a versão do Server seja 2023.2 ou 2024.1 e siga os passos descritos nas Notas de versão do Server 2024.2. |
2024.2 | Migrar conexões de dados e fluxos de trabalho para o DCM Agora você pode migrar conexões de dados do Server compartilhadas para conexões do DCM. Para fazer isso, consulte como migrar conexões de dados do Server para o DCM e Conexões de dados. |
2024.2 | Possibilidade de limitar usuários em um estúdio para um usuário Os administradores podem desativar estúdios compartilhados limitando o número de usuários no estúdio a um usuário. Como administrador, agora você pode transferir facilmente a propriedade de ativos transferindo o fluxo de trabalho de um estúdio para outro. Para limitar o número de membros em um estúdio a um usuário, vá para Administrador > Configurações > Configuração > Usuários. Em seguida, marque a caixa de seleção Limitar o estúdio a 1 usuário. Para obter mais informações, acesse Configurações do Alteryx Server. |
2024.2 | Restrição para tornar os fluxos de trabalho públicos: configuração global Os administradores agora podem controlar como os fluxos de trabalho são publicados (de forma pública ou privada) marcando ou desmarcando a caixa de seleção Restringir fluxo de trabalho público (Global). Para fazer isso, acesse Administrador > Configurações > Segurança. Para obter mais informações, acesse Configurações do Alteryx Server. |
2024.2 | Configurações de proxy do Designer expandidas No Designer, Opções > Configurações de usuário > Editar configurações de usuário > Proxy > Habilitar novas configurações de proxy (visualização) foi adicionada para permitir um controle melhor das configurações de proxy e permitir scripts PAC. Observação: nesta versão inicial, a configuração é aplicada a vários recursos (por exemplo, ferramenta Baixar), mas não a outros (por exemplo, conectores ou ODBC) no Designer. Consulte as Configurações de usuário para obter mais detalhes. |
2024.2 | Configuração do sistema "Cancelar trabalhos em execução por mais de (segundos)" agora se aplica a todos os trabalhos Nas versões anteriores, essa configuração se aplicava apenas a trabalhos agendados. Para permitir que os trabalhos manuais sejam executados por mais tempo do que os trabalhos agendados, limpe essa configuração e utilize as duas novas opções da IU do Server explicadas abaixo. Para obter mais informações, acesse Configurações do Alteryx Server. |
Opção adicionada para cancelar execuções de trabalhos manuais de longa duração Em IU do Server > Administrador > Configurações > Ativos, há uma nova opção para cancelar as execuções de trabalhos manuais (incluindo as execuções de trabalhos de API) que são executadas por mais tempo do que um tempo especificado. Esse recurso se aplica a todos os trabalhadores, a menos que o trabalhador tenha definido Configurações de sistema do Alteryx > Trabalhador > Geral > Cancelar trabalhos em execução por mais de (segundos). A configuração "Trabalhador" substitui a configuração "IU do Server". | |
Opção adicionada para cancelar execuções de trabalhos agendados de longa duração Em IU do Server > Administrador > Configurações > Ativos, há uma nova opção para cancelar as execuções de trabalhos agendados que são executados por mais tempo do que um tempo especificado. Esse recurso se aplica a todos os trabalhadores, a menos que o trabalhador tenha definido Configurações de sistema do Alteryx > Trabalhador > Geral > Cancelar trabalhos em execução por mais de (segundos). A configuração "Trabalhador" substitui a configuração "IU do Server". | |
2024.2 | Atualizações de API: |
Filtragem de API adicionada a GET v3/workflows/{workflowID}/jobs O ponto de extremidade
Tarefa: analise como os campos de data/hora são processados em aplicativos que acessam o MongoDB ou a API. Talvez seja preciso ajustá-los para esperar data/hora em UTC. | |
Novos pontos de extremidade de API para assinaturas (estúdios) Os administradores podem agora gerenciar assinaturas (estúdios) por meio dos pontos de extremidade V3 da API do Server. Esses pontos de extremidade ajudam a editar assinaturas em massa e permitem mover usuários individuais de volta para estúdios individuais. Para obter mais informações sobre os pontos de extremidade, acesse Pontos de extremidade de assinatura. | |
Atualizações de API para pontos de extremidade de fluxos de trabalho
Para obter mais informações, consulte as Notas de versão do Server 2024.2 e os Pontos de extremidade de fluxos de trabalho. | |
Novo ponto de extremidade de API para permitir a atualização de configurações de agendamentos individuais Use o novo ponto de extremidade de API | |
Atualizações para pontos de extremidade de trabalhos
Para obter mais informações, acesse Pontos de extremidade de trabalhos. |