The DDS Test instance

Welcome, and thank you for your interest in testing the Data Delivery System.

This page will give you information on:

Target audience

This page targets any users invited to the testing instance of the Data Delivery System. If you have an account on the production instead (https://delivery.scilifelab.se), please read the documentation here here.

1. Important information for SciLifeLab Units

Note

If your testing account has the role “Researcher”, you can skip this section.

  • First and foremost, this is not a production instance and will get releases without warning. No sensitive data is allowed to be delivered within this instance.

  • In order to create projects, which is required in order to test the upload / download functionality:

    • You must have the account role “Unit Admin” or “Unit Personnel”

    • Your unit must have at least two “Unit Admins”

  • When listing your projects you will see your projects, and yours only. However, in order to not create a large number of separate storage locations for testing purposes, the actual storage location is shared by all units in the test setup. In the production instance, there’s always a separate storage location per SciLifeLab unit.

  • The storage quota (maximum data volume that can be uploaded in total by all units) for the testing instance is currently set to 5 TB. However, if you receive an error message indicating that the quota is met, contact delivery@scilifelab.se and we will solve this for you.

  • Within the testing instance of the DDS, all units have the following settings:

    • days_in_available: 7 days.

      Explanation: When data has been uploaded to a project, and the data has been released (the project status has been set to “Available”), the data will be available for download for 7 days. After this, the project will automatically transition to the status “Expired”.

    • days_in_expired: 3 days

      Explanation: When a project has transitioned to the status “Expired”, the project data will be kept for 3 days. During this time you can release the project data again (checkout the dds project status command) and transition the status to “Available” again. If you do not, your project will be automatically archived (project status will be changed to “Archived”), and your data will be permanently deleted.

    Note

    • These statuses are described in the technical overview, located on the DDS testing web page mentioned above.

    • The short number of days is only for the test instance, making it easier for you (and us) to test that the statuses work as they should.

  • Keep in mind that the testing instance is where we try out new features etc. There may be some unexpected redeployments and there may be bugs in new features.

2. Where the DDS Test Instance is located

  • The testing instance is located at https://testing.delivery.scilifelab.se/

  • Just like on the production site, you can find the following information on that page:

    • Documentation, which points to the Welcome page in the navigation field to the left.

    • Technical overview

    • Troubleshooting guide

3. How to install the CLI

Install the CLI as described in the installation guide.

Note

Rarely, backwards incompatible releases will break the integration between the CLI and the API. As we release the web application to test during the development process, there can be small windows of time where the production CLI is not compatible with the DDS instance deployed to test.

These windows of time will be kept as small as possible and we will notify test users.

4. How to configure the test version of the CLI

After installing the CLI, you need to complete the following steps before you can start using it:

  1. Set the CLI to point to the test instance by running the following command in the terminal / command prompt / PowerShell (depending on your OS, see below)

    # Linux / MacOS
export DDS_CLI_ENV="test-instance"

# Windows Command Prompt
set DDS_CLI_ENV=test-instance

# Windows PowerShell
$env:DDS_CLI_ENV = 'test-instance'

  2. Verify that the output of the following command contains https://testing.delivery.scilifelab.se/ and not https://delivery.scilifelab.se/

    dds --version

Experiencing issues? Contact us!

Email us at delivery@scilifelab.se if you need help or have any questions or feature requests. Start the email subject with DDS Testing.