Error Resolution

Windows cannot open the ZIP file from Export to Zip. The Zip is invalid.

Applies to: CAM PowerDesktop Cloud Migrator

• This is a limitation of the Windows native archiver. When the path exceeds 260 characters, the Extract function built into Windows won’t work to extract it to a temp folder then to the desired location.

• A workaround is to use a third party Zip utility like 7Zip.

• Another workaround is to enable long paths in Windows. See our article: Enabling Support for Long File Paths

Authentication Failed/Underlying Connection was Closed

Applies to: CAM PowerDesktop Cloud Migrator

If the error shows please check your domain or username or password, the underlying connection was closed. Couldn’t establish trust relationship for the SSL/TLS secure channel

• Confirm SSL or TLS is setup on AWS correctly. On June 28, 2023, AWS is dropping all support for TLS 1.0/1.1 and this could affect users using Windows Server 2012 or older with the use of Data Uploader.

  Windows Server 2016 and above are the natively supported versions with 1.2.

• Check the domain and username and password. Some firms may block copying/pasting these items.

• Check the whitelisting of the firewall to ensure the sites are whitelisted. Whitelisting and Redirect Information

•  

• Many firms will forget to whitelist their DNS server or check their redirects. Confirm the redirects can go through to the URLs for CAM or Data Uploader.

Error Connect Reset (ECONN Reset)

Applies to: CAM PowerDesktop Cloud Migrator

Happens when the server doesn’t respond. Or if the response isn’t timely within the timeout period.

• Check for connection/packet loss/insufficient IOPS issues in the network with your IT department.

Database transaction failed

Applies to: CAM PowerDesktop Cloud Migrator

This error usually means something is wrong in the iManage database. There is always a corresponding error in the DMS log. The customer should contact iManage support or open a ticket on the customer’s behalf with iManage to get a detailed error message from the DMS log from iManage Server(s).

Usually, the action causing this is a SQL statement inside the iManage server failed thus throwing this generic error. Here are some usual reasons but the actual error can only be understood after looking at the DMS error

1. Referential Integrity - Trying to insert a value that doesn’t exist in the table

2. Deadlock error - Due to SQL resources load or fragmentation, the table or pae is locked

3. Null Values, foreign characters, or spacing issues in column values were not expected

4. SQL Query timed out - This can happen due to lack of an index, fragmentation of indexes, or bad queries

5. Missing column (unusual but sometimes happens to client and server mismatch)

File Server transaction failed

Applies to: CAM PowerDesktop Cloud Migrator

This error usually means something is wrong with the iManage file server. There is usually a corresponding error in the DMS log. You should ask the customer to contact iManage or open a ticket on the customer’s behalf with iManage to get a detailed error message from the DMS log. If they are on-premises customer, they can check the DMS log. This error is usually coupled with “System.Runtime.InteropServices.COMException: [Page ][UpdateWithResult ]” in the log and may be found in the Windows Event log on-premises on the server running iManage.

The typical causes are

1. The file server in question is not reachable

2. The disk space is full on the fileserver in the temp folder

3. Incorrect path configured

4. A duplicate file exists

5. The virus scanner is blocked from writing to the file server

Failed to assign imProfileAuthor or imProfileOperator value

Applies to: CAM PowerDesktop Cloud Migrator

This error means one of the following:

1. The specified user does not exist in the iManage database

2. The user exists but is disabled

