Managing projects
How to view, create, and update new and existing projects. How to clone and close projects, and assigning and removing users from projects
Searching for existing projects
From the ‘Projects’ page you can view all projects created in the SEAD environment. Start by selecting the ‘Projects’ tab from the left side navigation panel.
Fig. 1. Projects tab
You will be presented with the 'Project' page which showcases all projects in the SEADpod along with basic details such as their start and end dates, status, and a brief project description. You can adjust the filters (circled blue) to search for a specific project based on various criteria. You can also download a CSV report of all the listed projects by clicking ‘Export’ (circled red).
Fig. 2. Projects page
Selecting a project ID (circled black in Fig. 2.) will open the project’s page where you can view more detailed information about the project.
Fig. 3. Project specific page
Note: The ‘Lead Researcher’ is the key contact person for the project, they do not receive a VM. However, if a VM is required they can be added as a user to the project.
Creating new projects
Project administrators can create new projects. Select on the ‘New Project’ button presented on the middle of the ‘Projects’ page.
Fig. 1. ‘New Project’ button
You will be directed to the ‘New Project’ form. The form contains four pages of required information: Basic, Users, Products, and Review. Administrators should create the required users (refer to Registering new users) and products (refer to Creating products) before beginning this step. After populating each page, select ‘Next’ on the bottom right of the project form. To return to a previous page, select the ‘Back’ button.
NOTE: Your Project ID should begin with your three letter (lowercase) SEADpod identifier (refer to Fig. 2.), followed by up to five digits for your remaining numerical identifiers of choice (e.g. abc12345).
Fig. 2. SEADpod Identifier location
Fig. 3. 'New Project' Form
Note: The project ‘End-date’ is for management information only and does not impact user access post end-date.
After progressing through the ‘New Project’ form, select the ‘Finish’ button that is now presented on the bottom right of your screen.
Fig. 4. New project finish button
You will be asked to confirm the action. If creating the project is your intention, proceed by selecting ‘Yes’.
Fig. 5. New project confirmation
The system will begin to create your new project, this may take up to 5 minutes to complete. You can view the progress of the task via the ‘Action Log’.
Fig. 6. Task action log
Note: Project folders are backed up each night and retained for 14 days. Datalake containers are not backed up.
Updating projects
Project administrators can modify a range of information about a project, including the default virtual machine size and storage limits. To edit the information about a project, from the Project page locate the project you are wanting to edit and select the hyperlinked project ID to access the project information page.
Fig. 1. Projects page hyperlink
Select the ‘Edit’ button at the top of your screen.
Fig. 2. Edit Project button
This opens the ‘Update Project’ page where you can modify the project details. After making your updates, select ‘Save’ to apply these changes.
Fig. 3. 'Update Project' page
Assigning users to a project
Project administrators can assign users to projects. Assigning users to projects provides them with access to a VM. After assigning a user to a VM, the user will be required to build their VM before it can be accessed. Administrators can also initiate the VM build process on the users behalf.
From the project page, navigate to the project’s information page by selecting the hyperlinked project ID.
Next, select the ‘Assign Users’ button at the top of the project page.
Fig. 1. ‘Assign Users’ button
This opens the ‘Assign User’ page, where the VM size (circled red), VM type (circled blue) and VM version (circled yellow) can be selected. Click the (?) icon next to each of these menus (circled green) for more information about the available sizes and types of machines available. A single users or multiple users can be added to the project by selecting their account(s) from this page (circled black).
Note: The appropriate virtual machine size will depend on the needs of the user and the broader project requirements (e.g. whether SAS is needed, the number and complexity of the data files the user will be working with, etc.).
Fig. 2. Assigning users drop menu
Once you have selected the user and the appropriate virtual machine size and type, click the ‘Assign User(s)’ button at the bottom of the page to add the user account(s) to the project.
Fig. 3. ‘Assign User(s)’ button
Removing users from a project
Removing a user from a single project
Project administrators can remove a user from a project. From the project page, navigate to the project’s information page by selecting the hyperlinked project ID.
To remove a user from a project, select the ‘Remove Users’ button at the top of the specific project page.
Fig. 1. ‘Remove Users’ button
You will be presented with a drop-down menu where you can select the user(s) you want to remove from the project. Multiple users can be selected. Once you’ve selected the user(s), select the ‘Remove Users’ button below to detach the selected user(s) from the project.
Fig. 2. User removal drop menu
Once you have selected ‘Remove Users’, you will be asked to confirm the action. If removing the user is your intention, proceed by selecting ‘Yes’.
Fig. 3. Remove user confirmation
Removing a user from all projects
Project administrators can remove users from all projects. A user must be removed from all projects before they can be evicted from the system. To do this, navigate to the ‘Users’ page from the left navigation panel.
Fig. 4. Users navigation button
Locate the user from the existing list, or search for them using the search bar and selecting the hyperlinked username which will direct you to that specific user’s information page.
Fig. 5. Open user profile
To remove the user from all projects, select the ‘Remove From All Projects’ button at the top of the page.
Fig. 6. 'Remove From All Projects' button
After selecting ‘Remove From All Projects’, you will be asked to confirm the action. If removing the user from all projects is your intention, proceed by selecting ‘Yes’.
Fig. 7. Remove user from all projects confirmation
Closing projects
Project administrators can close projects. From the Project page locate the project you are wanting to close and select the hyperlinked project ID to access the project information page.
Fig. 1. Project page hyperlink
On the project’s information page, select the ‘More…’ button (circled red) at the top of the page and from the drop-down select ‘Close Project’. Ensure users on the project have requested clearance of all necessary files/data from their project before closure.
Fig. 2. ‘Close Project’ button
You will be asked to confirm the action. If closing the project is your intention proceed by clicking ‘Yes’.
Fig. 3. Project closure confirmation
Note: Closed projects data will be archived after 30 days from their closed date and will remain visible in Azure Storage Explorer during this time. After the 30 days, data from P: (Project) and O: (Output) file shares will be moved from the project's storage account to a dedicated archive storage account. The project's storage account will then be deleted, and the project's status will be updated to “Archived”.
The ability to restore a project will no longer be available in the web portal after the 30 days grace period. However, ABS System Administrators can restore archived data at a cost. Databricks Blob Storage will not be archived. To request the restoration of project data contact sead.support@abs.gov.au.
Cloning projects
Project administrators can create a new project based on an existing project by cloning the details and contents to the new project, saving time and effort. To clone a project, from the Project page locate the project you are wanting to edit and select the hyperlinked project ID to access the project information page.
Select the ‘More…’ button (circled red) at the top of the page and select ‘Copy details to a new Project’.
Fig. 1. ‘Copy details to a new Project’ button
You will be directed to the ‘new project form’ which will be pre-filled with the existing project’s details. You will be required to update the project ID, as the clone is a copy of an existing project, not a replacement. After progressing through the new project form, click on the ‘Finish’ button presented on the bottom of your screen.
You will be asked to confirm the action. If creating the project is your intention, proceed by clicking ‘Yes’.
The system will then begin to create the cloned project. This may take up to 10-20 minutes to complete. You can view the progress of the task via the ‘Action Log’.