Troubleshooting

If you’re just getting a blank white page on both the Policy Management Portal and the Policy Management Swagger page and have a console log of an error stating Uncaught SyntaxError: Unexpected token as shown in the images below, your browser might be too old.

You need to update it to load the page's javascript.

Using MSSQL, run the following query replacing the username and password:

USE master;
CREATE LOGIN <username> WITH PASSWORD = '<password>';
ALTER SERVER ROLE sysadmin ADD MEMBER <username>;

If you create a new site and pretend to use the same port as localhost, you need to update the host file to allow communication to your hostname using the same port used by localhost.

Or, if you want to access Policy Management, deployed with a hostname, from a machine that isn’t where it was deployed, you need to map the hostname to the host’s IP address.

The deployment setup script executes a set of queries in the SAST database and uses the SqlCmd util to execute them. It means that to be able to execute this command, you need to have SQL Server Management tools or sqlcmd Utility installed in your machine.

If you are trying to access Policy Management or execute a plugin from a different computer where Policy Management was deployed, and you are having an error, please check if you set the host file in your computer correctly to allow your computer to resolve the hostname.

The PowerShell Team mentions some limitations on how the ISE interacts with console applications, which you must be aware of for apps like FTP and Netsh. First of all, the ISE Runs console apps that don’t require user input just fine.” for this reason, you need to use, specifically, the PowerShell console.

You can find the version installed for both products inside the root of each folder (backend and frontend) in the README.md file.

Following the example in the Windows Deployment page, that would be in:

C:\Program Files\Checkmarx\CxPolicyManagement\Portal\README.md

C:\Program Files\Checkmarx\CxPolicyManagement\Backend\README.md

You can find the version installed for both products by viewing the content of the README.md file inside the "/app" directory of each container (frontend and backend).

To quickly check the version, you can run the following bash command (replacing the container name or ID):

docker exec -it <container_name_or_id> cat /app/README.md

If you are creating a new site and need to use the same port as localhost, you need to update the host file to allow communication to your hostname using the same port.