NetBackup IT Analytics Data Collector Installation Guide for Capacity Manager
- Overview
- Pre-Installation setup for Compute Resources
- Pre-Installation setup for Dell Compellent
- Pre-Installation setup for DELL EMC Elastic Cloud Storage (ECS)
- Pre-Installation setup for Dell EMC Unity
- Pre-Installation setup for EMC data domain storage
- Pre-Installation setup for EMC Isilon
- Pre-Installation setup EMC Symmetrix
- Pre-Installation setup for EMC VNX Celerra
- Pre-Installation setup for EMC VNX
- Pre-Installation setup for EMC VPLEX
- Pre-Installation setup for EMC XtremIO
- Pre-installation setup for FUJITSU ETERNUS Data Collector
- Pre-Installation setup for Hitachi Block
- Pre-Installation setup for Hitachi Block
- Prerequisites for adding Data Collectors (Hitachi Block)
- Installation overview (Hitachi Block Storage)
- Adding a Hitachi Block Storage Data Collector policy
- Configuring a Hitachi Device manager user
- Configuring a Collector for Hitachi NAS block storage
- Adding an HP command view advanced Data Collector policy
- Pre-Installation setup for Hitachi Content Platform (HCP)
- Pre-Installation setup for Hitachi Content Platform (HCP)
- Prerequisites for adding Data Collectors (Hitachi Content Platform)
- Installation overview (Hitachi Content Platform)
- Add a Hitachi Content Platform (HCP) Data Collector policy
- Setting up permissions for an HCP local user or active directory user
- Hitachi content platform system management console
- Hitachi content platform tenant management console
- Pre-Installation Setup for Hitachi NAS
- Pre-Installation Setup for Hitachi Vantara All-Flash and Hybrid Flash Storage
- Host inventory pre-installation setup
- Host Access Privileges, Sudo Commands, Ports, and WMI Proxy Requirements
- Host Inventory pre-installation setup
- Plan host Data Collection
- WMI Proxy requirements for Windows host Data Collection
- Host access requirements
- Verify command paths
- Host Inventory configuration steps
- Host Inventory setup overview
- Host Inventory maintenance overview
- Before discovering hosts
- Configure / Search the host Inventory
- Manage credentials
- Manage WMI proxy
- Manage paths
- Manage access control
- Host Inventory management
- Configure host Discovery policies to populate the host Inventory
- Execute and monitor host Discovery
- Validate host connectivity
- Show errors
- Filter the host Inventory - hide / un-hide, remove
- Host Inventory search and host Inventory export
- Export the host Inventory
- Configure and edit host probes
- Propagate Probe Settings: Copy Probes, Paste Probes
- Pre-Installation setup for HP 3PAR
- Pre-Installation setup for HP EVA
- Pre-Installation setup for HPE Nimble Storage
- Pre-Installation setup for Huawei OceanStor
- Pre-Installation setup for IBM Enterprise
- Pre-Installation setup for IBM COS
- Pre-Installation setup for IBM SVC
- Pre-Installation setup for IBM XIV
- Pre-Installation setup for Infinidat InfiniBox
- Pre-Installation setup for Infinidat InfiniGuard
- Pre-Installation setup for Microsoft Windows server
- Pre-Installation setup for NetApp-7
- Pre-Installation setup for NetApp StorageGRID
- Pre-Installation setup for NetApp Cluster
- Pre-Installation setup for NetApp E-Series
- Pre-Installation setup for Pure Storage FlashArray
- Pre-Installation setup for Veritas NetBackup appliance
- Installing the Data Collector software
- Introduction
- Installing the WMI Proxy service (Windows host resources only)
- Testing WMI connectivity
- Considerations to install Data Collector on non-English systems
- Install Data Collector Software on Windows
- Install Data Collector software on Linux
- Install Data Collector in containerized environment
- Validating Data Collection
- Uninstalling the Data Collector
- Manually starting the Data Collector
- Appendix A. Firewall configuration: Default ports
Install Data Collector in containerized environment
This procedure provides the steps to install Data Collector using a container image, which is a lightweight, standalone executable, on Linux hosts. This method enables efficient Data Collector installation using a single container image and reduces the human errors caused during manual or ISO-based installations. Since this installation using a container image requires minimal user input, this installation is also termed as silent installation.
System requirements and installation dependencies for the system on which Data Collector will be installed are listed below:
Docker or Podman must be pre-installed on the system.
Assume root role on the host system.
Create a directory structure in the host system where data from the container will be persisted. Ensure that the file system supporting the
/datadirectory has enough free space as recommended in the NetBackup IT Analytics Certified Configurations Guide for Data Collector. The/datadirectory in the host system will be mounted inside the container as/opt/aptare.mkdir -p /data/install/conf
Create a configuration file named
conf-file.The format of configuration
conf-filemust be as follows:COLLECTOR_NAME=Name of the Data Collector as defined in the portal. COLLECTOR_PASSWORD=Passcode assigned to the Data Collector during its creation. DR_URL=Data receiver URL example:-<http://aptareagent.domainName> COLLECTOR_KEY_PATH=/data/aptare/conf/<keyname.key> HTTP_PROXY_CONF=N [Y-yes/N-no whether we are using proxy of not] HTTP_PROXY_ADDRESS=Provide HTTP proxy address, if proxy configuration is Yes. HTTP_PROXY_PORT=Provide HTTP proxy port, if proxy configuration is Yes. HTTPS_PROXY_ADDRESS=Provide HTTPS proxy address, if proxy configuration is Yes. HTTPS_PROXY_PORT=Provide HTTPS proxy port, if proxy configuration is Yes. PROXY_USERNAME=Provide Proxy userName PROXY_PASSWORD=Provide Proxy password. PROXY_EXCLUDE=Provide exclude
Example: A sample conf-file content looks like:
COLLECTOR_NAME=testdc COLLECTOR_PASSWORD=testdc@123 DR_URL=http://itanalyticsagent.domain COLLECTOR_KEY_PATH=/data/aptare/conf/testdc.key HTTP_PROXY_CONF=N HTTP_PROXY_ADDRESS= HTTP_PROXY_PORT= HTTPS_PROXY_ADDRESS= HTTPS_PROXY_PORT= PROXY_USERNAME= PROXY_PASSWORD= PROXY_EXCLUDE=
Save the Data Collector key file and configuration
conf-fileon the Data Collector host at/data/install/conf. Both the files must be at the same location on the host. If the location of the files is changed, you must update the Docker run command accordingly with the new location.Obtain the URL of the Docker image registry in your environment.
Once you have the prerequisites in place, you must push the Docker image to your registry and initiate the installation.
To install through a container:
- Add execute permission to setup_vtas_registry.sh script.
#chmod 744 setup_vtas_registry.sh
- Push the Docker image present in the
itanalytics_images.tarto the registry in your environment:# setup_vtas_registry.sh -c <container registry URL> -t <itanalytics_images.tar file path>
Where:
<container registry URL> is the URL of the Docker image registry in your environment.
<itanalytics_images.tar file path> is the path to
itanalytics_images.tarfile.
You can use docker images or podman images command depending on the platform you are on to verify the Docker image availability within your registry.
In systems that use Podman, you may have to update the container registry configuration file
/etc/containers/registries.confto trust the <container registry URL>. For this, update the unqualified-search-registries setting in/etc/containers/registries.confand restart the Podman service.In systems that use Docker, create the file
/etc/docker/daemon.jsonand add the below content to it and restart the Docker service to make the change effective.{ "insecure-registries" : [ "<container registry URL>:<port>" ] } - Run the installation command for the container image.
Note:
Use Podman instead of command docker if you are on the system that supports Podman.
# docker pull <Container registry URL>/ itanalytics_datacollector_linux_<version> # docker run -d -v /sys/fs/cgroup/:/sys/fs/cgroup:ro -v <path-to-location-of-config-and-key>:/data/aptare/conf -v <path-to -data-location>:/opt/aptare --add-host aptareportal.<DOMAIN>:<portal-IP> --add-host aptareagent.<DOMAIN>:<Portal-IP> --cap-add SYS_ADMIN --name=<container-name> <Container registry URL>/itanalytics_datacollector_linux_<version>
Replace everything inside <> with values as indicated in the sample below.
Example:
# docker pull localhost:5000/itanalytics_datacollector_linux_11000 # docker run -d -v /sys/fs/cgroup/:/sys/fs/cgroup:ro -v /data/install/conf:/data/aptare/conf -v /data:/opt/aptare --add-host aptareportal.domain_name:10.1.5.6 --add-host aptareagent.domain_name:10.1.5.6 --cap-add SYS_ADMIN --name=dc-container1 localhost:5000/itanalytics_datacollector_linux_11000
After a successful installation, verify whether the Data Collector status appears Online on the NetBackup IT Analytics Portal. Note that the Data Collector is running inside a Docker Container and remains online as long as he container status is running.
Run this command to connect to the container instance and also to facilitate debugging when required.
# docker exec -it <image id> bash