/01-user-guide.html This guide provides an overview of the Australian Dataspace Testbed Platform, covering essential topics to help you navigate and utilise its features effectively. Designed for developers and users, this guide walks you through everything from provisioning basic dataspace testbeds to managing your dataspace environments. Table of Contents Name Purpose 1.1 The Basics Understand platform fundamentals and essential terminology 1.2 User Dashboard Navigate the user dashboard and access key features 1.3 SSH Keys Generate and configure SSH keys for secure testbed access 1.4 Creating a Dataspace Launch and configure new dataspace environments 1.5 Connecting to a Dataspace Access your dataspace using multiple connection methods 1.6 Managing your Dataspace Modify dataspace settings and resource allocation Hugo en-us /01-user-guide/01-basics.html Mon, 01 Jan 0001 00:00:00 +0000 /01-user-guide/01-basics.html This platform provides developers with an on-demand web portal to launch dataspace testbed environments and dataspace components in minutes. Without any cloud infrastructure experience, developers can access this self-serve portal to launch complex cloud infrastructure to host dataspace testbeds and components. The platform is setup to make managing cost and security effortless for developers, so that focus can remain on the development and testing of dataspaces. Key platform terminologies Dataspaces: A dataspace is digital infrastructure that enables data transactions between various users, based on governance framework defined within that dataspace. It is used for securely sharing restricted access data. In this platform, each deployed dataspace is a repeatable environment that come pre-configured with a templatable dataspace testbed or component. Each environment comes pre-installed with software packages required for the hosting and development of the chosen component. /01-user-guide/02-dashboard.html Mon, 01 Jan 0001 00:00:00 +0000 /01-user-guide/02-dashboard.html After logging in, you will first be greeted with the user Dashboard. From here, you can view important announcements, see new features, and get an overview of your utilised and remaining credits. Announcements: This section will update with any important platform announcements. Please keep an eye on this as you continue to use the platform. My Projects: This section shows your project’s consumed and remaining credits. This section will appear once for each project you are a part of. /01-user-guide/04-using-ssh-keys.html Mon, 01 Jan 0001 00:00:00 +0000 /01-user-guide/04-using-ssh-keys.html SSH Key pairs are used for establishing secure connections to dataspace environments. Key pairs consist of two parts, the private key and the public key. The private key is stored on your personal device and is used as an ‘access key’ to login to your environment. The public key is stored on the platform’s infrastructure and is used to identify its matching private key when making a connection request. You can think of the private key as a regular household key, and the public key as a household lock. /01-user-guide/05-how-to-create-vm.html Mon, 01 Jan 0001 00:00:00 +0000 /01-user-guide/05-how-to-create-vm.html You can follow these steps to create a new dataspace testbed on the platform. Navigate to the Dataspaces function of the platform using the navigation menu on the left. Next, select the Create Dataspace button. You will be presented with a list of available dataspace testbeds and components. Selecting a dataspace will determine the operating system and software packages available in your new dataspace. Select the dataspace type you require or contact the team if you require help selecting an appropriate dataspace type. /01-user-guide/06-how-to-conn-vm.html Mon, 01 Jan 0001 00:00:00 +0000 /01-user-guide/06-how-to-conn-vm.html Details If you have just completed ‘Creating a Dataspace’, proceed to step 2. Login to the Platform, and select the ‘Dataspaces’ option from the left menu. Locate the dataspace you want to connect to. If the dataspace is not currently running, select the “Start” button. There are a few different ways you can connect to your instance. Below is a summary of supported connection protocols: Protocol Description/Use Case Secure Shell (SSH) This connection type allows you to connect to and issue terminal commands to the underlying Linux-based machine hosting the dataspace, similar to using a supercomputing facility or remote Linux-based workstation. Amazon Desktop Cloud Visualization (DCV) Amazon DCV is a high-performance remote display protocol similar to RDP that allows users to run graphics-intensive applications remotely with minimal latency. Web Access (HTTPS) The web access protocol is supported by testbed workspaces, and allows users to access the dataspace UI hosted on their environments HTTPS port directly. Note: If using the default demonstration environment, this page will not perform any functions. IDE Access (VSCode Server) Each testbed workspace has code-server pre-installed and running, providing developers with an easy way to develop their dataspace components straight in the web browser. Heads up! When using browser connection methods (DCV Browser, HTTPS or IDE), your browser will alert you that the connection is not private. Please choose “visit this website” to continue. /01-user-guide/07-how-to-configure-workspace.html Mon, 01 Jan 0001 00:00:00 +0000 /01-user-guide/07-how-to-configure-workspace.html There are a range of options presented to you on each provisioned dataspace environment within the platform. Below are some of the common functions available to you and how you can use them. Starting/Stopping a dataspace Selecting the start or stop button is like turning your home computer on and off. Your machine will shutdown, but your data will remain for next time you want to use it. Start a dataspace Stop a dataspace Terminating (Deleting) a dataspace Terminating your dataspace will shut down the machine and destroy all data stored on it’s drives.