Troubleshooting

This section provides structured troubleshooting steps for common issues.

To troubleshoot any errors or limitations you may encounter, navigate to the relevant section using the navigation panel. Each section outlines the symptoms, possible causes, and recommended resolutions for the issue.

Issue: Platform Password Expired

This guide outlines the steps to resolve a password expiration issue.

Scenario

• Inability to log in to your platform account.

• Receiving a "Password Expired" error message.

Possible Causes

• Your password has reached its expiration date as per security policies.

• For SSO users, your organization's identity provider has a password expiration policy.

Resolution

• For standard users:

  • Utilize the Forgot Password? option on the login screen. A password reset link will be sent to your registered email address.

  • Alternatively, use the Change Your Password feature within your account settings to update your password.

• For SSO users:

  • Contact your platform administrator or IT administration team for assistance with password expiration limitations.

• To prevent future occurrences:

  • If your account settings permit, select the Password Never Expires option to avoid frequent password resets.

Issue: The "Force Login" Screen Appears

Scenario

• The platform displays a "Force Login" screen instead of the standard login page.

• You are unable to access your account due to an active session limit being reached.

Possible Causes

• Improper Sign-Out: You did not properly sign out of a previous session, leaving it active.

• Simultaneous Logins: You are attempting to sign in from multiple browsers or devices at the same time.

Resolution

• Click the Force Login option. This will terminate all your existing sessions.

Please note: You will be required to perform a fresh sign-in to your account after using the "Force Login" option.

Workspace Switching: Common Issues & Solutions

Scenario

• The new workspace does not load after being selected.

• An error message appears when attempting to switch workspaces.

• The workspace dropdown menu is grayed out or not visible.

• The system reverts to the previous workspace after an attempt to switch.

Possible Causes

• Insufficient Permissions: Your user role may not have the necessary permissions to access the selected workspace.

• Network Connectivity Issues: A poor or unstable internet connection could prevent the platform from successfully loading the new workspace data.

• Session-Related Problems: An active, corrupted, or lingering session may be preventing the switch.

• Workspace Configuration Error: The targeted workspace may be temporarily unavailable or improperly configured by an administrator.

Resolution

• Verify Permissions:

  • Confirm that your user profile has the appropriate access rights for the workspace you are trying to switch to. If not, contact your administrator to request access.

• Check Internet Connection:

  • Ensure you have a stable and reliable internet connection. Try refreshing the browser or restarting your network device.

• Clear Cache and Cookies:

  • Clear your browser's cache and cookies to remove any outdated session information that might be interfering with the switch.

• Sign Out and Sign In:

  • Completely sign out of your account, close your browser, and then sign in again to start a new session.

• Contact Support:

  • If the issue persists, the problem may be related to the workspace's configuration. Please contact your system administrator or the support team with details of the error message and the workspace you are trying to access.

Troubleshooting: Empty Pipeline

If you've created a new pipeline but haven't yet added any components or defined a data flow, you may encounter an error message. This guide explains how to resolve this issue.

Scenario

When you attempt to save an empty pipeline by clicking the Update Pipeline icon, the system displays the following error message:

"UI for the current pipeline can't be saved as it is empty"

This message indicates that a pipeline must have at least one component configured and a defined data flow before it can be saved. In the pipeline list, this pipeline will be marked as empty.

Possible Causes:

• The user or pipeline creator has abruptly left the module.

• The user didn't create the sequence of data processing steps for the new pipeline.

Resolution

To resolve this issue and successfully save your pipeline, you must add and configure its components.

1. Add a Component: Drag and drop at least one component from the available palette onto the Pipeline Editor canvas. This component could be a data source, a transformation step, or a destination.

2. Configure the Component: Click on the added component and provide the necessary configuration details (e.g., database credentials, file paths, or transformation logic).

3. Create a Flow: If your pipeline requires more than one component, connect them to establish the data flow.

4. Save the Pipeline: Once you have a configured component and a defined flow, click the Update Pipeline icon. The pipeline will now be saved, and the "empty" status will be removed from the pipeline list.

By following these steps, you can ensure that your pipeline is correctly configured and ready to be saved.