Projects

You may be a member of one or more Melbourne Bioinformatics (formerly VLSCI) projects. These have an alphanumeric identifier such as XYZ1234 and are used for grouping users and jobs that are part of the same Melbourne Bioinformatics grant.

Viewing your project membership

To find which projects you've joined, you first need to log into the Melbourne Bioinformatics account management tool, Karaage.

  1. Go to https://my.vlsci.org.au/.
  2. Log in with your Melbourne Bioinformatics username and password.
  3. From the left navigation menu, click "Projects".
  4. At the right hand side, you will see two tables, one listing the projects you lead or manage, and another listing the projects you've joined.

Default project

One of your projects will be set as your default project.

When you log into a Melbourne Bioinformatics cluster, your home folder will be located in

/vlsci/<default project id>/<your username>

If you submit a job to SLURM and you don't specify a project ID, it will be accounted against your default project.

If you're only part of one project then this is all straightforward, however if you're part of more than one project you sometimes need to take further steps.

Running a job against a specific project

If you wish to assign a specific job to a specific project you can use the '--account'. For example an sbatch script might have:

#SBATCH --account=XYZ1234

If you want the job to be assigned to the XYZ1234 project.

Changing your default project

Implications

Sometimes you might want to change your default project. This will mean:

  • Your home folder location will be different for any subsequent logins. Because your home folder will change, things might seem slightly different when you next connect via ssh, because your new home folder might have different contents in the various 'dotfiles', such as .bashrc, .bash_profile or .profile.

  • Your default group will change to the new project. This will mean that files you create are group owned by the new default group, unless they are created in a directory that has the 'set group ID' bit turned on. Your project(s)' shared folder does:

$ ls -ld /vlsci/XYZ1234/shared
drwxrws--- 27 root XYZ1234 32768 Aug 10 14:20 /vlsci/XYZ1234/shared
      ^
      |
#An 's' here means the 'set group ID' bit is turned on for this directory
  • Any jobs that are run without an explicit '--account' argument will be assigned to the new default project. See here for more information.

Making the change

To change your default project, you first need to log into the Melbourne Bioinformatics account management tool, Karaage.

  1. Go to https://my.vlsci.org.au/.
  2. Log in with your Melbourne Bioinformatics username and password.
  3. From the left navigation menu, click "Accounts".
  4. Click your username in the "Account" column of the "Accounts" table at the right hand side.
  5. At the right hand side, in the "Projects" table you will see a list of all the projects you've joined. For each project, the "Default" column will show a "Make Default" button or the word "Yes". Find the project you wish to have as your new default, and click its "Make Default" button.

That's it! From now on, any time you connect the project you have chosen will be used as your default.

Adding new members to a project

You have the ability to invite new users to any project for which you are a project leader. To invite a new user to a project:

  1. Go to https://my.vlsci.org.au/ and log in using your username and password.
  2. From the left hand menu, click "Projects".
  3. Under "Projects I lead or manage", choose the project to which you wish to invite new users.
  4. Click the "Invite a new user" button.
  5. Enter your invitee's email address and a short message inviting them to join this project.
  6. Click Go.
  7. Repeat steps 4-6 for your remaining invitees.

The new user will be sent an email containing a link to the account creation form. Once they submit the form, you will be asked to approve their request to join your project.

Questions

If you have any problems managing your projects, the Melbourne Bioinformatics team is always able to help.