Connecting to SRB BIRN

From MIPAV
Revision as of 18:47, 10 February 2012 by Angelfish100 (Talk)

Jump to: navigation, search

Connecting to SRB BIRN

In this chapter . . .

  • "Requesting the SRB account"
  • "Setting MIPAV SRB options and opening files"
  • "Setting the SRB connection parameters"
  • "Uploading files to SRB BIRN"
  • "Transferring files from MIPAV to SRB BIRN and vise versa"
  • "Set up the NDAR pipeline"
  • "Saving files to SRB"

Biomedical Informatics Research Network(BIRN, http://www.nbirn.net/) is a shared biomedical IT infrastructure supported by NIH, which hastens the process of new understanding and treatment of disease through use of distributed knowledge. BIRN supports collaboration between groups with different expertise and resources (e.g., technical, scientific, social and political). The Storage Resource Broker (SRB), developed at SDSC, is a client-server middleware designed for managing file collections in a heterogeneous, distributed environment. All files within the environment are part of a single data grid BIRN file system where a file's logical location within the file system is represented independently of its physical location. The SRB middleware is capable of managing large data sets and is currently managing the BIRN data grid.

Get Connected to SRB BIRN

To be able to connect to SRB BIRN from inside MIPAV and open the image files using SRB you need to:

1 Obtain a SRB user account and/or NDAR portal user account, see Section "Requesting the SRB account"
2 Set up the MIPAV SRB options, see Section "Setting MIPAV SRB options and opening files"
3 Set up the SRB connection parameters, see Section "Setting the SRB connection parameters"
4 Upload your files to the SRB BIRN (optional), see Section "Uploading files to SRB BIRN" .

Requesting the SRB account

Before connecting to SRB BIRN from inside MIPAV, you should obtain the user account to the NDAR portal, first. In order to do that, connect to the portal using the following link:
Then, open the Request an Account tab and follow the instructions provided by the tab. Refer to Figure 1.
After your request has been approved, you should receive the confirmation email from the NIH help desk. This email should contain your username and instructions on how to log in to the NDAR portal. At that time, log in to the NDAR portal, enter your email address that you entered in the account request, and create your password. Once you have done creating your password, you can log in to the NDAR portal using the username provided in the helpdesk email and the password you just created. [#1260786 1]
Figure 1. NDAR portal, requesting a user account.

NDARSRB Account.jpg


Setting MIPAV SRB options and opening files

To set up the MIPAV SRB options:

1 Open MIPAV;
2 Call Help>MIPAV Options menu;
3 In the MIPAV options dialog box that appears, navigate to the SRB tab. See Figure 2
4 Complete the following tab options:
Jargon version: a version of Jargon API library, which should be used to communicate to the SRB server. Select one from the list;
Transfer Mode (parallel or sequential) - specify the file transfer protocol. There are SRB parallel transfer protocol and SRB sequential transfer protocol available;
Temporary Directory is your local directory, where you keep your files which need to be transferred FROM or TO the SRB server.
Figure 2. The MIPAV options dialog - SRB options tab.

MIPAV optionsSRB Tab.jpg


Setting the SRB connection parameters

The connection parameters that must be used to connect to SRB BIRN from inside MIPAV are slightly different from the parameters which you used to connect to the NDAR portal. To obtain these parameters,

1 From the NDAR portal page, navigate to the Data Management tab;
2 Click the GridInfo icon. See [MIPAV_ConnectingToSRBBIRN.html#1261189 Figure 97];
3 The info page appears displaying different sets of parameters;
4 You need those which appear under General SRB User Parameter;
5 Open MIPAV, and then call File>SRB BIRN>Open Image from SRB;
6 The Connect to dialog box appears;
7 Enter parameters from General SRB User Parameter into the dialog box. Refer to [MIPAV_ConnectingToSRBBIRN.html#1260927 Figure 95];
8 In the Authentication list box, select ENCRIPT1;
9 Press Connect, to connect to SRB server. The SRB File Chooser dialog should appear displaying the list of catalogs.
10 Open the desired catalog and select a file of interest. Press Open to open the file. See [MIPAV_ConnectingToSRBBIRN.html#1261090 Figure 96].
11 The file now should be opened in MIPAV.
Figure 95. Parameters used to connect to SRB BIRN from inside MIPAV.


{| align="center"

SRB GeneralUserParameters.jpg



|}


As shown in [MIPAV_ConnectingToSRBBIRN.html#1260927 Figure 95] the following parameters are used to connect to SRB:

General SRB User Parameter
MIPAV
Host
Host
Port
Port
User Name
Name
Home Directory
Â
user Domain
Domain
Default Resource
Storage Resource

Figure 96. The SRB FIle Chooser dialog box.


{| align="center"

SRB fileChooser.jpg



|}


Uploading files to SRB BIRN

To test your access to SRB BIRN from inside MIPAV, you might choose to upload a couple of files to your home catalog, first. In order to do that,

1 From the NDAR portal page, navigate to the Data Management tab;
2 Navigate to the Upload File box;
3 Use the Browse button to select a file for upload;
4 Then, click Upload File;
5 The file should appear under SRB File/Folder List. See [MIPAV_ConnectingToSRBBIRN.html#1261189 Figure 97].

Later, you can upload your image files to SRB BIRN from MIPAV using the SRB Transfer and Save to SRB menus.

Figure 97. Uploading files to the NDAR portal.


{| align="center"

SRB Uploadingfile.jpg



|}


Transferring files from MIPAV to SRB BIRN and vise versa

To transfer files from MIPAV to SRB BIRN and back to MIPAV:

1 Use the MIPAV File>SRB BIRN>Open Image from SRB menu to connect to SRB BIRN;
2 Call File> SRB BIRN > SRB Transfer menu;
3 In the Transfer Files dialog box that appears, use the list boxes to specify the Source and Target directory (SRB and your local directory). Then, use the Browse buttons to select files and catalogs.
4 Press Transfer to send files. Or press Cancel to cancel. See [MIPAV_ConnectingToSRBBIRN.html#1261217 Figure 98].
Figure 98. Transferring files between SRB BIRN and MIPAV.


{| align="center"

SRBTransferFiles.jpg



|}


Set up the NDAR pipeline

You can run MIPAV scripts on the DICOM images stored on the DICOM server and automatically save results to the chosen SRB BIRN catalogue.

Figure 99. Running MIPAV scripts on the DICOM images and saving results to the SRB BIRN.


{| align="center"

Schema1.jpg



|}