Changes between Version 7 and Version 8 of BIOS_RSC_production


Ignore:
Timestamp:
Feb 23, 2022 10:02:12 AM (2 years ago)
Author:
Leon Mei
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • BIOS_RSC_production

    v7 v8  
    77Please follow the step-by-step manual below to start working on BBMRIomics datasets. A Code of Conduct document needs to be signed and you can contact [https://psychiatryamsterdam.nl/researcher/jansen-rick/ Rick Jansen] for this. If you have any question, please contact Leon Mei at LUMC.
    88
    9 = Step 1: Configuration of SBS BBMRIomics CO =
     9= Step 1: Request personal budget to for RC =
     10
     11= Step 2: Configuration of SBS BBMRIomics CO =
    1012* After you get invitation to this CO, log into https://sbs.sram.surf.nl/ using your institutional credential (using "Login via SURFconnext") to verify you are a member of SRC-BBMRI CO.
    1113* Optionally if you will need to access the workspace's Linux terminal, you can set up your SSH key in your user profile section.
    1214
    13 = Step 2: Configuration of Researchdrive =
     15= Step 3: Configuration of Researchdrive =
    1416* You will get an invitation email to join Researchdrive. After that, log into https://researchdrive.surfsara.nl using your institutional credential. Choose "Login via SURFconnext". You may get an error message saying "Oops! Your SURF Research Drive account with email address <xxxx> and account <yyyyyy>-lumcnet@lumc.nl could not be found. It seems that you do not have permission to use SURF Research Drive. Please contact the IT department of your institution or data steward of your project to request access to SURF Research Drive.". In this case, please forward this message to Leon Mei to so that he can properly share the datasets.
    1517* You should see a shared folder called "RSC_BIOS". There are three sub-directories: "RP3_data", "RP3_analysis", and "Users". The first two folders are read-only and contains the prepared BBMRIomics data for downstream analysis. In "Users", you will find a personal folder with your name. This is your own personal storage place and you can write to (e.g., to create further directory structure).
    1618* '''Please be aware that there is no backup support of your data stored at Researchdrive, so make sure you arrange proper backup of your scripts and data yourself.'''
    1719
    18 = Step 3: Installation and configuration of authenticator on your mobile phone =
     20= Step 4: Installation and configuration of authenticator on your mobile phone =
    1921* Research Cloud is using a so called Time-based One-time Password authentication (TOTP) for authentication.
    2022* You need to install an authenticator app on your mobile phone, e.g., from [https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2 Google appstore ] or [https://apps.apple.com/us/app/google-authenticator/id388497605 Apple appstore].
    2123* In this authenticator app, you will see a username and a numeric password (that is changing every minute). This username and password are used to log into the R-studio environment.
    2224
    23 = Step 4: Configuration of your account at Research Cloud =
     25= Step 5: Configuration of your account at Research Cloud =
    2426* Log into https://portal.live.surfresearchcloud.nl/ using your institutional credential
    2527* If you don't have budget, you can click "Request a new wallet" to apply for more resources. You can put "SRC-BBMRI" as Subtitle and "EINF-1931" as Existing contract.
    … …  
    3032* Additional documentations about Research Cloud: https://servicedesk.surfsara.nl/wiki/display/WIKI/Research+Cloud+Documentation
    3133
    32 = Step 5: Launch or access a BBMRIomics workspace =
     34= Step 6: Launch or access a BBMRIomics workspace =
    3335* In the main dashboard of Research Cloud, click "Create new workspace" and follow the instructions to configure and start a new workspace.
    3436 * '''And about the expiration date, please try to keep a reasonable timeline. If the VM is running without doing any jobs, it is a waste of our project resource!!!'''
    … …  
    4244}}}
    4345
    44 = Step 6: Manage personal (R) packages =
     46= Step 7: Manage personal (R) packages =
    4547* Some basic R packages are available in the workspace. For other common packages, you could request their installation via Leon Mei or Davy Cats.
    4648* You can also install your own libraries in the running workspace in the persistent storage.
    … …  
    4850* More user documents about the BBMRIomics package can be found at https://bbmri-nl.github.io/BBMRIomics/usage.html
    4951
    50 = (optional) Step 7: ssh access =
     52= (optional) Step 8: ssh access =
    5153For more advanced users who would like to access the terminal of a workspace. You can "ssh <user_name>@<IP>" to the workspace where <user_name> is the same as defined in your authenticator app and the <IP> address is shown in the "Workspace Details". You can "sudo su" to become a sudoer on the workspace in order to install necessary programs.
    5254