3. There is a spacing issue or special characters in the name of the user, length of the userid column exceeds the size (more than 32 characters) (usually can be spotted by using select len(username) from mhgroup.docuser table

The specified user is incorrect. Sometimes user’s userId and fullname are combined or the fullname column is swapped with the userId column. Check the input data to make sure you are only specifying a valid userId.

An unrecognized exception has occurred/ NRTSession Login Incorrect Function

Applies to: CAM PowerDesktop Cloud Migrator

The error could happen for a variety of reasons. Here are some common scenarios:

1. When there is a network issue or an unreliable network. Many times this error goes away by restarting the machine

2. The version of iManage.dll is old

3. If iManage is on the cloud, some changes in iManage cloud (network, settings, etc) may have caused it

If the error doesn’t resolve with the latest version of the iManage.dll, restarting the machine, checking for a stable network, etc, then open a ticket with iManage.

Document is Read only/ File Transfer failed

Applies to: CAM PowerDesktop Cloud Migrator

This error can occur for multiple reasons:

1. The document in question does not exist in iManage or the DMS. The document record is the database but the actual document is missing from the DMS. Typically happens for older documents where the record might have moved, renamed, or deleted.

2. The user doesn’t have “view document” role permission in iManage, the V role for ND, or View in O365.

The remote computer cannot be located

Applies to: CAM PowerDesktop Cloud Migrator

This error may contain Logging in as “username”.

Occurs when

1. The iManage server you are trying to connect to is not accessible from the Milan or CAM or Cloud Migrator or Power Desktop Machine.

2. The Server name is incorrect.

3. The iManage cluster is not configured properly causing the connection to fail e.g. when the iManage cluster is configured all nodes must have the same configurations with regards to databases, odbc connection string, and cluster settings.

4. Intermittent Network issues cause the connection to drop.

 COM Exception

Applies to: Cloud Migrator

System.Runtime.InteropServices.COMException (0x80040154): Retrieving the COM class factory for component with CLSID

1. The iManage.dll is not registered

2. The wrong version (64 bit vs 32 bit) of iManage.dll is registered

3. The iManage.dll is missing

4. The current user does not have access to the registry key

This applies to any COM dlls. We use iManage.dll and iManAdmin.dll in Milan, Zone, and Desktop Import Export products and can be utilized if Cloud Migrator is migrating from an on prem iManage server in Cloud Migrator.

Group Member No Record Found

Applies to: CAM PowerDesktop Cloud Migrator

1. Special Characters in GroupIds like a Blackslash or spaces for instance do not allow members to be added via the iManage API

2. The resolution is to remove the special character from the GroupIDs of those Groups and have the groups recreated

NRC_EMAIL_IN_USE

Applies to: CAM PowerDesktop Cloud Migrator

The email of the folder that errored is already used by another folder that exists in the DMS. Make the email unique by adding prj_id to the address for the impacted folder. It's always a good practice to use PRJ_ID(Folder ID) as an email address. This guarantees uniqueness as all folders have a unique PRJ_ID in iManage (the primary key of the folder also known as folder ID)

NRC_INVALID_PROFILE

Applies to: CAM PowerDesktop Cloud Migrator

1. One or more of the Profile Metadata is missing in the DMS preventing the creation of the workspace in the cloud. 

2. The metadata may exist but may have spaces or special characters hence doesn’t match the given metadata in the operation in question

3. Make sure the metadata (if a lookup) exists and has no special characters. If non-lookup, make sure the length and type of the data are correct e.g. boolean, date, integer, etc

NRC_DB_INVALID / NRC_DB_UNAVAILABLE

Applies to: CAM PowerDesktop Cloud Migrator

This error means

1. The logged-in user does not exist in the specified database

2. The logged-in user exists but is disabled

3. Logged-in users don’t have access to the database

4. Database connection failed (temporary network error, SQL connectivity error, that typically goes away after you retry)

5. The database name is incorrect

NRTSession Login/ NRC_ACCESS_DENIED

Applies to: CAM PowerDesktop Cloud Migrator

A 403 may not be displayed if the source system is iManage. Steps to resolve:

1. The password is incorrect

2. The password is correct but the user is disabled(locked)in one or more databases(libraries)

3. The password is correct but the password is different in one or more databases

4. The document is locked.

5. The logged in user doesn’t have permissions to search or update the document or workspace.

In the case of Milan, the NRTADMIN password set in Milan is different than what is set in iManage.

NRC_NO_RECORD

Applies to: CAM PowerDesktop Cloud Migrator

This error could happen for a variety of reasons. We have observed in following scenarios

1. The specified entity doesn’t exist on the database

2. Alias (if lookup fields) have space in the name or value

3. The length of the column exceeds what is supported by iManage

4. The logged-in users don’t have permission to search or update.

NRC_INDEXER_FAILED

Applies to: CAM PowerDesktop Cloud Migrator

This error could happen for a variety of reasons. We have observed in the following scenarios

1. Indexer is not running in iManage

2. The indexer in iManage has connection issues. Please have the customer or partner check their iManage DMS log or Indexer log for more information.

NRC_FT_XACTION_FAILURE/ NRC_FS_UNAVAILABLE

Applies to: CAM PowerDesktop Cloud Migrator

This error could happen for a variety of reasons. We have observed in the following scenarios

1. The document in question actually does not exist. The document record is the database but the actual document is missing from the iManage File Share. Typically happens for older documents where file-share might have moved, renamed, or deleted.

2. The user doesn’t have the“view document” role permission in iManage.

NRC_DUP_RECORD

Applies to: CAM PowerDesktop Cloud Migrator

The given record already exists in the database. Typically this error occurs for security records when setting on any objects (workspace, folder, document) or for name-value pairs on folders (folder metadata).

NRC_SECURITY_ASSIGNMENT_FAILURE

Applies to: CAM PowerDesktop Cloud Migrator

Happens for example when assigning trustees or an owner to a document. We have observed this error in the following scenarios:

1. A specified user or group does not exist on the database.

2. The given user or group has typos, spacing, or special characters.

3. Logged-in users don’t have permission to update

4. The given user is disabled.

NRC_OPERATION_NOT_ALLOWED

Applies to: CAM PowerDesktop Cloud Migrator

A log may show the operation is not currently available. This error can happen when a logged-in user doesn’t have permission to search or update. Check the current user’s assigned role and then check all permissions assigned to this role.

NRC_DOC_IN_USE

Applies to: CAM PowerDesktop Cloud Migrator

We have observed in following scenarios

1. The document is opened in iManage classic clients

2. The document is locked, archived, or checked out

NRC_INVALID_PARAM

Applies to: CAM PowerDesktop Cloud Migrator

1. The specified entity does not exist on the database (Typically for lookup or validated metadata)

2. The specified user does not exist in the database

3. The user exists but is disabled

4. There is a spacing or special characters in the name of the user (usually can be spotted by using select len(username) from mhgroup.docuser table or metadata values

5. The user-specified is incorrect. In this case, the user’s userId and fullname are combined for some reason. Check your data to make sure you are only specifying the userId.

NRC_PROFILE_NOT_LOCKED

Applies to: CAM PowerDesktop Cloud Migrator

The document is not locked. This happens when you try to unlock a document in CAM or another application.

NRC_DOC_CHECKEDOUT

Applies to: CAM PowerDesktop Cloud Migrator

The document is checked out. The document needs to be checked-in or unlocked using CAM or the DMS.

NRC_HISTORY_FAILURE

Applies to: CAM PowerDesktop Cloud Migrator

1. The activity code is invalid. Please check the list of supported activity codes by iManage (See below the list of supported activity codes)

2. One of the values (typically validated values) is invalid or exceeds the supported length

NRC_NO_PRIVILEGE

Applies to: CAM PowerDesktop Cloud Migrator

This error occurs when the logged-in user doesn’t have permission to search or update. Please check the user’s permission on a given object (read-only) or check the user’s role permissions in iManage e.g. the permission can’t update or create public documents/folders.

The sync fails due to the Transform Empty folder scripts

The IsIgnore flag on these scripts was not working in versions prior to #510. In #510, these scripts are removed as they are deprecated.