Setting up Secure File Transfer Protocol (SFTP)
By default, the File Repository Cell uses SOAP to transfer files in i2b2. If you prefer your admin user transfer files directly via SFTP you will need to take the following steps.
| indent |
|---|
|
Step 1: Enter cell parameters in i2b2 Administration Module |
| indent |
|---|
|
Step 2: Create an FRC directory |
Step 1: Enter Cell Parameters in i2b2 Admin
The first step in setting up the File Repository to use SFTP is to enter a few parameters on the File Repository cell. These cell parameters will define the Method, Host and Port to be used when transferring files.
Parameter Name | Values | Required | Description |
|---|
FRMethod | SFTP or local | Yes | Defines the method to be used when retrieving files |
FRHost | Name of your JBoss Server | Yes | The name of the machine where JBoss is installed |
FRPort | Example: 22 | No | The port to be used when retrieving files |
Steps to Add Parameters to File Repository Cell
| Excerpt Include |
|---|
| NIGW:14.4.2.1 Add Cell Parameters |
|---|
| NIGW:14.4.2.1 Add Cell Parameters |
|---|
| nopanel | true |
|---|
|
| indent |
|---|
|
6. Enter the following parameter to define the method of transfer. |
| indent |
|---|
|
Parameter Name: FRMethod |
| indent |
|---|
|
Parameter Value: SFTP or local |
| indent |
|---|
|
Parameter Data Type: Text |
| Note |
|---|
|
If the CRC is on the same JBoss as the File Repository then you will want to set the FRMethod to local. This will prevent the CRC Loader from accessing the File Repository via a web service call, which will result in faster responses. |
| indent |
|---|
|
7. Click on Save to save the new parameter. |
| indent |
|---|
|
8. The Parameters List page will display with the new parameter. |
| Info |
|---|
|
The Navigation panel will not automatically refresh to display the new parameter. If you wish to update the list in the Navigation panel you can click on Params and it will refresh the hierarchical tree. |
| indent |
|---|
|
9. In the Parameters List page click on Add New Parameter to enter another parameter. |
| indent |
|---|
|
10. Enter the following parameter for the name of the machine where your JBoss resides. |
| indent |
|---|
|
Parameter Name: FRHost |
| indent |
|---|
|
Parameter Value: Machine_Name_Where_JBoss_Resides |
| indent |
|---|
|
Parameter Data Type: Text |
| indent |
|---|
|
11. Click on Save to save the new parameter. |
| indent |
|---|
|
12. In the Parameters List page click on Add New Parameter to enter another parameter. |
| indent |
|---|
|
13. Enter the following parameter for the port to be used by the FRC to connect. This parameter is optional. The value is usually set to 22. |
| indent |
|---|
|
Parameter Name: FRPort |
| indent |
|---|
|
Parameter Value: 22 |
| indent |
|---|
|
Parameter Data Type: Text |
| indent |
|---|
|
14. Click on Save to save the new parameter. |
| indent |
|---|
|
15. The Parameters List page will display all the new parameters you have entered. |
| indent |
|---|
|
16. In the Navigation panel click on Params to refresh the hierarchical tree and display the new parameters. |
Step 2: Create an FRC directory
The second and last step in setting up File Repository to use SFTP is to create a directory on the server to host the files. This new directory will be called FRC and will reside on the same server as your JBoss installation.
Location of New "FRC" Directory
| indent |
|---|
|
- The new directory will reside in the /opt/ directory.
|
| indent |
|---|
|
- The FRC directory needs to reside in a directory called opt. Since Windows does not typically come installed with an opt directory you will need to create one in the root directory.
|
| indent |
|---|
|
- Once you have an opt directory you can create the new FRC directory within it.
|
| indent |
|---|
|
Example: C:\opt\FRC\ |
| Note |
|---|
|
When creating the new directory you need to log onto the server with the same user that will be running JBoss. |
