⚐ 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.
- Gere um backup do banco de dados a ser atualizado.
- 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
- 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;
- Desinstale os programas Aranda Conserver Service e Aranda DEVICE MANAGEMENT do painel de controle.
- 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
- Verifique os requisitos antes de executar o instalador Aranda.ADM.Web.Installer.exe.
- Exibir instalação do ADM Web Console no ambiente local
- 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).
- 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
- Verifique a conexão repserver a partir do console da web.
- 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
- 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.
- Desinstale e instale o conservador