1406.0.55.007 - DataLab, User Guide  
Latest ISSUE Released at 11:30 AM (CANBERRA TIME) 25/03/2021  First Issue
   Page tools: Print Print Page Print all pages in this productPrint All

This document was added or updated on 30/07/2021.

New DataLab: logging into the portal and workspace

There are three steps when logging into new DataLab:

  1. Log into the DataLab portal where you can access information and settings related to your profile, project and start your virtual machine (VM)
  2. Activate, then start the VM for your project
  3. Log into the Citrix DataLab workspace where you and your project teams run analyses and produce output for clearance

See also:
First time use/new phone steps
Reset your password

Log into the DataLab portal

Click Sign in on the new DataLab landing page.
Image: new DataLab landing page

If you are logging in for the first time, you will also need to use the First time use/new phone steps.

For returning users, click on your account (firstname.lastname@mydata.abs.gov.au) or Use another account and enter your account name. All DataLab accounts use the @mydata.abs.gov.au domain format. Enter your password and Sign in.
Image: Pick an accountImage: Enter password

By logging in you agree to these conditions:

Important Notice If you are not authorised to access this system, exit immediately. Unauthorised users may be subject to criminal and civil penalties.

This is an Australian Government computer system. Part 10.7 of the Criminal Code Act 1995 outlines the penalties that may apply for unlawful use of Government systems including unauthorised access, modification or impairment of computer systems, data or electronic communications. The Act provides penalties of up to 10 years imprisonment for such offences. By proceeding, you are representing yourself as an authorised user and acknowledge you have read and agree to comply with the Responsible Use of ABS Microdata User Guide. Your activity will logged, monitored and investigated should any misuse be suspected.

Sanctions ranging from a reprimand to revocation of access or termination of employment may be imposed if misuse is determined.

For system security, you need to authenticate your log in using the Microdata Authenticator app on your mobile phone. To set this up, see First time use/new phone steps.

A notification from the Microsoft Authenticator app is sent to your phone for you to approve.
Image: Approve sign in request from the Microsoft Authenticator app

If you don't approve within the time limit, click Send another request to my Microsoft Authenticator app. If the request expires, re-enter your account and password in the DataLab log in screen.
Image: Sent an identity verfication request, we didn't hear from you

You can also change the way you approve the sign in request by selecting Sign in another way.
Image: Sign in another way option

You then have two options:
  1. approve a request on your phone app
  2. use a verification code from your phone app
Image: Verify your identity, using app or code

After you approve in Microsoft Authenticator, you are logged into the new DataLab portal.
Image: DataLab portal landing page

Activate, then start the VM

To enter your DataLab project workspace you need to:
  1. activate your Virtual Machine
  2. start the VM
  3. launch your desktop

Step 1 Activate Virtual Machine

Select the Search virtual machines from the My virtual machines tile, or select the laptop icon from the left navigator. For information about other functions you can do within this tile, see My virtual machines.
Image: Left navigator menu highlighting laptop iconImage: My virtual machines tile, showing search link

Each project has a separate virtual machine. The virtual machine name is your project number followed by random letters, which provide a unique name assigned to your profile. If your machine already shows a green tick in the Active column, skip to step 2 Start the VM. If not, select the Change active VM button. Don't activate a virtual machine when its status is Building. Wait until the status has changed to Ready.
Image: Showing change active VM button

Select the machine you want to activate from the drop down list
Image: Select a VM to activate, drop down list

The Activate VM button becomes active. Select Activate VM.
Image: Activate VM button

Confirm your action by selecting Yes. If you have VM for another project that is currently active, this logs you out of your other session. If you have a program running in your Workspace using another VM, this will stop the program. You can only run multiple VMs if you have requested and are using offline local disk space.
Image: Confirm your action, activate VM

You can track the VM activation progress by either selecting Track from the pop up notification or the i icon on the left navigator.
Image: Track VM activation progress

When the VM activation completes, a message confirms that the action was successful. If the action fails, repeat the above steps to activate.
Image: Activation status succeeded

If you navigated to the Action Log page, select the laptop icon in the left navigator to return to the My Virtual Machines page.
Image: Return to My Virtual Machines page

Step 2 Start the VM

From the My Virtual Machines page, click on the VM name that is connected to the project you want to work on to view specific settings for this virtual machine. For information about other functions you can do within this tile, see Functions in My virtual machines.
Image: My Virtual Machines, selecting VM name link

The workflow diagram at the top of the page shows you have activated the virtual machine (step 1) You now need to start this machine (step 2).
Image: highlighting Steps to launch this VM

In the Power State box, select Start VM, and confirm.
Image: select Start VMImage: Confirm selection

You can track the Start VM progress in the Action Log by either selecting track, from the pop up notification or the i icon in the left navigator.
image: Track Start VM progress

Step 3 Launch the desktop

Starting the VM takes several minutes. If you try to access your workspace too early you will not see your virtual machine in the DataLab Workspace. When it has completed, the status changes from In progress to Succeeded. If the action fails, repeat the steps to Start the VM.
Image: Action log status In Progress

Use your browser's back arrow to return to the VM specific page, or navigate to the specific VM page described in Start the VM.
Image: use back button to return to specific VM screen

You are now at step 3 of the VM workflow diagram. Launch the desktop using the link Go to the DataLab Workspace. This opens the Citrix Workspace application.
Image: Launch the desktop Go to the DataLab Workspace

