Installing the AP .Net Protector
Extracting the AP .Net Setup Scripts and Package
To extract the setup scripts and package:
- Download the
ApplicationProtector_WIN-ALL-64_x86-64_NET-STD-2.0-64_<version>.zipfile to any location on the machine where you want to install the protector. - Extract the contents of the
ApplicationProtector_WIN-ALL-64_x86-64_NET-STD-2.0-64_<version>.zipfile.
The following setup files are extracted:ApplicationProtector_WIN-ALL-64_x86-64_NET-STD-2.0-64_<version>.zipsignatures/ApplicationProtector_WIN-ALL-64_x86-64_NET-STD-2.0-64_<version>.zip_10.0.sig
- Verify the digital signature of the signed AP .Net build.
For more information about verifying the signed AP .Net build, refer to Verification of Signed Protector Build. - Extract the contents of the AP .Net installation package again.
The following setup files are extracted:LogforwarderSetup_Windows_x64_<version>.exeRPAgentSetup_Windows_x64_<version>.exeAPDotNetSetup_Windows_x64_<version>.exeAPDotNetMockSetup_Windows_x64_<version>.exe
Before you begin
To preserve all configurations during upgrade:
- For Log Forwarder, backup all files present under
C:\Program Files\Protegrity\logforwarder\data\config.ddirectory. - For RP Agent, backup all files present under
C:\Program Files\Protegrity\rpagent\datadirectory.
Installing Log Forwarder on Windows
This section describes how to install the Log Forwarder on a Windows platform using either the Windows Wizard or Silent mode.
Using Windows Wizard
For more information about installing the Log Forwarder using the Windows wizard, refer to Installing Log Forwarder on Windows.
Using Silent Mode
For more information about installing Log Forwarder using the silent mode, refer to Installing Log Forwarder on Windows using Silent Mode.
Installing RP Agent on Windows
This section describes how to install the RP Agent on a Windows platform using either the Windows Wizard or Silent Mode.
Using Windows Wizard
For more information about installing RP Agent using the Windows wizard, refer to Installing RP Agent on Windows.
Using Silent Mode
For more information about installing RP Agent using the silent mode, refer to Installing RP Agent on Windows using Silent Mode.
RPA Secure Mode with ESA / PPC on Windows
Before proceeding with the RPA installation in secure mode, ensure that the required CA certificate is available and trusted on the system.
For PPC (Windows)
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.crtFor ESA
Download the certificate from ESA.
For more information about downloading certificates from ESA, refer to Manage Certificates.
After obtaining the certificate, configure the system environment variable:
| Variable | Value |
|---|---|
| SSL_CERT_FILE | Full path to the certificate file (for example, C:\Users\Administrator\ca.crt) |
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.
Using Windows Wizard
For more information about installing RP Agent using the Windows wizard, refer to Installing RP Agent on Windows.
Using Silent Mode
For more information about installing RP Agent using the silent mode, refer to Installing RP Agent on Windows using Silent Mode.
Installing Application Protector .Net on Windows
Using Windows Wizard
This section describes how to install AP .NET on a Windows platform.
Note: Before installation, ensure that the
C:\Users\Administrator\.nuget\packagesdirectory does not contain the dotnetprotector folder.
To install the AP .Net on the Windows platform:
Run the
APDotNetSetup_Windows_x64_<version>.exeinstaller from the created directory.
The Select Destination Location screen appears.Set the installation directory to
C:\Program Files\Protegrity\sdk\dotnet.Click Next.
The Ready to Install screen appears.Click Install.
The Completing the Defiance AP DOTNET API Setup Wizard screen appears.Click Finish to complete the installation.
The AP .NET is now installed successfully.
The default installation directories for different platforms are given in the following table.
Table: AP .Net Default Installation Directories
Platform Directory Windows 64-bit C:\Program Files\Protegrity\sdk\dotnet\libAPI Docs C:\Program Files\Protegrity\sdk\dotnet\docVerify that the following files exist in the dotnet\lib directory:
DotNetProtector.<version>.nupkg- NuGet package for AP .NETdotnetprovider.plm- Dynamically loadable module for Windows
Installing the NuGet Package
In Solution Explorer, right-click on Dependencies and select Manage NuGet Packages.
The NuGet Package Manager screen appears.Click the Settings icon next to the Package source list.
The Options dialog box appears.Click the ellipsis icon next to the Source field.
Browse to select the
libdirectory that contains theDotNetProtector.<version>.nupkgpackage.
For example, select theC:\Program Files\Protegrity\sdk\dotnet\libdirectory.Specify a name for the package source in the Name field.
Click Update.
Thelibdirectory path appears in the Package sources list.Click OK to close the Options dialog box.
In the NuGet Package Manager screen, in the Package source list, select the newly created package source.
Click Browse.
The DotNetProtector package appears in the list of packages.Select DotNetProtector and click Install.
The DotNetProtector package is installed.The AP .NET is installed successfully.
Using Silent Mode
This section describes how to perform a silent installation of AP .Net using command-line parameters.
Silent installation allows you to install AP .Net without user interaction, making it suitable for automated deployments and scripting.
To view usage of the AP .Net installation, use the -help parameter during silent installation.
APDotNetSetup_Windows_x64_10.0.0+0.g8606.exe -help
To specify the directory for the AP .Net installation, use the -dir parameter during silent installation.
APDotNetSetup_Windows_x64_10.0.0+0.g8606.exe -dir C:\Users\Administrator
Note:
-diris a mandatory parameter for silent installation.
Feedback
Was this page helpful?