Installing the AP C Protector

Extracting the Setup Scripts and Package

Note: <arch> can be x86-64 or arm64.

To extract the setup scripts and package:

1. Download the ApplicationProtector_Linux-ALL-64_<arch>_GCC-9.3.1_<version>.tgz file to any location on the machine where you want to install the protector.

2. Extract the AP C installation package using the following command.
   

   tar –xvf ApplicationProtector_Linux-ALL-64_<arch>_GCC-9.3.1_<version>.tgz
   

   The following setup files are extracted:

   • ApplicationProtector_Linux-ALL-64_<arch>_GCC-9.3.1_<version>.tgz
   • signatures/ApplicationProtector_Linux-ALL-64_<arch>_GCC-9.3.1_<version>.sig

3. Verify the digital signature of the signed AP C build.
   For more information about verifying the signed AP C build, refer to Verification of Signed Protector Build.

4. Extract the AP C installation package again using the following command.
   

   tar –xvf ApplicationProtector_Linux-ALL-64_<arch>_GCC-9.3.1_<version>.tgz
   

   The following setup files are extracted:

   Note: Here, <arch> can be x64 or arm64.

   • LogforwarderSetup_Linux_<arch>_<version>.sh
   • RPAgentSetup_Linux_<arch>_<version>.sh
   • XCDevSetup_Linux_<arch>_<version>.sh
   • XCSamplesSetup_Linux_<arch>_<version>.sh

Installing Log Forwarder on Linux

The steps to install the Log Forwarder on a Linux platform using the Interactive mode or through the Silent mode are described in this section.

Note: To preserve all the configurations while upgrading the Log Forwarder, ensure that you backup all the files present under the /opt/protegrity/logforwarder/data/config.d directory.

For more information about installing Log Forwarder on Linux, refer to Installing Log Forwarder on Linux.

Using Interactive Mode

For more information about installing the Log Forwarder using Interactive Mode, refer to Installing Log Forwarder on Linux using Interactive Mode.

Using Silent Mode

For more information about installing Log Forwarder using the silent mode, refer to Installing Log Forwarder on Linux using Silent Mode.

Installing RP Agent on Linux

The steps to install the RP Agent on a Linux platform using the Interactive mode or through the Silent mode of installation are described in this section.

RPA Secure Mode with ESA on Linux

Before proceeding with the RPA installation in secure mode, ensure that the required CA certificate is available and trusted on the system.

• For PPC

  Retrieve the custom CA certificate using the following command:

  kubectl -n cert-manager get secret eclipse-ca -o jsonpath='{.data.tls\.crt}' | base64 -d > ca.crt
  

• For ESA

  Download the certificate from ESA.

  For more information about downloading certificates from ESA, refer to Manage Certificates.

After obtaining the certificate, configure the environment variable:

When prompted for the ESA hostname or IP during RPA installation, ensure it is included in the ESA TLS certificate (CN or SAN) and is resolvable from the RPAgent host.

After the CA certificate is available, proceed with the RPA installation.

For more information about installing RP Agent, refer to Installing RP Agent on Linux or Unix.

Using Interactive Mode

For more information about installing RP Agent on Linux using Interactive Mode, refer to Installing RP Agent on Linux or Unix using Interactive Mode.

Using Silent Mode

For more information about installing RP Agent using Silent Mode, refer to Installing RP Agent on Linux or Unix using Silent Mode.

Installing Application Protector C on Linux

The steps to install the AP C on a Linux platform using the Linux installer or through the Silent mode of installation, are described in this section.

Using Linux Installer

To install the AP C on the Linux platform using the Linux installer:

Note: Here, <arch> can be x64 or arm64.

1. Run the AP C installer using the following command.

   ./XCDevSetup_Linux_<arch>_<version>.sh
   

   The prompt to continue the installation appears.

   *****************************************************
   Welcome to the C SDK Setup Wizard
   *****************************************************
   
   This will install the XCDev on your computer.
   Do you want to continue? [yes or no]
   

2. If you want to continue with the installation of the XCDev, then type yes else type no.

   If you type yes, then the prompt to enter the installation directory appears.

   Enter installation directory.
   A new directory will be created in the installation directory.
   [/opt/protegrity]:
   

   If you type no, then the installation of the XCDev aborts.

   Note:
   The xcpep.plm file is installed in the /opt/protegrity/sdk/c/bin directory.

   The xcpep.plm file is a shared library that is required for compiling the applications which use AP C APIs. Link your application to the xcpep.plm file.

   The default installation directory for the XCDev on a Linux platform is /opt/protegrity/sdk/c.

3. Run the AP C sample installer using the following command.

   ./XCSamplesSetup_Linux_<arch>_<version>.sh
   

   The prompt to continue the installation appears.

   *****************************************************
   Welcome to the C SDK Samples Setup Wizard
   *****************************************************
   
   This will install XCSamples on your computer.
   Do you want to continue? [yes or no]
   

4. If you want to continue with the installation of the XCSamples, then type yes else type no.

   If you type yes, then the prompt to enter the installation directory appears.

   Enter installation directory.
   A new directory will be created in the installation directory.
   [/opt/protegrity]:
   

   The XCSamples are installed in /opt/protegrity/sdk/c by default.

   If you type no, then the installation of the XCSamples aborts.

   The following samples are installed in the /opt/protegrity/sdk/c/samples/ directory:

   • xcapcsample/
   • xccsharpsample/

   • Sample codes support Token DEs only.
   • To use FPE and Unicode Gen2 DEs, user needs to make use of ui4CharSet field in XC_PARAM_EX. For more information about ui4CharSet field, refer to values supported for ui4CharSet field.

   For more information about the samples, refer to the readme.txt file located in the respective sample directories.

   Note:

   • For C# (.NET) development, Protegrity recommends using the Application Protector for .NET.

   The AP C is successfully installed.

Using Silent Mode

You can also execute the AP C installer without any manual intervention, which is also known as the Silent mode of installation. The following parameter must be provided to execute the installer in the Silent mode.

Note: Here, <arch> can be x64 or arm64.

1. Run the AP C installer using the following command.

./XCDevSetup_Linux_<arch>_<version>.sh [-dir <directory>]

The following output appears.

XCDev installed in `/opt/protegrity/sdk/c`.

2. Run the AP C sample installer using the following command.

./XCSamplesSetup_Linux_<arch>_<version>.sh [-dir <directory>]

The following output appears.

XCSamples installed in `/opt/protegrity/sdk/c`.