The following sub-sections explain how to install each of Teradata Data Warehouse Protector components, Log Forwarder, and the RPAgent individually. Installing components one by one ensures proper configuration and functionality.
This is the multi-page printable view of this section. Click here to print.
Preparing the Environment
- 1: Extracting the Installation Package
- 2: Installing the Log Forwarder
- 3: Installing the Resilient Package Agent
1 - Extracting the Installation Package
Extract the installation package to access the scripts required to install the components and the protector.
To extract the files from the installation package:
Login to the database server as the user with the required permissions.
Navigate to the directory where the installation package is downloaded.
For example,/opt/protegrity/.To extract the contents of the installation package, run the following command:
tar -xvf DatabaseProtector_SLES-ALL-64_x86-64_Teradata-ALL-64_<DBP_version>.tgzPress ENTER.
The commands extracts the signature files from the package.DatabaseProtector_SLES-ALL-64_x86-64_Teradata-ALL-64_<DBP_version>.tgz signatures/DatabaseProtector_SLES-ALL-64_x86-64_Teradata-ALL-64_<DBP_version>.sigNote: For more information about the steps to verify the signed Teradata Data Warehouse protector build, refer to Verification of Signed Protector Build.
To extract the contents of the installation package, run the following command:
tar -xvf DatabaseProtector_SLES-ALL-64_x86-64_Teradata-ALL-64_<DBP_version>.tgzPress ENTER.
The commands extracts the following files:LogforwarderSetup_Linux_x64_<DBP_version>.sh RPAgentSetup_Linux_x64_<DBP_version>.sh PepTeradataSetup_Linux_x64_<DBP_version>.sh PepTeradata_UDTSetup_Linux_x64_<DBP_version>.sh U.S.Patent.No.6,321,201.Legend.txt
2 - Installing the Log Forwarder
Log in to the server as the user with the required permissions.
Navigate to the directory where the installation files are extracted.
For example,
/opt/protegrity/.To install the Log Forwarder, run the following command:
./LogforwarderSetup_Linux_x64_<DBP_version>.shPress ENTER. The prompt to enter the audit store endpoint appears.
Enter the audit store endpoint (host), alternative (host:port) to use another port than the default port 9200 :Enter the IP address of the audit store.
Press ENTER. The prompt to enter additional endpoint appears.
Audit store endpoints: <Audit_store_IP_address>:9200 Do you want to add another audit store endpoint? [y/n]:To skip adding additional endpoints, type
no.Press ENTER. The prompt to continue the installation appears.
These audit store endpoints will be added: <Audit_store_IP_address>:9200 Type 'y' to accept or 'n' to abort installation:To continue the installation, type
yes.Press ENTER. The script extracts the files and installs the Log Forwarder.
Unpacking... Extracting files... Protegrity Log Forwarder installed in /opt/protegrity/logforwarder.Navigate to the
/opt/protegrity/logforwarder/bin/directory.To start the Log Forwarder, run the following command:
./logforwarderctrl startPress ENTER.
The command starts the Log Forwarder.[ info] switching to background mode (PID=8329) Logforwarder started, PID (<process_ID>) written to PID file /opt/protegrity/logforwarder/ bin/fluent-bit.pid
3 - Installing the Resilient Package Agent
The Resilient Package (RP) Agent downloads the certificates. These certificates are further used to authenticate the login credentials, public or private keys, and certify the code reliability.
To install the RPAgent:
Log in to the server as the user with the required permissions.
Navigate to the directory where the installation files are extracted. For example,
/opt/protegrity/.To install the RP Agent, run the following command:
./RPAgentSetup_Linux_x64_<DBP_version>.shPress ENTER.
The prompt to enter the host name or the IP address of the ESA appears.Please Enter ESA host name or IP address []:Enter the IP address of the ESA.
Note: Failure to specify an IP address will abort the installation process.
Press ENTER.
The prompt to enter the username for downloading the certificate appears.Please enter the user name for downloading certificates[]:Enter the username to download the certificates.
Press ENTER.
The prompt to enter the password for downloading the certificate appears.Please enter the password for downloading certificates []:Enter the password to download the certificates.
Press ENTER.
The installer extracts the files and downloads the certificates.Unpacking... Extracting files... Obtaining token from x.x.x.x:25400... Downloading certificates from x.x.x.x:25400... % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 8704 100 8704 0 0 209k 0 --:--:-- --:--:-- --:--:-- 212k Extracting certificates... Certificates successfully downloaded and stored in /opt/protegrity/rpagent/data Protegrity RPAgent installed in /opt/protegrity/rpagent.Note: If the JWT token is not specified while downloading the certificates, the RPAgent automatically retrieves the token from ESA.
Navigate to the
/opt/protegrity/rpagent/bin/directory.To start the RPAgent, run the following command:
./rpagentctrl startPress ENTER.
The command starts the RPAgent successfully and a confirmation message appears.Starting rpagentTo verify the status of the RPAgent, run the following command:
./rpagentctrl statusPress ENTER.
The status of the RPAgent service appears.rpagent is running (pid=<process_ID>)