Datalore 2024.2 Help

Emergency maintenance

Enable administrative access

To enable administrative API for your Datalore instance, generate a token by providing this environment variable.

Read further for a few procedures that may help you when Datalore functionality deviates from the expected.

Set up user access level

Normally, a Datalore instance is operated by its administrators. The first registered user of the instance is automatically assigned a super admin and can then can grant admin roles to other users.

This procedure explains how to reset access to the super admin account if it was accidentally lost.

  1. Identify the ID of the user whose access level you want to alter:

    • Open the developer console for the Datalore browser tab.

    • Find the entry that contains the user=.... part. The value that follows the = character is the ID of the currently authenticated user. Here is an example of what this line looks like:

      Client initialized clientId=i9amcJvpqBDoKAWbVc2iOs, user=bKscUiyhbxUNl6a5tTlKq4
  2. Execute the following HTTP request by providing your own values as per the table below:

    curl --request POST \ --url 'https://${host}/api/user_management/v1/admin/user/role?userId=${userId}&role=${role}' \ --header 'Authorization: ${token}'

    ${host}

    Your instance FQDN

    ${role}

    The role you want ti assign to the user. See User types and roles for allowed values.

    ${token}

    Administrative API token

Workspace full clone

When you export a workspace as described in this procedure, the downloaded .zip file will not contain any sensitive information like database connection objects.

However, there can be a situation where you need to copy another user's workspace with all of its contents (including all the attached files and database connections). For example, that user left the company, and you can no longer administer their workspaces.

  • Execute the following HTTP request by providing your own values as per the table below:

    curl --request POST \ --url 'https://${host}/api/admin/vfs/clone_workspace/${ownerId}/${workspaceId}?destinationUserId=${destinationUserId} \ --header 'Authorization: ${token}'

    ${host}

    Your instance FQDN

    ${ownerId}

    The workspace owner user ID>

    ${workspaceId}

    Workspace ID

    ${destinationUserId}

    User ID, who this workspace should be cloned to.

    ${token}

    Administrative API token

Emergency recovery

There might be a situation where a full system recovery is necessary, for example, if Datalore's database or internal storage were corrupted.

In this case, we advise that you restore Datalore from backup, provided that it was configured previously. If that is not possible, please, contact our support team for further guidance.

Last modified: 17 May 2024