SNMP Manager Installation
SNMP Manager Installation
Prerequisites
- For prerequisite checks for agent installation, see Prerequisite checks for agent installation.
- SixthSense SNMP Manager Agent. See Download the Agent, Configure the SNMP Manager Agent
- URL/IP of the Sixthsense collector (your tenant URL provided by Customer Support)
- Access token provided by Customer Support.
- PACKAGE_TOKEN - Access Token required for downloading SixthSense Package provided by Customer Support.
- PACKAGE_TOKEN_USERNAME - Username for Access Token provided by Customer Support.
- TOKEN - Access Token from the SixthSense portal Settings page.
- For supported agent versions and devices, see Supported Devices & Versions
Download & Unzip the agent
- Download latest sixthsense-snmp-manager-agent-5.11.00.zip release binary provided by Customer Support.
export PACKAGE_TOKEN="token"
export AGENT_VERSION="5.11.0"
curl --header "PRIVATE-TOKEN:${PACKAGE_TOKEN}" --output ss_snmp_manager_agent_${AGENT_VERSION}.zip "https://artifacts-observability.sixthsense.rakuten.com/api/v4/projects/69/packages/maven/snmp/sixthsense-snmp-agent/v1.0.0/sixthsense-snmp-manager-agent.zip"
- Unzip release binary and go to the agent directory.
unzip ss_snmp_manager_agent_${AGENT_VERSION}.zip
cd ss_snmp_manager_agent_${AGENT_VERSION}
- Unzip respective OS & arch binary in the agent directory. Supported OS & Architecture.
cd ss_snmp_manager_agent_${AGENT_VERSION}
unzip sixthsense-snmp-manager-agent_{os}-{arch}.zip
cd sixthsense-snmp-manager-agent_{os}-{arch}
- Give permission to the binary, configuration file for all.
- **sudo chmod -R +x /snmpmanager_agent_directory/ss_snmp_manager_agent_5.11.0/sixthsense-snmp-manager-agent{os}-{arch}
Configure the SNMP Manager agent
Update config.yaml as per the instructions mentioned in the configuration file.
### SNMP Manager Configuration
snmpManager:
name: "SNMP Manager 1" # Name of the SNMP Manager instance
location: "Bengaluru" # Physical location of the SNMP Manager
authToken: "" # Authentication token (Can be found in Sixthsense settings page)
syncIntervalMinutes: 2 # Interval in minutes for synchronizing with the NMS
icmpPingRequestsCount: 5 # Number of ICMP ping requests to send for latency measurement
retryPolicy:
maxRetries: 2 # Maximum number of retries for failed SNMP requests
snmpAgentPort: 161 # Port on which the SNMP agents are listening
maxThreadPoolSize: 60 # Maximum number of threads in the thread pool for handling discovery and polling tasks
nms:
baseURL: "" # Base URL of the Network Management System (NMS)
timeoutMs: 5000 # Timeout in milliseconds for NMS API requests
telemetry:
enabled: true # Enable or disable telemetry data collection
endpoint: "" # Grpc endpoint for sending telemetry data
port: 443 # Port for the gRPC server to listen on for telemetry data
sslEnabled: true # Enable or disable SSL for the gRPC server
TLSCertFile: "" # Path to the TLS certificate file for SSL
logging:
level: "info" # Logging level
filePath: "" # Path to the log file
Start the agent
Start the agent directly using nohup (Linux/Darwin)
To start the agent, use the following command.
nohup ./snmp_manager_agent_directory/ss_snmp_manager_agent_5.11.0/sixthsense-snmp-manager-agent_{os}-{arch}/sixthsense-snmp-manager-agent &
In case of network restrictions, append proxy to the nohup command to enable connection to sixthsense-backend.
nohup HTTPS_PROXY=proxy-server:port /snmp_manager_agent_directory/ss_snmp_manager_agent_5.11.0/sixthsense-snmp-manager-agent_{os}-{arch}/sixthsense-snmp-manager-agent &
- nohup - to start with logs, logs will be stored in nohup.out file
- "&" - to start as background process
Start the agent as a Service (Windows)
- Register Sixthsense SNMP Manager Agent as a service in Windows with following command to monitor Windows Host.
sc create "Sixthsense SNMP Manager Agent" binPath= "\"< path to snmp manager agent>\snmp_manager_agent_directory\ss_snmp_manager_agent_5.11.0/sixthsense-snmp-manager-agent_windows-{arch}\sixthsense-snmp-manager-agent.exe" -config \"< path to snmp manager agent>\snmp_manager_agent_directory\ss_snmp_manager_agent_5.11.0\sixthsense-snmp-manager-agent_windows-{arch}\config.yaml\" start= auto
Confirm whether the service is registered by opening Services and search for the Service Name - "Sixthsense Infra Agent" with which you've registered.
Run the service by opening the Services again and look for Service name - "Sixthsense Infra Agent" > Start OR sc start <service_name>.
Example: sc start "Sixthsense SNMP Manager Agent"
note
- Edit your host file on Windows Host to configure proxy OR you can use below command to configure proxy via administrator command prompt.
netsh winhttp set proxy <proxy>:<port>