Log into Citrix DataLab Workspace

When you click on Go to the DataLab Workspace, the application Citrix Workspace opens. The first time Citrix opens, click Detect Workspace in the pop up message.
Image: Detect workspace

If you receive an error instead of launching the Citrix Workspace application, you need to download the Citrix receiver application to your device. The latest version of Citrix Workspace is available at https://www.citrix.com/en-au/downloads/workspace-app/windows/.
Image: Citrix error

Select Open Citrix Workspace Launcher.
Image: Open citrix workspace launcher

For first time users, Citrix provides a tour of the system and its features. If you do not want to take the tour, select maybe later.
Image: Citrix tour

If you want to take the tour later, you can access this feature by clicking on the arrow button at the bottom right corner of the screen.
Image: Arrow icon to Citrix resource centre

The Citrix dashboard shows your applications and your recently used desktops. If you do not see any desktops under Recent select the Desktops option in the left navigator. Desktop is the Citrix term for virtual machine.
Image: Citrix dashboard

From the All Desktops view, click the virtual machine/Desktop (this is your project number) to open your project in the DataLab environment.
Image: Open your project desktop

This may prompt a script asking if you want to Open or Save the application. Choose Open.
Image: Open the application

It may take a few minutes for Citrix to connect to your DataLab desktop. When completed, your DataLab workspace launches.
Image: Connecting to DataLab desktopImage: Welcome to the DataLab!

Log in using the same credentials you used to log into the DataLab Portal. Once logged in, the system may take a few minutes to load as it prepares Windows.
Image: DataLab workspace log in

As part of the conditions of use, all activity within the workspace is recorded for auditing and reporting purposes.
Image: Workspace is recorded message

Your DataLab workspace looks like this. See Using your workspace.
Image: Citrix DataLab workspace

First time use/new phone steps

New DataLab uses two factor authentication to provide a secure log in environment. You need to download the Microsoft Authenticator application to your smart phone to use the DataLab.

Open https://new.datalab.abs.gov.au (the temporary url while projects are migrating) and click Sign in.

The first time you log in, enter the user name and password provided to you by us. If you are using a new phone, continue to use your existing credentials. All DataLab accounts use the @mydata.abs.gov.au domain format.
Image: Sign in with conditions of useImage: Enter password

In Additional security verification, choose Mobile app from the drop-down menu, and Receive notifications for verification. Click the Set up button.
Image: Additional security verification contact selection

A pop-up appears with 3 steps on how to link your new DataLab account to the Microsoft Authenticator app.
Image: Configure mobile app with QR code

Step 1. Download the Microsoft Authenticator application to your smart phone from the App Store (for iOS) or Google Play (for Android).
Image: Download the Microsoft Authenticator from Apple and Google Play

Step 2. Open the app and create a Work or school account.
Image: Add work or school account

Step 3. Select Scan the QR code.
Image: Select scan QR code

The QR code appears on your screen, scan this with your phone.
Image: QR code being scanned

Click Next in your browser, which returns you to the Additional security verification screen. Select Next again.
Image: Configure mobile app steps, next
Image: Additional securityu verification contact selection

The Additional Security Verification sends a notification to your phone.
Image: Additional security verification contacting phone

From your phone, review the request, Approve sign-in? Choose Approve.
Image: Approve sign in? Approve button

The web page is refreshed. Click Done, then Next to enter more information.
Image: Additional security verification successful
Image: More information required, next button

Now it's time to set up a new password for your account. Your password cannot contain your user ID. It must be a minimum of 8 characters and contain at least three of the following:
  • upper-case letters A – Z
  • lower-case letters a - z
  • numbers
  • special characters @ # $ % ^ & * - _ ! + = [ ] { } | \ : ' , . ? / ` ~ " ( ) ;
Image: Update your password current, new

To make sure you can reset your password in the future, you also need to set up an authentication phone and/or email.
  • You need to set up at least one in order to proceed.
  • Click Set it up now beside your chosen option.
Image: Don't lose access to your account configuring authentication

Authentication by phone: the system verifies your phone by the option you select.
Image: Select country and enter phone number

Select the country or region you are registering in from the drop down menu, then enter your mobile number.
Image: Select text or call me

Once your phone number is entered, choose between receiving a text or a call to activate the verify button. The text option sends a verification code to your phone. Enter the code then select verify. The call option sends you an automated phone call that will ask you to press the # key to verify.
Image: Enter verification code sent to phone

Authentication by email. Enter an email address to activate the email me button.
Image: Enter authentication email

A verification code is emailed to you. Enter the verification code and select verify. Once you have set up your details, select Finish to return to new DataLab sign in.
Image: Enter authentication code
Image: Confirmation of phone and email

Reset your password

If you forget your password select the Forgot my password link.
Image: Enter password with Forgot my password link

Your user ID is populated for you. Enter the characters in the picture, or words in the audio. Click Next.
Image: Enter email and on screen code or audio code

The next screen takes you to Step One of verifying your account. Choose from the options in the left-hand column (options available depend on what you chose during your original account set up process).
Image: Verification using text to phone

Verify your account information via email, text, or call (whichever you chose), and follow the prompts to reset your password. The screen below displays when your password has been reset. Click the link to sign in with your new password.
Image: Password has been reset confirmation

Back to top of the page