Privilege Cloud - How to run the ConnectorCheckPrerequisites script

cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 
Announcements

Welcome Idira to LIVEcommunity!

Our community just got stronger! Explore new identity security resources, connect with experts, and discover more ways to learn and collaborate.

Meet Idira

PAM SaaS Articles
4 min read
L0 Member
No ratings

*** This script is for Shared Service tenants ONLY *** 

 

This article will help outline and guide customers when running the Connector Management Prerequisites script, provided by Idira as part of the Privilege Cloud Tools in the Marketplace, linked here: https://community.cyberark.com/marketplace/s/#a352J000000GWAZQA4-a392J000002tNgLQAU

The Connector Management Prerequisite performs several readiness checks and tasks to ensure minimum requirements are met and to prepare a system for Privilege Cloud Connector deployment using Connector Management. 

Steps

Prerequisites

 

Script Zip File Contents 

The following files related to the script can be found in the Privilege Cloud Tools package: 

  • Connector Management Prerequisites\CMReadme.txt – Script readme file 

  • Connector Management Prerequisites\ConnectorCheckPrerequisites_PrivilegeCloud.ps1 – The Connector Management prerequisite script 

  • VaultOperationsTester – used for CPM connection test (do not modify folder structure) 

 

Instructions 

The script has several execution modes specified by the switches included when the script is run. Please choose and execute one of the following commands in an Admin instance of PowerShell.  

During execution, it will also generate a file called "ConnectorCheckPrerequisites_PrivilegeCloud.ini" that will store the parameters provided during runtime. If you made a mistake and want to rerun the script, we recommend you edit this file with the proper details or delete it. 

The default run of the script will perform the readiness checks, the CPM connection test, and install RDS. 

 

.\ConnectorCheckPrerequisistes_PrivilegeCloud.ps1 

ka3Vy00000AteBxIAJ__eid=ka3Vy00000AteBx&feoid=00N2J000009R3kv&refid=0EMHt0000061NUQ.png 

At the end of the base script, an additional prompt to install the RDS roles/services will appear. If testing prior to implementation, you can choose “No” and skip this step. 

ka3Vy00000AteBxIAJ__eid=ka3Vy00000AteBx&feoid=00N2J000009R3kv&refid=0EMHt0000061NUR.png 

 

Additional Switches

  • Run checks if the machine is out of the domain 

.\ ConnectorCheckPrerequisistes_PrivilegeCloud.ps1 -OutOfDomain 

 

  • Run in POC mode 

.\ ConnectorCheckPrerequisistes_PrivilegeCloud.ps1 -POC 

 

  • Access the Troubleshooting menu 

.\ ConnectorCheckPrerequisistes_PrivilegeCloud.ps1 -Troubleshooting 

 ka3Vy00000AteBxIAJ__eid=ka3Vy00000AteBx&feoid=00N2J000009R3kv&refid=0EMHt0000061NfV.png 

  

.\ ConnectorCheckPrerequisistes_PrivilegeCloud.ps1 -CPMConnectionTest 

ka3Vy00000AteBxIAJ__eid=ka3Vy00000AteBx&feoid=00N2J000009R3kv&refid=0EMHt0000061NfW.png 

ka3Vy00000AteBxIAJ__eid=ka3Vy00000AteBx&feoid=00N2J000009R3kv&refid=0EMHt0000061NfX.png 

  • Install RDS only: 

.\ ConnectorCheckPrerequisistes_PrivilegeCloud.ps1 -InstallRDS 

 

Files generated during the execution: 

  • <ScriptDir>\<Computer Name> PublicIP.txt - will try to query machine public IP by reaching https://ipinfo.io 

  • <ScriptDir>\_ ConnectorCheckPrerequisites_PrivilegeCloud.log - General log for the script itself. 

  • <ScriptDir>\_ ConnectorCheckPrerequisites_PrivilegeCloud.ini - stores information entered in script prompts for added convenience on subsequent runs 

  • VaultOperationsTester\Log\*.logs 


 

Troubleshooting 

  • Tenant Password Contains Invalid Characters 
  • This can happen if your password contains the characters \/<>{}'&"$*@`  and fails the logon test.  

To update the password please see https://community.cyberark.com/s/article/Privilege-Cloud-How-to-locate-and-update-the-InstallerUser-... 


 

Vault/Connector Connection Failure 

ka3Vy00000AteBxIAJ__eid=ka3Vy00000AteBx&feoid=00N2J000009R3kv&refid=0EMHt0000061NgF.png 
This issue is likely a whitelist issue on either the external firewall or the Idira AWS firewall. Work with your firewall team to confirm the required IPs and Ports are allowed through the firewall. Also, provide your <Server> PublicIP.txt file to your Idira Rep to verify the Idira hosted AWS side. 
If you have a PaloAlto Firewall, please read on in this article for some troubleshooting steps: https://community.cyberark.com/s/article/Vault-Connectivity-fails-when-components-separated-by-Palo-... 

 

GPO Failures 

The script checks for GPOs that will be problematic for deployment and use of PSM. For any GPO-Local failures, RDS will fail to install until the policy is removed. For GPO-Domain failures, PSM connections will be impacted until the policy is removed. The failure message will indicate the GPO that is the source of the problematic policy. Please update the GPO that is being pushed to the machine to turn off any cited issue GPOs from the script. In this above example the team would adjust the "Allow users to connect remotely by using Remote Desktop" policy, to "Not Configured". As part of the prerequisites, Idira asks that we disable all enterprise/corporate GPOs applied to the Connector servers. 
 

RDS role installation failure

If the RDS role or features fail to install, a common cause is the Windows operating system has been modified from its original form (e.g. through hardening, policy, or software installation) or system file corruption. Examples would be non en-US ISO images, language packs, etc. 

You can run the script with the -Troubleshooting flag to perform various helpful commands: 
ka3Vy00000AteBxIAJ__eid=ka3Vy00000AteBx&feoid=00N2J000009R3kv&refid=0EMHt0000061NgU.png 

  • Disable IPv6 - Disables the IPv6 protocol both in the network card and registry, restart is required to apply changes. 
  • Enable SecondaryLogon Service - Enables services and makes sure it's set to StartType Automatic, this is required for PSM functionality, it is also enabled during installation, but can fail if service is disabled, that's why we have this step in prereq. 
  • Run CPM Install Connection Test - Simulates a real CPM install without leaving any leftovers in the vault, requires good connectivity to vault and installeruser credential. 
  • Retry install RDS – equivalent to running script with –InstallRDS switch. Attempts installation of the RDS role and features. 
Rate this article:
  • 13760 Views
  • 0 comments
  • 0 Likes
Article Dashboard
Version history
Last Updated:
‎11-05-2026 11:46 AM
Updated by: