Validate Linux installation

After installing the Agent Client Collector on a Linux system, validate the installation by ensuring it was completed properly.

Avant de commencer

Install the Agent Client Collector on a Linux system (see Install Agent Client Collector on a Linux system).

Role required: agent_client_collector_admin

Procédure

1. Run the # systemctl status acc command.
   The active (running) indicator appears when the service is running properly.

   # systemctl status acc
   ● acc.service - Agent-Now ACC
   Loaded: loaded (/usr/lib/systemd/system/acc.service; enabled; vendor preset: disabled)
   Active: active (running) since Mon 2022-04-25 14:10:24 UTC; 6 months 23 days ago
   Main PID: 2693 (acc)
   Tasks: 10 (limit: 512)
   Memory: 143.4M (limit: 192.0M)
   CPU: 12h 57min 50.442s
   CGroup: /system.slice/acc.service
   └─2693 /usr/share/servicenow/agent-client-collector/bin/acc start --config-file
   /etc/servicenow/agent-client-collect...

2. View the encrypted api-key and agent-key-id in use by running the grep -E '^api-key|agent-key-id' /etc/servicenow/agent-client-collector/acc.yml command.

   # grep -E '^api-key|agent-key-id' /etc/servicenow/agent-client-collector/acc.yml
   api-key: "encrypted:adskfjldfjlasd+ajflksadjmoreunreadablestringasdfdfkdjksdjaasdfas"
   agent-key-id: b4ac2ab4ac2b4ac2b4ac2b4ac2b4ac2b4ac2b4ac2b4ac2b4ac2b4ac2b4ac2b4a

   Remarque :

   The grep command must appear on a single line.
3. View the agent's connection with its backend URL by running the grep 'successfully connected' /var/log/servicenow/agent-client-collector/acc.log command.

   # grep 'successfully connected' /var/log/servicenow/agent-client-collector/acc.log
   2022-11-17T19:03:17.94 [INFO] [agent] successfully connected to the url:
   wss://MY_BACKEND_FQDN:MY_BACKEND_PORT/ws/events

   Remarque :

   The grep command must appear on a single line.
4. Verify the unique agent ID by running the # echo $(hexdump -e '/1 "%02x"' /var/cache/servicenow/agent-client-collector/agent_now_id) command.

   # echo $(hexdump -e '/1 "%02x"' /var/cache/servicenow/agent-client-collector/agent_now_id)
   14b4443df6d2394d

   The indicated agent ID appears on the Agents page in an instance (All > Agent Client Collector > Agents) with Status = Up and Host data collection = Collected (both appearing in green).

   Figure 1. Linux agents - green status