Sections
Audience
HTTP Status & Errors
Source Status
Migration Status
Project
Advanced Mode Errors
Miscellaneous Errors
State Validation Errors
Database Errors
Authentication Errors
Websocket Errors
Agent Upgrade
Agent
User Activity
Audience
Any user of the Migration App. For any questions or errors regarding migration app reach out to Egnyte Support
HTTP Status and Errors
| Status Code | Status code string representation | Description |
| 200 | OK | Success response |
| 302 | Found redirect | Redirect Status Code |
| 303 | See Other redirect | Redirect Status Code |
| 401 | Unauthorized | Authorization Error |
| 404 | Page Not Found | Resource not found |
| 500 | Service | Interval service error |
Source Status
| Status Code | Status code string representation | Description |
| 900 | AGENT_STATE_INACTIVE | Agent is in "inactive" state |
| 901 | AGENT_STATE_ACTIVE | Agent is in "active" state |
| 902 | AGENT_STATE_DEACTIVATED | Agent is in "deactivated" state |
| 903 | AGENT_STATE_DELETED | Transient state when Agent is deleted |
Migration Status
| Status Code | Status code string representation | Description |
| 910 | CREATE_MIGRATION: RUNNING | Migration creation is in process |
| 911 | CREATE_MIGRATION: SUCCEEDED | Migration creation succeeded |
| 912 | CREATE_MIGRATION: FAILED | Migration creation failed |
| 913 | CREATE_MIGRATION: STOPPED | Migration creation stopped |
| 914 | CREATE_MIGRATION: PAUSED | Migration creation paused |
| 917 | CREATE_MIGRATION: QUEUED | Migration creation queued |
| 920 | MIGRATE_DATA : RUNNING | Data migration is in process |
| 921 | MIGRATE_DATA : FAILED | Data migration failed |
| 922 | MIGRATE_DATA : SUCCEEDED | Data migration succeeded |
| 923 | MIGRATE_DATA : STOPPING | Data migration is stopping |
| 924 | MIGRATE_DATA : STOPPED | Data migration has stopped |
| 925 | MIGRATE_DATA : PAUSED | Data migration is paused |
| 927 | MIGRATE_DATA : QUEUED | Migrate data queued |
| 930 | SCAN : RUNNING | Scan is in process |
| 931 | SCAN : FAILED | Scan failed |
| 932 | SCAN : SUCCEEDED | Scan succeeded |
| 933 | SCAN : STOPPING | Scan stopping |
| 934 | SCAN : STOPPED | Scan stopped |
| 935 | SCAN : PAUSED | Scan paused |
| 936 | SCAN : SKIPPED | Scan skipped |
| 937 | SCAN : QUEUED | Scan queued |
| 940 | DATA_UPLOAD : RUNNING | Data Upload is in process |
| 941 | DATA_UPLOAD : FAILED | Data Upload failed |
| 942 | DATA_UPLOAD : SUCCEEDED | Data Upload succeeded |
| 943 | DATA_UPLOAD : STOPPING | Data Upload stopping |
| 944 | DATA_UPLOAD : STOPPED | Data Upload stopped |
| 945 | DATA_UPLOAD : PAUSED | Data Upload paused |
| 947 | DATA_UPLOAD : QUEUED | Data Upload queued |
| 948 | DATA_UPLOAD : SUSPENDED | Data Upload suspended |
| 950 | DATA_SYNC : RUNNING | True-Up is in process |
| 951 | DATA_SYNC : FAILED | True-Up failed |
| 952 | DATA_SYNC : SUCCEEDED | True-Up succeeded |
| 953 | DATA_SYNC : STOPPING | True-Up stopping |
| 954 | DATA_SYNC : STOPPED | True-Up stopped |
| 955 | DATA_SYNC : PAUSED | True-Up paused |
| 957 | DATA_SYNC : QUEUED | Data Sync queued |
| 958 | DATA_SYNC : SUSPENDED | Data Sync suspended |
| 960 | MIGRATE_PERMISSIONS : RUNNING | Migrate Permissions is in process |
| 961 | MIGRATE_PERMISSIONS : FAILED | Migrate Permissions failed |
| 962 | MIGRATE_PERMISSIONS : SUCCEEDED | Migrate Permissions succeeded |
| 963 | MIGRATE_PERMISSIONS : STOPPING | Migrate Permissions stopping |
| 964 | MIGRATE_PERMISSIONS : STOPPED | Migrate Permissions stopped |
| 965 | MIGRATE_PERMISSIONS : PAUSED | Migrate Permissions paused |
| 967 | MIGRATE_PERMISSIONS : QUEUED | Migrate Permissions queued |
| 970 | SANITIZE : RUNNING | Sanitize is in process |
| 971 | SANITIZE : FAILED | Sanitize failed |
| 972 | SANITIZE : SUCCEEDED | Sanitize succeeded |
| 973 | SANITIZE : STOPPING | Sanitize stopping |
| 974 | SANITIZE : STOPPED | Sanitize stopped |
| 975 | SANITIZE : PAUSED | Sanitize paused |
| 976 | SANITIZE : SKIPPED | Sanitize skipped |
| 977 | SANITIZE : QUEUED | Sanitize queued |
| 980 | FINALIZE_MIGRATION : RUNNING | Delete Migration is in process |
| 981 | FINALIZE_MIGRATION : SUCCEEDED | Delete Migration succeeded |
| 982 | FINALIZE_MIGRATION : FAILED | Delete Migration failed |
| 983 | FINALIZE_MIGRATION : PAUSED | Delete Migration paused |
| 984 | FINALIZE_MIGRATION : STOPPED | Delete Migration stopped |
| 987 | FINALIZE_MIGRATION : QUEUED | Delete Migration queued |
| 101 | META_MIGRATE_DATA : RUNNING | Meta Migrate Data is in process |
| 102 | META_MIGRATE_DATA : FAILED | Meta Migrate Data failed |
| 103 | META_MIGRATE_DATA : SUCCEEDED | Meta Migrate Data succeeded |
| 104 | META_MIGRATE_DATA : STOPPING | Meta Migrate Data is stopping |
| 105 | META_MIGRATE_DATA : STOPPED | Meta Migrate Data stopped |
| 106 | META_MIGRATE_DATA : PAUSED | Meta Migrate Data paused |
| 107 | META_MIGRATE_DATA : QUEUED | Meta Migrate Data is queued |
| 110 | ASYNC_COPY : RUNNING | Async copy is running |
| 111 | ASYNC_COPY : FAILED | Async copy is failed |
| 112 | ASYNC_COPY : SUCCEEDED | Async copy is succeeded |
| 113 | ASYNC_COPY : STOPPING | Async copy is stopping |
| 114 | ASYNC_COPY : STOPPED | Async copy is stopped |
| 115 | ASYNC_COPY : PAUSED | Async copy is paused |
| 117 | ASYNC_COPY : QUEUED | Async copy is queued |
| 118 | ASYNC_COPY : SUSPENDED | Async copy is suspended |
| 120 | CREATE_EMPTY_FOLDERS : RUNNING | Create Empty Folders is in process |
| 121 | CREATE_EMPTY_FOLDERS : FAILED | Create Empty Folders is failed |
| 122 | CREATE_EMPTY_FOLDERS : SUCCEEDED | Create Empty Folders is succeeded |
| 123 | CREATE_EMPTY_FOLDERS : STOPPING | Create Empty Folders is stopping |
| 124 | CREATE_EMPTY_FOLDERS : STOPPED | Create Empty Folders is stopped |
| 125 | CREATE_EMPTY_FOLDERS : PAUSED | Create Empty Folders paused |
| 127 | CREATE_EMPTY_FOLDERS : QUEUED | Create Empty folders queued |
| 130 | SIMULATE_PERMISSIONS : RUNNING | Simulate Migrate Permission is in process |
| 131 | SIMULATE_PERMISSIONS : FAILED | Simulate Migrate Permission failed |
| 132 | SIMULATE_PERMISSIONS : SUCCEEDED | Simulate Migrate Permission succeeded |
| 133 | SIMULATE_PERMISSIONS : STOPPING | Simulate Migrate Permission is stopping |
| 134 | SIMULATE_PERMISSIONS : STOPPED | Simulate Migrate Permission stopped |
| 135 | SIMULATE_PERMISSIONS : PAUSED | Simulate Migrate Permission is paused |
| 137 | SIMULATE_PERMISSIONS :QUEUED | Simulate Migrate Permission is queued |
| 210 | SPEED_TEST : RUNNING | Speed Test is in process |
| 211 | SPEED_TEST : FAILED | Speed Test failed |
| 212 | SPEED_TEST : SUCCEEDED | Speed Test succeeded |
| 213 | SPEED_TEST : STOPPING | Speed Test is stopping |
| 214 | SPEED_TEST : STOPPED | Speed Test is stopped |
| 215 | SPEED_TEST : PAUSED | Speed Test is paused |
| 220 | SCHEDULE_JOB : CREATED | Scheduler job created |
| 221 | SCHEDULE_JOB : RUNNING | Scheduler job is running |
| 222 | SCHEDULE_JOB : SUCCEEDED | Scheduler job succeeded |
| 223 | SCHEDULE_JOB : STOPPING | Scheduler job is stopping |
| 224 | SCHEDULE_JOB : STOPPED | Scheduler job stopped |
| 225 | SCHEDULE_JOB : FAILED | Scheduler job failed |
| 226 | SCHEDULE_JOB : PAUSED | Scheduler job paused |
| 230 | SCAN_SOURCE : RUNNING | Scan source is running |
| 231 | SCAN_SOURCE : FAILED | Scan source failed |
| 232 | SCAN_SOURCE : SUCCEEDED |
Scan source succeeded |
| 233 | SPEED_TEST : PAUSED | Scan source is paused |
Project
| Status Code | Status code string representation | Description |
| 140 | CREATE_PROJECT : SUCCEEDED | Create project succeeded |
| 141 | SIMULATE_SCAN : RUNNING | Simulate scan running |
| 142 | SIMULATE_SCAN : FAILED | Simulate scan failed |
| 143 | SIMULATE_SCAN : SUCCEEDED | Simulate scan succeeded |
| 144 | SIMULATE_SCAN : PAUSED | Simulate scan paused |
| 145 | DELETE_PROJECT : SUCCEEDED | Delete project succeeded |
| 146 | DELETE_PROJECT : FAILED | Delete project failed |
| 160 | VALIDATE_PROJECT : RUNNING | Validate project running |
| 161 | VALIDATE_PROJECT : FAILED | Validate project failed |
| 162 | VALIDATE_PROJECT : SUCCEEDED | Validate project succeeded |
| 163 | VALIDATE_PROJECT : PAUSED | Validate project paused |
| 164 | VALIDATE_PROJECT : STOPPING | Validate project stopping |
| 165 | VALIDATE_PROJECT : STOPPED | Validate project stopped |
Advanced Mode Errors
| Status Code | Status code string representation | Description |
| 500 | ERR_POST_CONFIG_FILE_GET | Error while uploading config file. |
| 501 | ERR_CONFIG_FILE_OPEN | Error while opening config file (incorrect format of file.) |
| 502 | ERR_INCORRECT_AGENT_ID | Error if agent ID mismatches for which config file is uploaded. |
| 503 | ERR_CONFIG_VALIDATION | Error if config format (JSON) is incorrect. |
| 504 | ERR_EMPTY_MIGRATION_ID_AND_PATHS | Migration ID is empty but required source and destination paths were not provided. |
| 505 | ERR_DUPLICATE_MIGRATION_ID | The provided migration ID already exists and is a duplicate. |
| 506 | ERR_MIGRATION_NOT_FOUND_ADVANCE | No migration was found matching the provided identifier. |
| 507 | ERR_MIGRATION_NAME_ID_MISMATCH | The migration name does not match the expected value for the given migration ID. |
| 508 | ERR_MIGRATION_CONFIG_REQUIRED | A migration configuration is required but was not provided. |
| 509 | ERR_MIGRATION_CONFIG_UPDATE | Failed to update the migration configuration. |
| 510 | ERR_MIGRATION_EXCLUSION_RULES_UPDATE | The exclusion rules provided for the migration are invalid. |
| 511 | ERR_MIGRATION_CONFIG_CREATE_SCHEDULER | Failed to create a scheduled job for the migration. |
| 512 | ERR_MIGRATION_CONFIG_UPDATE_SCHEDULER | Failed to update the scheduled job for the migration. |
| 513 | ERR_MIGRATION_CONFIG_SCHEDULER_TIMES | The scheduler repeat count is invalid; valid range is 1–20 (or domain-configured max). |
| 514 | ERR_MIGRATION_CONFIG_SCHEDULER_FREQUENCY | The scheduler frequency is invalid |
| 515 | ERR_MIGRATION_CONFIG_SCHEDULER_TIME_IN_PAST | The scheduler start time is in the past |
| 516 | ERR_MIGRATION_CONFIG_SCHEDULER_ENABLED | Job scheduling is not enabled for the agent associated with this migration. |
| 517 | ERR_MIGRATION_CONFIG_SYNCDELETES_CONFLUENCE | syncDeletes cannot be enabled when Confluence is enabled for the migration. |
| 518 | ERR_MIGRATION_CONFIG_UPDATE_SANITIZE_ONFLY | The sanitize setting cannot be changed away from "Always On Fly" for this migration config |
| 519 | ERR_MIGRATION_CONFIG_UPDATE_SANITIZE_ONFLY_SCHEDULER | The scheduler sanitize setting cannot be changed away from “Always on fly” for this migration. |
Miscellaneous Errors
| Status Code | Status code string representation | Description | Comments |
| 600 | ERR_JSON_DECODING | JSON Decoding, Encoding Error | Internal error. Error code 600 |
| 605 | ERR_JSON_MARSHAL_UNMARSHAL | Object Conversion Error: JSON Marshaling, Unmarshaling Error | Internal error. Error code 605 |
| 610 | ERR_URL_PARSE | URL Parse Error | Internal error. Error code 610 |
| 620 | ERR_INVALID_OPCODE | Invalid Opcode | |
| 621 | ERR_WRONG_TYPE_TO_DEACTIVATE | Wrong type (Master/Agent) given to deactivate Agent | |
| 622 | ERR_TOKEN_MISSING | Token not found | |
| 623 | ERR_INVALID_DOMAIN | Domain invalid | |
| 624 | ERR_SEMVER_PARSE | Cannot parse a given version (should match with SEMVER format) | |
| 625 | ERR_AGENT_CONTAINS_MIGRATION | Error when deleting an agent. Cannot delete an agent which has associated migration jobs. | |
| 626 | ERR_AGENT_NAME_ALREADY_USED | Error if agent has duplicate name. | |
| 627 | ERR_MISSING_WORKGROUP | Error for missing workgroup ID. | |
| 628 | ERR_ACTIVE_MIGRATIONS_LIMIT | Error for concurrent running migration limit. | |
| 629 | JOB_LIMIT_FILE_COUNT_EXCEEDED_SCANNED | Maximum job files limit exceeded. Please split into smaller jobs or contact support to discuss increasing the limits for your domain. | |
| 630 | ERR_UI_OUTDATED | Token not found. | |
| 631 | ERR_FETCH_JOB_LIMITS | Error if fetching job limit from Setting Service Manager fails. | |
| 632 | ERR_MIGRATION_IN_CONFLICT | Error in case of conflicted job. Confluence needs to be enabled for the job. | |
| 633 | ERR_MA_UNACCESSIBLE | Error in case API is accessed for customer who has MA disabled (This is related to security, not expecting on UI) | |
| 634 | ERR_FILTER_PATTERN | The filter pattern entered is invalid. | |
| 635 | ERR_FILTER_PATTERN_GLOB | The glob filter pattern entered is invalid. Ensure it uses the correct glob syntax (e.g. *.txt, folder/**) | |
| 636 | ERR_FILTER_PATTERN_REGEX | The regex filter pattern entered is invalid. Ensure it uses correct regular expression syntax | |
| 637 | ERR_FEATURE_NOT_ENABLED |
This is error when feature flag is not enabled, corresponding API should not be accessible.
|
|
| 638 | ERR_FALLBACK_FOLDER_PICKER | Error if customer falls into fallback case which is source is too large to scan | |
| 639 | UNABLE_TO_FETCH_TOKEN | Failed to retrieve the authentication token required to execute the migration command. Please login again and try the command. | |
| 640 | JOB_LIMIT_SIZE_EXCEEDED_SCANNED | Maximum job size limit exceeded. Please split into smaller jobs or contact support to discuss increasing the limits for your domain. | |
| 641 | ERR_MIGRATION_COMMAND_HUNG | The command operation is unsuccessful because the migration job is continuously hung. | |
| 642 | ERR_PROJECT_NAME_ALREADY_USED | The specified project name is already in use and cannot be reused. | |
| 643 | MIGRATION_COMMAND_FORBIDDEN_DEST_PATH_PERM_ERROR | Insufficient permissions on the destination path to upload data. | |
| 644 | ERR_FILTER_PATTERN_PROJECT | Exclusion/filter rules could not be validated due to an error. |
State Validation Errors
| Status Code | Status code string representation | Description |
| 650 | SCAN_INPROGRESS_ERR | Returned as part of running a command when Scan command is already in progress |
| 651 | SANITIZE_INPROGRESS_ERR | Returned as part of running a command when Sanitize command is already in progress |
| 652 | COPY_INPROGRESS_ERR | Returned as part of running a command when Copy (Migrate Data) command is already in progress |
| 653 | SYNC_INPROGRESS_ERR | Returned as part of running a command when Sync (True-Up) command is already in progress |
| 654 | PERMS_INPROGRESS_ERR | Returned as part of running a command when Migrate Permissions command is already in progress |
| 655 | SCAN_REQUIRED_ERR | Notifies users that Scan command needs to be executed first |
| 656 | SCAN_STOP_UNREQUIRED_ERR | Notifies users that Scan command doesn't need to be stopped |
| 657 | SANITIZE_STOP_UNREQUIRED_ERR | Notifies users that Sanitize command doesn't need to be stopped |
| 658 | COPY_STOP_UNREQUIRED_ERR | Notifies users that Migrate Data command doesn't need to be stopped. |
| 659 | SYNC_STOP_UNREQUIRED_ERR | Notifies users that True-Up command doesn't need to be stopped |
| 660 | PERMS_STOP_UNREQUIRED_ERR | Notifies users that Migrate Permissions command doesn't need to be stopped |
| 661 | MIGRATION_INPROGRESS_ERR | A Migration Job is running. Additional requests will be denied. |
| 663 | SCAN_STOP_INPROGRESS_ERR | Error if scan is stopping. Additional requests will be denied. |
| 664 | SANITIZE_STOP_INPROGRESS_ERR | Error if sanitize is stopping. Additional requests will be denied. |
| 665 | COPY_STOP_INPROGRESS_ERR | Error if Migrate Data command is stopping. Additional requests will be denied. |
| 666 | SYNC_STOP_INPROGRESS_ERR | Error if True-Up is stopping. Additional requests will be denied. |
| 667 | PERMS_STOP_INPROGRESS_ERR | Error if permissions is in stopping state. Additional requests will be denied. |
| 668 | SCAN_STOP_REQUIRED_ERR | Notify user that scan command required a stop. |
| 669 | SANITIZE_STOP_REQUIRED_ERR | Notify user that sanitize command required a stop. |
| 670 | COPY_STOP_REQUIRED_ERR | Notify user that Migrate Data command required a stop. |
| 671 | SYNC_STOP_REQUIRED_ERR | Notify user that True-Up command required a stop. |
| 672 | PERMS_STOP_REQUIRED_ERR | Notify user that Migrate Permissions command required a stop. |
| 673 | MIGRATE_DATA_INPROGRESS_ERR | Error if Migrate Data command is running, additional requests will be denied. |
| 674 | MIGRATE_DATA_STOP_INPROGRESS_ERR | Error if Migrate Data command is stopping. Additional requests will be denied. |
| 675 | MIGRATE_DATA_STOP_REQUIRED_ERR | Notify user that Migrate Data command required a stop. |
| 676 | MIGRATE_DATA_STOP_UNREQUIRED_ERR | Notify user that Migrate Data command doesn't need to be stopped. |
| 677 | MIGRATION_CREATION_PAUSED_ERR | Notify user that Create Migration has been paused due to agent inactivity. |
| 678 | MIGRATION_DELETION_PAUSED_ERR | Notify user that Delete Migration has been paused due to agent inactivity. |
| 679 | AGENT_DEACTIVATION_REQUIRED_ERR | Notify user that agent deactivation is required. |
| 680 | AGENT_UPDATE_INPROGRESS_ERR | Notify user that agent update is in progress while running any command. |
| 681 | AGENT_SCHEDULER_INPROGRESS_ERR | Notify user that agent upgrade scheduler in progress |
| 682 | EMPTY_FOLDERS_INPROGRESS_ERR | Returned as part of running a command when Create Empty Folders command is already in progress. |
| 683 | EMPTY_FOLDERS_STOP_UNREQUIRED_ERR | Notifies user that create empty folders command doesn't need to be stopped. |
| 684 | EMPTY_FOLDERS_STOP_INPROGRESS_ERR | Notifies user that create empty folders stop is in progress. |
| 685 | EMPTY_FOLDERS_STOP_REQUIRED_ERR | Notifies user that create empty folders command required a stop. |
| 686 | SCAN_AGENT_INACTIVE_ERR | Notify user that agent is inactive while running the scan command. |
| 687 | SANITIZE_AGENT_INACTIVE_ERR | Notify user that agent is inactive while running the sanitize command |
| 688 | COPY_AGENT_INACTIVE_ERR | Notify user that agent is inactive while running the copy command |
| 689 | SYNC_AGENT_INACTIVE_ERR | Notify user that agent is inactive while running the sync command |
| 690 | EMPTY_FOLDER_AGENT_INACTIVE_ERR | Notifies user that agent is inactive while running the empty folder command. |
| 691 | MIGRATE_PERMISSION_AGENT_INACTIVE_ERR | Notify user that agent is inactive while running the permission command. |
| 692 | CREATE_MIGRATION_AGENT_INACTIVE_ERR | Notify user that agent is inactive while running the create migration command |
| 693 | FAILED_TO_SEND_MESSAGE_TO_AGENT | Notify user that command message not processed due to unstable websocket connection when UI request was received (It could be because of network) |
| 694 | FAILED_TO_SEND_MESSAGE_TO_AGENT | Notify user that command message not processed due to unstable web socket connection when UI request was received (It could be because of network) |
| 695 | SCAN_SOURCE_AGENT_INACTIVE_ERR | Error when agent is inactive and scan is requested for source |
| 696 | SCAN_SOURCE_INPROGRESS_ERR | Error when scan command is already in progress and another scan/Upgrade agent is requested for source |
| 697 | SCAN_SOURCE_TIMEOUT_ERR | Error when agent is unresponsive for more than 5 min regarding command running, it will be timeout |
| 698 | SCAN_SOURCE_FILE_NOT_FOUND | This is internal error handling as per implementation mechanism, if snapshot captured by agent is not found. |
| 699 | PROJECT_DELETION_FAILURE_MIGRATION_EXISTS | Project deletion failed because one or more active migrations exist under the project. |
| 720 | SIMULATE_SCAN_TIMEOUT_ERR | The simulate scan command failed because it exceeded the allowed timeout. |
| 721 | SIMULATE_SCAN_AGENT_INACTIVE_ERR | The simulate scan command failed because the agent is in an inactive state. |
| 722 | PROJECT_FORBIDDEN_DEST_SHARED_PATH_ERROR | The selected destination path does not have the required permissions. |
| 723 | SPLIT_JOBS_NOT_FOUND | No recommendation is available for the scan command; the scan needs to be re-initiated. |
| 724 | INCORRECT_MIGRATION_CONFIG | The migration configuration is in an incorrect or invalid format. |
| 725 | VALIDATE_PROJECT_TIMEOUT_ERR | The validate project command failed because it exceeded the allowed timeout |
| 726 | VALIDATE_PROJECT_AGENT_INACTIVE_ERR | The validate project command failed because the agent is in an inactive state. |
| 727 | PROJECT_CONFIG_SANITIZE_UPDATE_ERROR | The sanitize setting is locked to "Sanitize on the Fly" and cannot be updated once enabled. |
| 728 | VALIDATION_INVALID_CONFIG_ERROR | Project validation failed due to an invalid project-level configuration; the Sanitize setting must be updated before proceeding. |
| 729 | CONFIG_INVALID_OLD_PROJECT_ERROR | Simulated scan results are outdated due to new features. |
| 730 | PROJECT_MIGRATION_RUNNING_CONFIG_UPDATE_ERROR | Project configuration cannot be updated while a migration is actively running under the project. |
Database Errors
| Status Code | Status code string representation | Description |
| 800 | DB_ERR_GET_DOC_NOT_FOUND | Firestore Error: Document not found |
| 801 | DB_ERR_GET_DOC | Firestore Error: Failed to get document due to other reasons |
| 803 | DB_ERR_GET_DOCS | Firestore Error: Failed to get multiple documents |
| 804 | DB_ERR_GET_USER_DOC_NOT_FOUND | Firestore Error: User document not found |
| 805 | DB_ERR_GET_SELECTED_DOCS |
Firestore Error: Failed to get multiple documents Based on Selected field |
| 806 | DB_ERR_GET_USER_DOC_FOR_DOMAIN | Firestore Error: Failed to get user document for a particular domain |
| 810 | DB_ERR_UPDATE_DOC | Firestore Error: Failed to update document |
| 816 | DB_ERR_DELETE_DOC | Firestore Error: Failed to delete document |
| 820 | DB_ERR_CREATE_REF_ID | Firestore Error: Failed to create document reference ID |
| 821 | DB_ERR_CREATE_DOC | Firestore Error: Failed to create document |
| 822 | DB_ERR_INCORRECT_COLLECTION_NAME | Firestore Error: Incorrect Collection Name provided |
Authentication Errors
| Status Code | Status code string representation | Description |
| 700 | AUTH_ERR_MISSING_USER_COOKIE | Authorization error, userID cookie missing |
| 702 | AUTH_ERR_INCORRECT_DOMAIN | Authorization error, incorrect domain |
| 704 | AUTH_ERR_JWT_VALIDATION_MALFORMED | Authorization error, JWT (JSON Web Token) validation failed |
| 705 | AUTH_ERR_JWT_VALIDATION_INVALID | Authorization error, invalid JWT (JSON Web Token) notification |
| 706 | AUTH_ERR_JWT_VALIDATION_OTHERS | Authorization error, other JWT (JSON Web Token) validation errors |
| 707 | AUTH_ERR_JWT_INVALID | Authorization error, invalid JWT (JSON Web Token) |
| 708 | AUTH_ERR_JWT_GET_CLAIMS | Authorization error, fails to decode JWT (JSON Web Token) fields |
| 709 | AUTH_ERR_MISSING_CMM_VERIFICATION_ID_COOKIE | Authorization error, CMMVerificationID cookie missing |
| 710 | AUTH_ERR_MISSING_CMM_USER_ID | Authorization error, user ID missing |
| 711 | AUTH_ERR_INCORRECT_CMM_VERIFICATION_ID | Authorization error, incorrect CMMVerificationID |
| 712 | AUTH_ERR_HTTP_POST_REQ | HTTP POST request error |
| 713 | AUTH_ERR_USER_TOKEN_NOT_FOUND | User token missing |
| 714 | AUTH_ERR_HTTP_POST_RESP | HTTP POST response error |
| 715 | AUTH_ERR_HTTP_POST_RESP_STATUS_CODE | HTTP POST response status code error |
| 716 | AUTH_ERR_HTTP_GET_REQ | HTTP GET request error |
| 717 | AUTH_ERR_HTTP_GET_RESP | HTTP GET response error |
| 718 | AUTH_ERR_JWT_SHARED_SECRET_ENV_MISSING | Authorization error, shared secret environment variable is missing |
Websocket Errors
| Status Code | Status code string representation | Description | Comments |
| 850 | WEBSOCKET_REQUEST_ERR_MISSING_DOMAIN | Domain cannot be empty. | Only displayed during registration |
| 851 | WEBSOCKET_REQUEST_ERR_MISSING_USERNAME | Username cannot be empty. | Only displayed during registration |
| 852 | WEBSOCKET_REQUEST_ERR_MISSING_AGENT_ID | Agent Id cannot be empty. | Only displayed during registration |
| 853 | WEBSOCKET_REQUEST_ERR_INCORRECT_DOMAIN | Domain name is incorrect | Only displayed during registration |
| 854 | WEBSOCKET_REQUEST_ERR_INCORRECT_USERNAME | Username is incorrect | Only displayed during registration |
| 855 | WEBSOCKET_REQUEST_ERR_INCORRECT_AGENT_ID | Agent Id is invalid | Only displayed during registration |
| 856 | WEBSOCKET_REQUEST_ERR_AGENT_STATUS_ACTIVE | Agent already in "Active" status | Only displayed during registration |
| 857 | WEBSOCKET_REQUEST_ERR_GET_USER_DB_FAILURE | User missing for Agent | Only displayed during registration |
| 858 | WEBSOCKET_REQUEST_ERR_GET_USER_DB_NOT_FOUND | Control Plane error (DB obj fetch error) | Only displayed during registration |
| 859 | WEBSOCKET_REQUEST_ERR_INTERNAL_ERROR | Control Plane Error (object conversion error) | Only displayed during registration |
| 860 | WEBSOCKET_REQUEST_ERR_AGENT_TOKEN_FAILURE | Fail to fetch internal token for agent | Only displayed during registration |
| 861 | WEBSOCKET_REQUEST_ERR_SOCKET_UPGRADE | Invalid Connection URL (861) | Only displayed during registration |
| 862 | WEBSOCKET_REQUEST_ERR_AGENT_STATUS_DEACTIVATED | Agent in "deactivate" status | Only displayed during registration |
| 863 | WEBSOCKET_REQUEST_ERR_MISSING_AGENT_VERSION | Agent Version is missing | |
| 864 | WEBSOCKET_REQUEST_ERR_UNSUPPORTED_AGENT_VERSION | Agent version is invalid | |
| 865 | WEBSOCKET_REQUEST_ERR_WRONG_AGENT_VERSION | Agent version doesn't match with SEMVER format | |
| 866 | WEBSOCKET_REQUEST_ERR_INCORRECT_EMAIL | The WebSocket request failed because the provided email address is incorrect | |
| 867 | WEBSOCKET_REQUEST_ERR_INVALID_USER_PASSWORD | The WebSocket request failed due to an invalid username or password. | |
| 868 | WEBSOCKET_CONNECTION_ERR_REGISTRATION_FAILED | The WebSocket connection could not be established because agent registration failed. | |
| 869 | UPDATE_CONFIG_FAILED | Failed to update the configuration. | |
| 870 | AUTH_FAILED_REQUEST_PASSWORD | Authentication failed while attempting to request a password. |
Agent Upgrade
| Status Code | Status code string representation | Description |
| 993 | AGENT_UPGRADE_RUNNING | When upgrade is started, agent disconnects (inactive) and runs the process. |
| 994 | AGENT_UPGRADE_SUCCEEDED | When agent comes back with its version info, Control Plane judges if upgrade succeeded based on both the current and latest version. If same, succeeded. |
| 995 | AGENT_UPGRADE_FAILED | When agent comes back with its version info, Control Plane judges if upgrade succeeded based on both the current and latest version. If different, failed. |
| 996 | AGENT_UPGRADE_TIMEOUT | When upgrade took longer than 5 minutes |
Agent Retire
| Status Code | Status code string representation | Description |
| 193 | AGENT_RETIRE_RUNNING | When retirement is started, agent disconnects (inactive) and runs the process. |
| 194 | AGENT_RETIRE_SUCCEEDED | When does not come back. |
| 195 | AGENT_RETIRE_FAILED | When agent comes back, Control Plane judges that retirement failed. |
| 196 | AGENT_RETIRE_TIMEOUT | When retirement took longer than 5 minutes |
Agent
| Status Code | Status code string representation | Description |
| 0 | BLANKERRORCODE | Returned when no specific error code has been set. Indicates an unclassified or unrecognized error state. |
| 0 | NOERRORCODE | Returned when the operation completes with no error. Indicates a successful outcome with nothing further to report. |
| 1000 | CONTEXT_CANCELED_ERROR | The operation was aborted because the request context was canceled, typically due to a connection close or timeout. |
| 1010 | UNSUPPORTED_VERSION_ERROR | When the CMM Agent (whose version is not supported by the Control Plane) tries to establish connection with CP, this error is returned. |
| 1011 | VERSION_UPTODATE_ERROR | When UI requests a CMM Agent update, the agent can already be up-to-date. Control Plane returns this error to prevent further action. |
| 1020 | INVALID_COMMAND_DATA_FORMAT_ERROR | When a sub-process (spawned by the CMM Agent) is not able to decode the message received from Control Plane, the sub-process exits without any further action and returns this error. |
| 1021 | DEST_PATH_CANONICAL_DIFF_ERROR | When migration path is canonically different than the path existing on destination. |
| 1030 | INVALID_COMMAND_DATA_ERROR | Returned when the Agent receives a command with data that is present but cannot be interpreted or is in an unexpected format. |
| 1040 | TOO_MANY_OPEN_FILE_HANDLES_ERROR | Returned when the Agent has exceeded the allowed number of simultaneously open file handles on the system, preventing further file operations |
| 1050 | INVALID_COMMAND_ERROR | When Control Plane sends incorrect OPCODE to the CMM Agent, this error is returned to CP. |
| 1060 | CREATE_MIGRATION_REPORT_ERROR | Returned when the Agent fails to create the migration report file at the start of a migration task. |
| 1070 | UPDATE_MIGRATION_REPORT_ERROR | Returned when the Agent fails to update an existing migration report during or after a migration task. |
| 1080 | INVALID_MIGRATION_REPORT_PATH_ERROR | When migration-summary report folder path is invalid, this error is returned to Control Plane |
| 1090 | INVALID_EXECUTABLE_PATH | When the the CMM Agent binary path fetched from environment variable is invalid, this error occurs. |
| 1100 | COMMAND_START_ERROR | This occurs when sub-process is unable to be started by the CMM Agent. |
| 1120 | PIPE_READ_ERROR | Returned when the Agent encounters an error while reading data from a sub-process pipe, causing the operation to terminate. |
| 1130 | PIPE_DECODE_ERROR | Returned when the Agent is unable to decode the data read from a sub-process |
| pipe, indicating the data is in an unexpected or corrupted format. | ||
| 1131 | MESSAGE_DECODE_ERROR | Returned when the Agent fails to decode an incoming message, indicating the message structure does not match the expected format. |
| 1150 | INVALID_MESSAGE | Returned when the Agent receives a message that is structurally valid but contains unrecognized or unsupported content. |
| 1160 | MIGRATION_LOCK_ERROR | Returned when the Agent is unable to acquire the migration lock, typically because another migration operation is already running on the same resource. |
| 1180 | AUTH_FAILED_ERROR | Returned when the Agent fails to authenticate. This may indicate invalid or expired credentials. |
| 2010 | MIGRATION_INVALID_SOURCE_PATH_ERROR | This occurs when the source mentioned in create-migration step is invalid. |
| 2011 | MIGRATION_INVALID_SOURCE_TYPE_ERROR | This occurs when the source is invalid type mentioned in create-migration step (non-local) |
| 2012 | MIGRATION_INVALID_SOURCE_INFO_ERROR | This occurs when the valid information is not accessible in create-migration step |
| 2013 | MIGRATION_INVALID_SOURCE_ABS_ERROR | This occurs when cannot access to the absolute path in create-migration step |
| 2015 | MIGRATION_INVALID_DESTINATION_PATH_ERROR | The destination path is invalid |
| 2016 | MIGRATION_FORBIDDEN_DEST_SHARED_PATH_ERROR | The user does not have permission to copy data to the destination folder. Editor access is required to run the job. |
| 2017 | MIGRATION_NOT_FOUND | The specified migration could not be found. |
| 2018 | MIGRATION_FORBIDDEN_DEST_SHARED_PATH_PERM_ERROR | The agent owner does not have sufficient permissions on the destination folder; Editor access is required to run the job. |
| 2030 | MIGRATION_CREATE_ERROR | Returned when the Agent fails to create a new migration entry, typically due to an issue with the local migration store. |
| 2040 | MIGRATION_UPDATE_ERROR | This occurs when the CMM Agent is unable to update the attributes related to a migration in migration-info file. |
| 2050 | MIGRATION_DELETE_ERROR | Returned when the Agent fails to delete a migration entry from the local migration store. |
| 2060 | DISK_HASH_CREATE_ERROR | This occurs when the CMM Agent is unable to create persistent data store locally (i.e., diskhash file). |
| 2070 | DISK_HASH_DELETE_ERROR | Returned when the Agent fails to delete the disk hash file associated with a migration, which may affect future incremental sync operations. |
| 2080 | MIGRATION_NOT_FOUND_ON_SOURCE | The cmmagent subprocess is running in the background. Please stop the process and retry the migration command. |
| 2090 | MIGRATION_FINALIZE_ERROR | If any error occurs during finalize migration, this error is returned. |
| 2100 | DISK_HASH_LOAD_ERROR | When the CMM Agent is unable to load/read the persistent data store (i.e., diskhash) during copy/sync, this is returned. |
| 2200 | MIGRATION_RUNNING_DISKHASH_ERROR | The agent was upgraded from a significantly older version, making existing migration jobs incompatible; existing migrations must be recreated and Confluence mode must be enabled to prevent data loss. |
| 3010 | SCAN_INVALID_EXCLUDE_RULE_ERROR | Returned when one or more exclusion rules provided for the scan are invalid or cannot be parsed, preventing the scan from starting. |
| 3020 | SCAN_REPORT_FOLDER_ERROR | When the CMM Agent is unable to get the scan-report folder location while scanning the source data, this is returned. |
| 3030 | INVALID_SOURCE_PATH_ERROR | When the source path/root folder path is invalid while scanning the data source, this is returned. |
| 3040 | SCAN_FAILURE_ERROR | When any fatal error occurs that could stop the scanning step (other than mentioned above) while scanning the data-source, this error is returned. It means that scan has failed for the current source path. |
| 3050 | SCAN_FAILURE_50K_LIMIT_ERROR | When a folder contains more than 50,000 files or folders |
| 3060 | SCAN_FAILURE_PRE_CHECK | The scan failed during pre-check because one or more parameters did not pass validation; the issues must be resolved before the migration job can proceed. |
| 3070 | SCAN_FAILURE_NOTHING_TO_MIGRATE | The scan failed because there is no data eligible for migration, which may be caused by exclusion rules filtering out all content or the folder containing only Egnyte-incompatible items. |
| 4010 | SANITIZE_RENAME_ERROR | If any error occurs while sanitizing/renaming the files/folders, this is returned. |
| 4020 | SANITIZE_REPORT_FOLDER_ERROR | If the CMM Agent is unable to find the sanitize folder location for a particular migration-id in the LocalAppData/egnyte-agent (for Windows), this is returned. |
| 4030 | SANITIZE_INVALID_SCAN_RESULT_ERROR | Before starting the Sanitize operation, CMM Agent does a scan on the source to be sanitized. If the Agent finds any error while scanning the source, this error is returned. |
| 5010 | COPY_FILTER_FFL_ERROR | Returned when the Agent fails to apply the file filter list during the copy operation, preventing files from being correctly selected for upload. |
| 5030 | COPY_UPLOAD_REPORT_FOLDER_ERROR | Returned when the Agent fails to create or access the upload report folder required to track the copy operation's progress. |
| 5040 | COPY_INVALID_SCAN_RESULT_ERROR | During the Migrate Data operation, if the CMM Agent is unable to find the scan-report that was generated in scan operation, this is returned |
| 5050 | UPLOAD_FAILURE_ERROR | If the file is unable to upload to destination domain for any reason, this error is returned. |
| 6010 | PFFL_FETCH_ERROR | During Sync operation, if the CMM Agent encounters any error while fetching the pFFL (partial FFL) from Egnyte CFS, this error is returned. |
| 6020 | PFFL_REPORT_PATH_ERROR | During Sync operation, if the CMM Agent is unable to create local persistent data store for pFFL (partial FFL), this error occurs. |
| 6030 | DISK_HASH_PATH_ERROR | During Sync operation, if the CMM Agent is unable to find the path for persistent data store, this error occurs. |
| 6040 | SYNC_UPLOAD_REPORT_FOLDER_ERROR | During Sync operation, if the CMM Agent is unable to find the location (or path is invalid) for "status" folder then this error occurs. This "status" contains the success and failure reports that shows which file is successfully uploaded and which encountered error. |
| 6050 | SYNC_DIFF_CALCULATE_ERROR | During Sync operation, if there is any error occurred while diff calculation step, then error occurs. |
| 6060 | SYNC_FAILURE_ERROR | Returned when the Agent encounters a critical failure during the sync operation, causing it to terminate before completion. |
| 6070 | DISKHASH_DELETE_ERROR | Returned when the Agent fails to delete the disk hash file during a sync operation, which may affect the accuracy of future sync runs. |
| 6080 | DISK_SPACE_NOT_ENOUGH_ERROR | During sanitize operation, if not enough space available to support. |
| 6081 | JOB_ABORTED_LOW_MEMORY | The system does not have sufficient RAM available; free up memory by stopping unnecessary applications or increase the total system RAM. |
| 6090 | SPEED_TEST_TIMEOUT_ERROR | The speed test could not complete within the maximum allowed time limit. |
| 7010 | PERMISSION_MIGRATION_IN_PROGRESS | If the user tries to restart a Permission migration which is still in progress, this error occurs. |
| 7020 | PERMISSION_TRANSLATION_ERROR | Permissions Extraction (1), Permissions Translation (2), and Permissions Apply to Destination Domain (3) are the three steps in permissions-migration. If any errors occur in the Permissions Translation step, this error occurs. |
| 7030 | PERMISSION_APPLY_FAILURE | If any errors occur in the Permissions Application step, this error is returned. |
| 8010 | UPDATE_CMMAGENT_ERROR | Unable to download the latest CMM Installer. |
| 8020 | AGENT_INSTALLER_URL | The Installer URL is invalid. |
| 8030 | AGENT_VERSION_SAVE_FILE | Unable to save upgrade info to a temp file. |
| 8040 | CMM_INSTALLER_EXECUTION | Unable to execute CMM Installer. |
| 9010 | EMPTY_FOLDER_CREATION_FAILURE_ERROR | Error occurred during create empty folders command. |
| 9020 | EMPTY_FOLDER_INVALID_SCAN_RESULT_ERROR | Error occurred when scanning the files during create empty folders command. |
| 9030 | EMPTY_FOLDER_DELETION_ERROR | Problem occurred while deleting empty folders. |
| 9040 | SCAN_SOURCE_AGENT_UNSUPPORTED_VERSION_ERROR | Error if customer is on lower agent version from when this feature is expected. |
| 9050 | SCAN_SOURCE_INVALID_FOLDER_HIERARCHY | This is internal error handling as per implementation mechanism, if unable to create snapshot |
| 9060 | SCAN_SOURCE_FILE_CREATION_ERROR | This is internal error handling as per implementation mechanism, if unable to create file out of snapshot. |
| 9070 | SCAN_SOURCE_FILE_UPLOAD_ERROR | This is internal error handling as per implementation mechanism, if unable to upload snapshot data file. |
| 9080 | FILE_SYNCHRONISE_REVIEW_TRUE_UP_ERROR | The True-up command has been paused because unusual deletions were detected; the user must review and confirm the files scheduled for deletion at the destination before proceeding. |
| 9090 | INACCESSIBLE_PATH_TRUE_UP_ERROR | The True-up command has been paused because one or more source paths are currently inaccessible; the user must review the inaccessible paths and confirm how to proceed. |
| 9100 | SYNC_DELETES_TRUE_UP_ERROR | The True-up command has been paused due to both unusual deletions and inaccessible file paths detected; the user must review and confirm actions for both before proceeding. |
| 9110 | INVALID_SIMULATE_SOURCE_PATH_ERROR | The simulate scan command failed because the provided source path is invalid. |
| 9120 | SIMULATE_SCAN_FAILURE_ERROR | The simulate scan command failed due to an error on the agent side. |
| 9130 | SPLIT_JOBS_ERROR | The simulate scan command failed due to a split job pattern failure. |
| 9140 | VALIDATE_COMMAND_ERROR | The validate command operation failed. |
| 9150 | NON_COMPATIBLE_AGENT_VERSION_FOR_FEATURE | The command is not supported by the current agent version; the agent must be upgraded to the latest version. |
| 50010 | SERVICE_STOPPED_ERROR | Problem occurred while stopping service. |
| 50020 | WEBSOCKET_CONNECTION_ERROR | Problem occurred with web-socket connection. |
| 50030 | MIGRATION_RUNNING_ERROR | Problem occurred while running Data Migration or True-Up command. |
| 50040 | FIREWALL_BLOCKED_ERROR | Firewall preventing Migration App from connecting. |
User Activity
| Status Code | Status code string representation | Description |
| 13 | DOWNLOAD_MIG_JOB_REPORT | Tracks the user activity of downloading a migration job report. |
Have an Idea or Feedback?
For feature requests or suggestions, feel free to submit them on Product Board, and be sure to mention Migration App in the text.
For more complex requests that would benefit from providing screenshots or other attachments, submit them to Egnyte Support. Be sure to include Migration App in the email title. Our Support team will push your comments to the Product team for consideration.