Agent installation check list

OPA Agent Checklist

Before installing the OPA Agent, ensure that the host computer meets all prerequisites. You can verify system readiness by using the Cloudsfer OPA Agent Test Script.

1. Download and Prepare the Script

   • Download the ZIP file.
   • Ensure the file is not blocked after downloading.
   • Unzip the file and read the attached ReadMe.txt.
   • The script will scan your system and report any missing prerequisites.

   Note: The script does not make any changes to your system.

2. Verify .NET Framework 4.8
   Run the following PowerShell command in Administrator mode:
   

   (Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full").Version -match "^4.8"

   If the result is False, download and install .NET 4.8 from:  Download .NET 4.8

3. Service User Requirements

   • Ensure the service user is explicitly added to the Local Administrators group (not via another group).
   • Verify the user has "Log on as a service" rights:
     • Open Local Security Policy.
     • Navigate to Local Policies > User Rights Assignment.
     • Select "Log on as a service" and add the user.
     • Ensure domain policies do not override local settings.
       

4. Service Timeout Fix (if installation fails to start)

   • Open the Registry Editor.
   • Navigate to:
     Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control
   • Check for the entry "ServicesPipeTimeout".
     • If missing, add a DWORD named ServicesPipeTimeout with a decimal value of at least 90000.
   • Restart the system and try installing the service again.
     

5. Token Verification

   • Ensure the user clicked Add and the agent appears in the agent list.
   • Use a unique token for each server. Do not reuse tokens.

6. Mapped Drives Not Showing?

   • Ensure the service user is a network user.
   • Verify the user has permissions to view mapped drives.
   • Navigate to: C:\ProgramData\Tzunami\Cloudsfer
     • Open drivers.txt and check if mapped drives are listed.
     • If not, verify directory permissions and ensure the user can access and update it.
   • If the file tree does not show subdirectories:
     • Confirm the user has read (and write, if the agent is the target) permissions.

7. Check Agent Ports

   • Ensure the server allows outbound communication on the port range 32,000–34,000.

8. Test Connection to Cloudsfer
   Click the links below to verify connectivity:

   • https://opatest.cloudsfer.com:32000/
   • https://opatest.cloudsfer.com:33000/
   • https://opatest.cloudsfer.com:34045/

   If the test screen appears, your connection is successful.