Troubleshooting

If you are redirected back to login repeatedly, your session may have expired. Sign in again.

If you see a First login prompt, you must set a new strong password before continuing. See Password Management for details.

If login fails with "Invalid credentials", double-check your username and password. After multiple failed attempts, your account may be temporarily locked — contact an administrator.

If you see a server error on login (e.g., "Server is unavailable"), the backend may be down or unreachable. Wait a moment and retry, or contact your system administrator.

Sessions expire after a period of inactivity. When this happens, the UI redirects you to the login page.

Any unsaved changes will be lost when the session expires. Save your work frequently.

After re-login, you will need to navigate back to the module you were working in.

Dry-run fails: Fix the reported errors in your import file, then rerun dry-run. The UI shows specific error messages for each problematic entry.

REPLACE warnings: Confirm you are using the correct file and client type before applying. REPLACE mode may delete entries missing from the upload.

File format errors: Ensure your import file matches the expected format for the module (.properties, .xml, .json, .yml, or .zip depending on the module).

Large file imports: Very large import files may take longer to process. Do not close or navigate away from the page during import.

"Value must be numeric" (FCC Config): The value field only accepts numeric values. Remove any non-numeric characters.

"Template XML is not well-formed" (Hardcoded Event): Your XML content has syntax errors. Check for unclosed tags, missing quotes, or invalid characters.

"Body must be valid JSON" (Set Parameter Result Template): Ensure your JSON body is syntactically correct. Use a JSON validator if needed.

"Key already exists": The entry key must be unique within the module. Use a different key or edit the existing entry.

"Password does not meet requirements": New passwords must be 6-16 characters and include at least one lowercase letter, uppercase letter, digit, and special character (@$!%*?&).

If pages do not load or actions fail, confirm the backend is reachable and your environment is correct.

HTTP 401 (Unauthorized): Your session has expired. Re-login to continue.

HTTP 403 (Forbidden): You do not have permission for this action. Check your role.

HTTP 404 (Not Found): The requested resource does not exist. It may have been deleted by another user.

HTTP 409 (Conflict): The resource was modified by another user. Refresh the page and retry.

HTTP 500 (Internal Server Error): A server-side error occurred. Contact your system administrator if the issue persists.

If the issue is intermittent, export a snapshot and stop changes until stability is restored.

Cannot set a new password: Ensure it meets all requirements (6-16 chars, mixed case, digit, special character). Avoid common words like "password", "qwerty", or "admin".

"Password reuse not allowed": You cannot set the same password you previously used. Choose a different password.

Caps Lock warning: The UI shows a Caps Lock indicator on password fields. Check that Caps Lock is off.

See Password Management for full details.