PT
Español
English
Português
    Migração ADM da 9.25.1 para a versão 9.25.2 (compatível com a versão 9.5.58 do banco de dados)


    ⚐ Nota: Antes de atualizar, verifique se a ordenação do banco de dados está em (SQL_Latin1_General_CP1_CI_AI).


    ⚐ Nota: Se você precisar migrar a coleta de banco de dados: Consulte Migrar agrupamento para banco de dados


    ⚐ Nota: Nas implementações do sistema ADM em ambientes Onpremise, ao migrar de versões iguais ou inferiores à 9.22.0 para a versão 9.22.1 ou superior, é imprescindível realizar uma ação adicional relacionada às pastas de atualização (AgentUpdate) e gravações (Recordings) para garantir a correta visualização das auditorias e instalação dos agentes. As etapas estão listadas abaixo:

    Pastas a serem movidas

    Durante a atualização, as seguintes pastas e seu conteúdo devem ser movidos do caminho original do repserver:

    • %dir_Repserver%\Atualização do Agente
    • %dir_Repserver%\Gravações

    %dir_Repserver% refere-se ao caminho configurado para o Repserver padrão C:\Repserver\

    Para o diretório configurado para o Content Manager.

    A estrutura deve ser preservada como está, ou seja:

    • %dir_ContentManager%\Atualização do Agente
    • %dir_ContentManager%\Gravações

    %dir_ContentManager% refere-se ao caminho configurado para o Gerenciador de conteúdo padrão C:\ContentManager\

    Importante: Os nomes exatos das pastas (AgentUpdate e Recordings) devem ser mantidos para garantir a compatibilidade com os serviços do sistema.

    Consequências de pular esta ação

    Se essas pastas não forem movidas:

    • As gravações não serão exibidas corretamente nas auditorias.
    • Ocorrerão inconsistências nos logs do sistema.
    • Os agentes não poderão ser baixados corretamente.


    1. Gere um backup do banco de dados a ser atualizado.
    2. Pare os seguintes serviços da Aranda manualmente ou usando as ferramentas do Aranda DataBase:
    • Catálogo Aranda Cruncher
    • Aranda Cruncher Energia
    • Arquivo Aranda Cruncher
    • Inventário Aranda Cruncher
    • Aranda Cruncher Patch
    • Uso do Aranda Cruncher
    • Aranda Licença Serviço Windows
    • Serviço do Windows do Agendador Aranda
    • Serviço do Windows do Aranda Worker
      1. Se o banco de dados que você está atualizando estiver em uma versão anterior à 9.5.58, execute manualmente os seguintes scripts no SQL Server Management Studio no banco de dados ADM nesta ordem:

    ⚠ Aviso: Se você não executar os scripts, a atualização do banco de dados para a versão 9.5.58 pode falhar.

      **Roteiro 1: ASM_CLEAN_WINDOW_INFORMATION_UNIFICADO**
       
      Este script depura a tabela ASM_WINDOW_INFORMATION e mantém apenas os títulos das janelas usados pelo detalhe de uso do software. Com base no número de registros, o script escolhe automaticamente como depurá-los; se não encontrar registros para depurar, não faz alterações.
    
          /*
          ============================================================================
           Script   : ASM_CLEAN_WINDOW_INFORMATION_UNIFICADO
           Objetivo : Depurar ASM_WINDOW_INFORMATION en un solo script. Primero
                      diagnostica (total, filas a conservar, filas a eliminar) y
                      decide la ruta automáticamente:
                      - Sin huérfanos             -> no ejecuta nada.
                      - Conservar < 50% del total -> ruta de conservación.
                      - En otro caso              -> ruta de eliminación por rangos.
                      @i_conservacion (calculado) = 1 -> Conserva solo las filas referenciadas en
                                             ASM_SOFTWARE_USAGE_DETAIL: respaldo,
                                             TRUNCATE y reinserción.
                                             Requiere ventana de mantenimiento, sin
                                             escritura de la aplicación.
                      @i_conservacion = 0 -> Depura por rangos de ID (DELETE por lotes),
                                             evitando escanear la tabla completa, y
                                             reconstruye la tabla al finalizar.
          ============================================================================
          */
       
          DECLARE @i_range_size   INT = 10000,
                  @i_delay_ms     INT = 50,
                  @i_dry_run      BIT = 0;
       
          SET NOCOUNT ON;
          SET XACT_ABORT ON;
       
          DECLARE @i_conservacion BIT = NULL;
          DECLARE @v_total_filas  BIGINT;
          DECLARE @v_filas_cons   BIGINT;
          DECLARE @v_recomend     VARCHAR(60);
       
          SELECT @v_total_filas = t.total_filas,
                 @v_filas_cons  = t.filas_a_conservar
          FROM   (SELECT (SELECT COUNT_BIG(*)
                          FROM   dbo.ASM_WINDOW_INFORMATION)                     AS total_filas,
                         (SELECT COUNT_BIG(*)
                          FROM   dbo.ASM_WINDOW_INFORMATION wi
                          WHERE  EXISTS (SELECT 1
                                         FROM   dbo.ASM_SOFTWARE_USAGE_DETAIL sud
                                         WHERE  sud.window_info_id = wi.id))     AS filas_a_conservar) t
          OPTION (MAXDOP 2);
       
          SET @v_recomend = CASE
                                WHEN @v_total_filas = @v_filas_cons                   THEN 'No hay huérfanos: no enviar ningún script'
                                WHEN 1.0 * @v_filas_cons / @v_total_filas < 0.5       THEN 'Enviar script de conservación'
                                ELSE                                                       'Enviar script de eliminación'
                            END;
       
          SET @i_conservacion = CASE
                                    WHEN @v_total_filas = @v_filas_cons               THEN NULL
                                    WHEN 1.0 * @v_filas_cons / @v_total_filas < 0.5   THEN 1
                                    ELSE                                                   0
                                END;
       
          SELECT @v_total_filas                                                                              AS total_filas,
                 @v_filas_cons                                                                               AS filas_a_conservar,
                 @v_total_filas - @v_filas_cons                                                              AS filas_a_eliminar,
                 CAST(100.0 * @v_filas_cons / NULLIF(@v_total_filas, 0) AS DECIMAL(5, 2))                    AS pct_conservar,
                 CAST(100.0 * (@v_total_filas - @v_filas_cons) / NULLIF(@v_total_filas, 0) AS DECIMAL(5, 2)) AS pct_eliminar,
                 @v_recomend                                                                                 AS recomendacion;
       
          DECLARE @v_ident        BIGINT;
          DECLARE @min_id         INT;
          DECLARE @max_id         INT;
          DECLARE @range_start    INT;
          DECLARE @range_end      INT;
          DECLARE @rows_deleted   INT;
          DECLARE @candidatos     INT;
          DECLARE @total_deleted  BIGINT = 0;
          DECLARE @total_evaluado BIGINT = 0;
          DECLARE @delay_time     VARCHAR(12) = '00:00:00.' + RIGHT('000' + CAST(@i_delay_ms AS VARCHAR), 3);
       
          IF @i_conservacion IS NULL
              PRINT 'No hay huérfanos: no se ejecuta ninguna depuración.';
          ELSE IF @i_conservacion = 1
          BEGIN
       
              SET @v_ident = CAST(IDENT_CURRENT('dbo.ASM_WINDOW_INFORMATION') AS BIGINT);
       
              DROP TABLE IF EXISTS dbo.ASM_WINDOW_INFORMATION_BKP;
       
              SELECT wi.id,
                     wi.title,
                     wi.title_hash
              INTO   dbo.ASM_WINDOW_INFORMATION_BKP
              FROM   dbo.ASM_WINDOW_INFORMATION wi
              WHERE  EXISTS (SELECT 1
                             FROM   dbo.ASM_SOFTWARE_USAGE_DETAIL sud
                             WHERE  sud.window_info_id = wi.id);
       
              BEGIN TRY
       
                  BEGIN TRANSACTION;
       
                      ALTER TABLE dbo.ASM_SOFTWARE_USAGE_DETAIL
                          DROP CONSTRAINT FK05_ASM_SOFTWARE_USAGE_DETAIL;
       
                      TRUNCATE TABLE dbo.ASM_WINDOW_INFORMATION;
       
                      SET IDENTITY_INSERT dbo.ASM_WINDOW_INFORMATION ON;
       
                      INSERT INTO dbo.ASM_WINDOW_INFORMATION (id,
                                                              title,
                                                              title_hash)
                      SELECT b.id,
                             b.title,
                             b.title_hash
                      FROM   dbo.ASM_WINDOW_INFORMATION_BKP b
                      ORDER  BY b.id;
       
                      SET IDENTITY_INSERT dbo.ASM_WINDOW_INFORMATION OFF;
       
                      DBCC CHECKIDENT (
                          'dbo.ASM_WINDOW_INFORMATION',
                          RESEED,
                          @v_ident
                      ) WITH NO_INFOMSGS;
       
                      ALTER TABLE dbo.ASM_SOFTWARE_USAGE_DETAIL WITH CHECK
                          ADD CONSTRAINT FK05_ASM_SOFTWARE_USAGE_DETAIL
                          FOREIGN KEY (window_info_id)
                          REFERENCES dbo.ASM_WINDOW_INFORMATION (id);
       
                      IF (SELECT COUNT_BIG(*)
                          FROM dbo.ASM_WINDOW_INFORMATION)
                         <>
                         (SELECT COUNT_BIG(*)
                          FROM dbo.ASM_WINDOW_INFORMATION_BKP)
                      BEGIN
                          RAISERROR(
                              'La cantidad de filas restauradas no coincide con el respaldo. Se conserva ASM_WINDOW_INFORMATION_BKP para revisión.',
                              16,
                              1
                          );
                      END;
       
                  COMMIT TRANSACTION;
       
                  DROP TABLE dbo.ASM_WINDOW_INFORMATION_BKP;
       
                  PRINT 'Depuración completada. Tabla de respaldo eliminada.';
       
              END TRY
              BEGIN CATCH
       
                  IF @@TRANCOUNT > 0
                      ROLLBACK TRANSACTION;
       
                  BEGIN TRY
                      SET IDENTITY_INSERT dbo.ASM_WINDOW_INFORMATION OFF;
                  END TRY
                  BEGIN CATCH
                  END CATCH;
       
                  PRINT 'La depuración no se completó. Se conserva ASM_WINDOW_INFORMATION_BKP para revisión.';
       
                  THROW;
       
              END CATCH;
       
              SELECT COUNT_BIG(*) AS filas_conservadas
              FROM   dbo.ASM_WINDOW_INFORMATION;
       
          END
          ELSE
          BEGIN
       
              SELECT @min_id = MIN([id]),
                     @max_id = MAX([id])
              FROM   [dbo].[ASM_WINDOW_INFORMATION];
       
              PRINT 'Rango total a evaluar: ' + CAST(@min_id AS VARCHAR) + ' - ' + CAST(@max_id AS VARCHAR);
       
              SET @range_start = @min_id;
       
              WHILE @range_start <= @max_id
              BEGIN
                  SET @range_end = @range_start + @i_range_size - 1;
       
                  IF @i_dry_run = 1
                  BEGIN
                      SELECT @candidatos = COUNT(*)
                      FROM   [dbo].[ASM_WINDOW_INFORMATION] wi
                      WHERE  wi.[id] BETWEEN @range_start AND @range_end
                        AND  NOT EXISTS (SELECT 1
                                         FROM   [dbo].[ASM_SOFTWARE_USAGE_DETAIL] sud
                                         WHERE  sud.[window_info_id] = wi.[id]);
       
                      SET @total_evaluado += @candidatos;
       
                      RAISERROR('Rango %d - %d | candidatos: %d', 0, 1, @range_start, @range_end, @candidatos) WITH NOWAIT;
                  END
                  ELSE
                  BEGIN
                      DELETE wi
                      FROM   [dbo].[ASM_WINDOW_INFORMATION] wi
                      WHERE  wi.[id] BETWEEN @range_start AND @range_end
                        AND  NOT EXISTS (SELECT 1
                                         FROM   [dbo].[ASM_SOFTWARE_USAGE_DETAIL] sud
                                         WHERE  sud.[window_info_id] = wi.[id]);
       
                      SET @rows_deleted = @@ROWCOUNT;
                      SET @total_deleted += @rows_deleted;
       
                      RAISERROR('Rango %d - %d | eliminados: %d', 0, 1, @range_start, @range_end, @rows_deleted) WITH NOWAIT;
                  END
       
                  SET @range_start = @range_end + 1;
       
                  IF @i_delay_ms > 0
                      WAITFOR DELAY @delay_time;
              END
       
              IF @i_dry_run = 1
                  PRINT 'MODO DRY-RUN: candidatos a eliminar (estimado): ' + CAST(@total_evaluado AS VARCHAR);
              ELSE
                  PRINT 'Total de registros eliminados: ' + CAST(@total_deleted AS VARCHAR);
       
              ALTER TABLE dbo.ASM_WINDOW_INFORMATION REBUILD WITH (ONLINE = ON);
       
          END;
       
          GO
    
      **Script 2: Mesclar asm_uso_software registro por título duplicado**
       
      Este script unifica na tabela ASM_SOFTWARE_USAGE_DETAIL os logs de uso de software associados ao Windows com o mesmo título e soma suas durações. Ao final da execução, verifique se o valor de *"Durações atualizadas"* é igual ao valor de *"Grupos de detalhe processados"*. O aviso *"Valor nulo eliminado"* É esperado.
    
          /*
          ==============================================================================
            Unificación de ASM_SOFTWARE_USAGE_DETAIL por title_hash duplicado
       
            Consolida el detalle que apunta a ventanas con el mismo title_hash: por
            cada device_id, file_id, logon_user_id y date_id deja una sola fila en la
            ventana destino (MIN(id) del hash) con la suma de las duraciones.
            ASM_WINDOW_INFORMATION es solo de lectura.
       
            PRECONDICIONES
              - Detener procesos de cruncher y worker previo a la ejecución del script.
              - Ventanas con el mismo title_hash equivalentes en todos sus atributos.
       
            EJECUCIÓN Y RESULTADO
              - Transacción única: ante un error se revierte todo.
              - "Duraciones actualizadas" debe ser igual a "Grupos de detalle
                procesados". El aviso "Null value is eliminated" es esperado.
              - Antes de reanudar los procesos, comparar contra el respaldo la suma
                de duration por device_id, file_id, logon_user_id y date_id.
          ==============================================================================
          */
          SET NOCOUNT ON;
          SET XACT_ABORT ON;
       
          DECLARE @start_time DATETIME2 = SYSDATETIME();
          DECLARE @elapsed_sec INT;
       
          DECLARE @used_hashes BIGINT;
          DECLARE @duplicate_hashes BIGINT;
          DECLARE @mapped_windows BIGINT;
          DECLARE @merge_groups BIGINT;
          DECLARE @durations_updated BIGINT;
          DECLARE @rows_deleted BIGINT;
          DECLARE @rows_remapped BIGINT;
       
          BEGIN TRY
              BEGIN TRANSACTION;
       
              RAISERROR(
                  'Inicio de unificacion de ASM_SOFTWARE_USAGE_DETAIL.',
                  0, 1
              ) WITH NOWAIT;
       
              DROP TABLE IF EXISTS #UsedHash;
              DROP TABLE IF EXISTS #DuplicateHash;
              DROP TABLE IF EXISTS #WindowMap;
              DROP TABLE IF EXISTS #Merge;
       
              /* Hash utilizados por el detalle */
              SELECT DISTINCT
                  wi.title_hash
              INTO #UsedHash
              FROM dbo.ASM_SOFTWARE_USAGE_DETAIL d
              INNER JOIN dbo.ASM_WINDOW_INFORMATION wi
                  ON wi.id = d.window_info_id
              WHERE wi.title_hash IS NOT NULL;
       
              SET @used_hashes = @@ROWCOUNT;
              SET @elapsed_sec = DATEDIFF(
                  SECOND, @start_time, SYSDATETIME()
              );
       
              RAISERROR(
                  'Title_hash con uso: %I64d | %d s',
                  0, 1,
                  @used_hashes,
                  @elapsed_sec
              ) WITH NOWAIT;
       
              /* Hash duplicados y ventana que se conservará */
              SELECT
                  wi.title_hash,
                  MIN(wi.id) AS target_window_id
              INTO #DuplicateHash
              FROM dbo.ASM_WINDOW_INFORMATION wi
              INNER JOIN #UsedHash h
                  ON h.title_hash = wi.title_hash
              GROUP BY wi.title_hash
              HAVING COUNT(*) > 1;
       
              SET @duplicate_hashes = @@ROWCOUNT;
              SET @elapsed_sec = DATEDIFF(
                  SECOND, @start_time, SYSDATETIME()
              );
       
              RAISERROR(
                  'Title_hash duplicados con uso: %I64d | %d s',
                  0, 1,
                  @duplicate_hashes,
                  @elapsed_sec
              ) WITH NOWAIT;
       
              /* Ventanas pertenecientes a los grupos duplicados */
              SELECT
                  wi.id AS window_info_id,
                  dh.target_window_id
              INTO #WindowMap
              FROM dbo.ASM_WINDOW_INFORMATION wi
              INNER JOIN #DuplicateHash dh
                  ON dh.title_hash = wi.title_hash;
       
              SET @mapped_windows = @@ROWCOUNT;
       
              CREATE UNIQUE CLUSTERED INDEX IX_WindowMap
                  ON #WindowMap (window_info_id);
       
              SET @elapsed_sec = DATEDIFF(
                  SECOND, @start_time, SYSDATETIME()
              );
       
              RAISERROR(
                  'Ventanas incluidas en el mapa: %I64d | %d s',
                  0, 1,
                  @mapped_windows,
                  @elapsed_sec
              ) WITH NOWAIT;
       
              /*
                Agrupar por la llave final.
       
                Si ya existe una fila en target_window_id, se conserva.
                De lo contrario, se conserva una de las filas existentes.
              */
              SELECT
                  d.device_id,
                  d.file_id,
                  d.logon_user_id,
                  d.date_id,
                  m.target_window_id,
                  COALESCE(
                      MAX(
                          CASE
                              WHEN d.window_info_id = m.target_window_id
                              THEN d.window_info_id
                          END
                      ),
                      MIN(d.window_info_id)
                  ) AS survivor_window_id,
                  SUM(CONVERT(BIGINT, d.duration)) AS total_duration
              INTO #Merge
              FROM dbo.ASM_SOFTWARE_USAGE_DETAIL d
              INNER JOIN #WindowMap m
                  ON m.window_info_id = d.window_info_id
              GROUP BY
                  d.device_id,
                  d.file_id,
                  d.logon_user_id,
                  d.date_id,
                  m.target_window_id;
       
              SET @merge_groups = @@ROWCOUNT;
              SET @elapsed_sec = DATEDIFF(
                  SECOND, @start_time, SYSDATETIME()
              );
       
              RAISERROR(
                  'Grupos de detalle procesados: %I64d | %d s',
                  0, 1,
                  @merge_groups,
                  @elapsed_sec
              ) WITH NOWAIT;
       
              /* Actualizar la duración del registro que se conservará */
              UPDATE d
              SET d.duration = m.total_duration
              FROM dbo.ASM_SOFTWARE_USAGE_DETAIL d
              INNER JOIN #Merge m
                  ON m.device_id = d.device_id
                 AND m.file_id = d.file_id
                 AND m.logon_user_id = d.logon_user_id
                 AND m.date_id = d.date_id
                 AND m.survivor_window_id = d.window_info_id;
       
              SET @durations_updated = @@ROWCOUNT;
              SET @elapsed_sec = DATEDIFF(
                  SECOND, @start_time, SYSDATETIME()
              );
       
              RAISERROR(
                  'Duraciones actualizadas: %I64d | %d s',
                  0, 1,
                  @durations_updated,
                  @elapsed_sec
              ) WITH NOWAIT;
       
              /* Eliminar los registros redundantes */
              DELETE d
              FROM dbo.ASM_SOFTWARE_USAGE_DETAIL d
              INNER JOIN #WindowMap wm
                  ON wm.window_info_id = d.window_info_id
              INNER JOIN #Merge m
                  ON m.device_id = d.device_id
                 AND m.file_id = d.file_id
                 AND m.logon_user_id = d.logon_user_id
                 AND m.date_id = d.date_id
                 AND m.target_window_id = wm.target_window_id
              WHERE d.window_info_id <> m.survivor_window_id;
       
              SET @rows_deleted = @@ROWCOUNT;
              SET @elapsed_sec = DATEDIFF(
                  SECOND, @start_time, SYSDATETIME()
              );
       
              RAISERROR(
                  'Registros redundantes eliminados: %I64d | %d s',
                  0, 1,
                  @rows_deleted,
                  @elapsed_sec
              ) WITH NOWAIT;
       
              /*
                Reasignar el sobreviviente después de eliminar las filas
                que podrían producir la colisión de la llave única.
              */
              UPDATE d
              SET d.window_info_id = m.target_window_id
              FROM dbo.ASM_SOFTWARE_USAGE_DETAIL d
              INNER JOIN #Merge m
                  ON m.device_id = d.device_id
                 AND m.file_id = d.file_id
                 AND m.logon_user_id = d.logon_user_id
                 AND m.date_id = d.date_id
                 AND m.survivor_window_id = d.window_info_id
              WHERE m.survivor_window_id <> m.target_window_id;
       
              SET @rows_remapped = @@ROWCOUNT;
              SET @elapsed_sec = DATEDIFF(
                  SECOND, @start_time, SYSDATETIME()
              );
       
              RAISERROR(
                  'Registros sobrevivientes reasignados: %I64d | %d s',
                  0, 1,
                  @rows_remapped,
                  @elapsed_sec
              ) WITH NOWAIT;
       
              COMMIT TRANSACTION;
       
              SET @elapsed_sec = DATEDIFF(
                  SECOND, @start_time, SYSDATETIME()
              );
       
              RAISERROR(
                  'Unificacion finalizada correctamente | eliminados: %I64d | reasignados: %I64d | %d s',
                  0, 1,
                  @rows_deleted,
                  @rows_remapped,
                  @elapsed_sec
              ) WITH NOWAIT;
          END TRY
          BEGIN CATCH
              IF @@TRANCOUNT > 0
                  ROLLBACK TRANSACTION;
       
              DECLARE @error_message NVARCHAR(2048) = ERROR_MESSAGE();
              DECLARE @error_number INT = ERROR_NUMBER();
              DECLARE @error_line INT = ERROR_LINE();
       
              RAISERROR(
                  'ERROR %d en linea %d. Se realizo ROLLBACK: %s',
                  0, 1,
                  @error_number,
                  @error_line,
                  @error_message
              ) WITH NOWAIT;
       
              THROW;
          END CATCH;
    
    1. Desinstale os programas Aranda Conserver Service e Aranda DEVICE MANAGEMENT do painel de controle.
    2. Exclua os registros nas seguintes pastas:
    • Exclua o conteúdo que está na pasta “%Arquivos de Programas (x86)%\Aranda\Aranda Services”
    • Exceção da pasta ‘Downloads’, porque o catálogo de patches é salvo nela.
    • “%Program Files (x86)%\Aranda\Conserver”.
    • Pasta “%inetpub\wwwroot\ADM”
    • Pasta “%inetpub\wwwroot\RepServer”

    ⚐ Nota:: Não apague o conteúdo dos repositórios de contêineres

    1. Verifique os requisitos antes de executar o instalador Aranda.ADM.Web.Installer.exe.
    • Exibir instalação do ADM Web Console no ambiente local
      1. Execute o Aranda DataBase Tools para que todos os arquivos .config para apontar para o banco de dados migrado (consulte as etapas de execução no documento da base de conhecimento).
      2. Carregue os serviços da Aranda, seja pelo aplicativo Aranda DataBase Tools ou pela lista de serviços:
    • Catálogo Aranda Cruncher
    • Aranda Cruncher Energia
    • Arquivo Aranda Cruncher
    • Inventário Aranda Cruncher
    • Aranda Cruncher Patch
    • Uso do Aranda Cruncher
    • Aranda Licença Serviço Windows
    • Serviço do Windows do Agendador Aranda
    • Serviço do Windows do Aranda Worker
      1. Verifique a conexão repserver a partir do console da web.
      2. Caso você tenha o serviço Mosquitto MQTT, você deve desinstalá-lo na seção Desinstalar o Mosquitto MQTT Broker e, em seguida, executar o instalador do corretor MQTT.
    • Consulte a instalação do ambiente OnPremise
    • Instalação Aranda MQTT Broker OnPremise ambientes
      1. Verifique se todos os serviços Aranda estão em execução.

    ⚐ Nota: Realize essa etapa somente se a versão ADM da qual você está migrando for inferior à 9.25.1. Se você já tem o Conservador 9.25.1, pule este passo: 24 horas após a atualização do console ADM, o Conservador tentará automaticamente atualizar para a versão mais recente lançada para o console ADM.

    1. Desinstale e instale o conservador