Troubleshooting

Find information to help you troubleshoot issues while running the simulator integration.

The connector receives 401 errors from CDF

HTTP error 401 means that the service didn't recognize the authentication provided by the client. If the Cognite API returns 401 errors to the connector, it means the connector successfully received an authentication token, but the token isn't valid for the project.

This usually occurs because the project or host parameters in the cognite section are incorrect.

The connector is not setting the data set when using remote configuration

If you set up the connector to run with remote configuration, only the host, project, idp-authentication, and extraction-pipeline parameters in the cognite section are read from the file on the local machine. Other parameters in the cognite section, such as data-set, must be added to the configuration file in the extraction pipelines.

Failures in model extraction

Model extraction can fail when unsupported characters are used. Only plain English characters with the American Standard Code for Information Interchange (ASCII) character encoding are supported in filenames and paths for .gar and .zip files. Special symbols, accents, or non-Latin scripts aren't recognized.

The following example log entry shows a model extraction failure caused by an invalid file path.

[GapConnector.GapSimulator] Failed to extract model information from .gar file C:\Gap tests\connector\files\312\312.gar: GAP.OPENFILE("C:\Gap\connector\files\312\extracted\User\AccountA\My Documents\Desktop\IPM\fields\Field_�x�pr_G.gap") failed: Failed to open file 'C:\Gap\connector\files\312\extracted\User\AccountA\My Documents\Desktop\IPM\fields\Field_?x?pr_G.gap'

Diagnose license-related issues

The connector will fail to run properly if you don't have a PETEX OpenServer license. The following PowerShell commands can be used to verify if PETEX OpenServer and GAP licenses are available in the environment where the connector is running.

# Create a new OpenServer COM object
$server = New-Object -ComObject "PX32.OpenServer.1"

# Test if a GAP license is available
$server.DoCommand("GAP.START()")

# Close GAP
$server.DoCommand("GAP.SHUTDOWN")

# Release the COM object
[System.Runtime.Interopservices.Marshal]::ReleaseComObject($server) | Out-Null
[System.GC]::Collect()
[System.GC]::WaitForPendingFinalizers()

File-read issues in model extractions

The error "File Read Failed (3160)" typically occurs when a model file can't be opened within the installed version of IPM.

This error is typically due to a version mismatch. If the model file was saved with a newer version of the tool, for instance IPM 13.5, and opened using OpenServer in an older version, for instance IPM 13.0, the version mismatch prevents the file from being read. Projects in IPM Suite aren't backward-compatible due to structure amendments and new features.