Create a Informatica PowerCenter Shared Storage connection

A Shared Storage connection allows you to grant your capabilities access to files from a shared folder. This connection is especially useful for capabilities with large files, as you don't need to manually upload the files directly to Edge. Instead, you define the path to the files when creating the new connection.

You can upload files that are up to 1 GB in size. Each Edge site allows a total of 6 GB of uploads. This means, for example, you could upload 6 files that are 1 GB each to the Shared Storage connection on your Edge site.

Before you begin

• You have created an Edge site.
• You have installed an Edge site.

Prerequisites

• You have a global role with the Product Rights > System administration global permission.
• You have a global role that has the Manage Edge sites global permission.
• You have a global role that has the Manage connections and capabilities global permission.

Steps

1. Run one of the following commands in the Edge CLI tool included with the Edge site installer to create a new shared folder and upload your source files:
   Note If your Edge site is installed on a bundled k3s cluster, you must add sudo to the beginning of any command run in the Edge CLI. For example:

   sudo ./edgecli objects folder-upload -h

   • Show how to upload a folder with source files

     Upload a shared folder which contains multiple data source files:

     Copy

     ./edgecli objects folder-upload \
         --source <source-string> \
         --target <target-string> \
         --ttlSeconds <time>

     Key	Definition
     <source-string>	The data source file you want to upload for your Shared Storage connection.
     <target-string>	The folder in your Edge site where you want to store the shared folder and files. Note This folder does not have to already exist in your Edge site. If it does not, a folder with the name entered here will be created in your Edge site, containing the folder and files you have uploaded.
     <time> (optional)	The number of seconds that the uploaded files will be available before being evicted, the default is 15552000 seconds (180 days).

     Example

     Let's say we have a shared folder /tmp/folder-a, with the following directory structure:

     • /tmp/folder-a/file-a.txt
     • /tmp/folder-a/sub-folder-1/file-b.txt
     • /tmp/folder-a/sub-folder-1/file-c.txt

     Let's upload everything in /tmp/folder-a to a shared folder named shared-folder-1. To do so, run the following command:

     ./edgecli objects folder-upload \
     --source /tmp/folder-a \
     --target shared-folder-1 \
     --ttlSeconds 3600				

     The resulting output is the following:

     Uploaded 3 files:
     target=shared-folder-1 key=file-a.txt: size=14 ttlSeconds=3600
     target=shared-folder-1 key=sub-folder-1/file-b.txt: size=14 ttlSeconds=3600
     target=shared-folder-1 key=sub-folder-1/file-c.txt: size=14 ttlSeconds=3600
     Total of 42 bytes uploaded			

     Note 

     • If you repeat the command, all existing objects that are present in the shared folder will be overwritten.
     • If you remove some files in the source directory, they will not be removed from the shared folder.
     • If you want file parity with your source folder, use the folder-delete command, and then use the folder-upload command.
     • If you need help with the command parameters, run the help command in the Edge CLI.

       ./edgecli objects folder-upload -h

   • Show how to upload a single source file

     Upload a single shared data source file:

     Copy

     ./edgecli objects file-upload \
         --source <source-string> \
         --target <target-string> \
         --key <key-string> \
         --ttlSeconds <time>

     Key	Definition
     <source-string>	The data source file you want to upload for your Shared Storage connection.
     <target-string>	The folder in your Edge site where you want to store the shared file. Note This folder does not have to already exist in your Edge site. If it does not, a folder with the name entered here will be created in your Edge site, containing the file you have uploaded.
     <key-string> (optional)	The path of a specific file within a folder or nested within multiple folders. For example, you only want to upload the myFile.txt file, which is in the myFolders folder. If you do not specify this property, it will default to the file name.
     <time> (optional)	The number of seconds that the uploaded file will be available before being evicted, the default is 15552000 seconds (180 days).

     Example

     Let's say we have a shared file called /tmp/data-source-file-to-upload/a.txt \, and we want to upload it to a folder called shared-folder-2 in our Edge site.

     To do so, run the following command:

     ./edgecli objects file-upload 
     --source /tmp/data-source-file-to-upload/a.txt \
     --target shared-folder-2 \
     --key rekeyed-a.txt \
     --ttlSeconds 8000

     The resulting output is the following:

     Uploaded 1 file:
     target=shared-folder-2 key=rekeyed-a.txt: size=14 ttlSeconds=8000

     Note 

     • If you repeat the command, all existing objects that are present in the shared folder will be overwritten.
     • If you remove the file in the source directory, it will not be removed from the shared folder.
     • If you want file parity with your source folder, use the folder-delete command, and then use the folder-upload command.
     • If you need help with the command parameters, run the help command in the Edge CLI.

       ./edgecli objects file-upload -h

2. Open a site.
   1. On the main toolbar, click → Settings.
      The Settings page opens.
   2. In the tab pane, click Edge.
      The Sites tab opens and shows a table with an overview of your sites.
   3. In the site overview, click the name of a site.
      The site page appears.
3. In the Connections section, click Create Connection.
   The Create Connection dialog box opens.
4. Select Shared storage connection.
   The Create Connection dialog box for Shared storage connection opens.
5. Enter the connection information.

   Field	Description	Required
   Name	The name of the connection.	Yes
   Description	The description of the connection.	No
   Folder	Enter the name of your folder created in step 1. Subfolders are not allowed, so create a separate folder for each Shared Storage connection. Note Edge lists the location of this file to the right of this field.	Yes

6. Click Create.

What's next

Prepare the data source files and store them in the folder that you created when you created the Shared Storage connection.