Managing projects

SEAD administrators instruction guide

How to view, create, and update new and existing projects. How to clone and close projects, and assigning and removing users from projects

Released
13/05/2024
Release date and time
13/05/2024 11:30am AEST

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.

projects tab

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).

projects page

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.

project specific page

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.

new project button

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).

pod identifier

Fig. 2. SEADpod Identifier location

New project form

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.

finish button

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’.

project confirmation

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’.

task 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.

project ID link

Fig. 1. Projects page hyperlink

Select the ‘Edit’ button at the top of your screen.

edit button

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.

Project update page

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.

assign users button

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.).

assign users drop-down

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.

assign users button

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.

'Remove users' button

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.

remove users dropdown

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’.

Remove user confirmation

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.

Users navigation button

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.

Search for users and users hyperlink

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.

remove user from all projects button

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’.

remove user from all projects confirmation

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.

Project page hyperlink

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.

close project button

Fig. 2. ‘Close Project’ button

You will be asked to confirm the action. If closing the project is your intention proceed by clicking ‘Yes’.

Close Projects Confirmation

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’.

clone project button

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’.

Back to top of the page