2.4 Register Storage Providers with Oracle Big Data Manager

You must register storage providers with Oracle Big Data Manager to be able to see and use them in the console.

To register a new provider:

1. Sign in to the Oracle Big Data Manager console as the bigdatamgr user, or as another user with administrator privileges.
2. Click the Administration tab at the top of the page, and then click the Storage providers tab on the left side of the page to show a list of registered storage providers.
3. Click the Register a new storage provider button.
4. On the General page of the Register storage providers wizard, enter a name and description for the storage provider, select the storage type, and then click Next.
5. On the Storage Details page, provide details for accessing the storage provider. You can test connection details by clicking the Test access to storage button.
   • Amazon S3
     • Access Key: Enter the access key ID.
     • Secret Key: Enter the secret key.

     See About Access Keys in the Amazon S3 documentation.

   • GitHub
     • Access token: Enter the access token for the GitHub repository. The token should have a scope of repo or public_repo. See Creating a personal access token for the command line in the GitHub documentation.
   • HDFS

     No settings are required because HDFS is part of the cluster where Oracle Big Data Manager is running and is registered automatically. Registration of remote HDFS (HDFS running on a different cluster than where Oracle Big Data Manager is running) is not supported.

   • Oracle Cloud Infrastructure Object Storage
     • Authentication type: Select the authentication type to be used for data access. Choices are Credentials or Oracle Cloud Instance Principal. See Calling Services from an Instance in the Oracle Cloud Infrastructure documentation. If you use an instance principal, you'll need to specify just the Storage URL and Compartment settings listed below.
     • Storage URL: Enter the Oracle Cloud Infrastructure Object Storage URL or select one from the list.
     • Tenant: Enter the Tenancy OCID.
     • User: Enter the User OCID.

       See Where to Get the Tenancy's OCID and User's OCID in the Oracle Cloud Infrastructure documentation.

     • Access to: The Compartment option is selected by default and is the only option that's currently available.
     • Compartment: Enter the OCID of the compartment you want to register. The compartment OCID can be found in the Oracle Cloud Infrastructure console. Once this storage provider is registered, the compartment and its contents (buckets) can be accessed from the Oracle Big Data Manager console.
     • Public key fingerprint: Enter the fingerprint of the public key. See Required Keys and OCIDs in the Oracle Cloud Infrastructure documentation.
     • Private key: From the drop-down list, choose how you want to provide the private key. Depending on your choice, either paste the private key value in the text box, or upload the private key file. This is the private key in PEM format that corresponds to the public key whose fingerprint you entered above. See Required Keys and OCIDs in the Oracle Cloud Infrastructure documentation.
     • Key passphrase: (Optional) If the private key is encrypted with a password, enter that password here so the private key file can be decrypted and used for authentication.
     • Automatic proxy detection: Select this check box if the cluster is running behind a proxy server and you want to use automatic proxy detection.
   • Oracle Database
     • Username: Enter a user name that corresponds to a user account for the database. This is the user name that should be used to connect to the database.
     • Password: Enter the password associated with the user name.
     • JDBC URL: Enter the Oracle database connect string in the following format: jdbc:oracle:thin:@//host:port/service_name, where host and port are the database host and port and service_name is the database service name. For example: jdbc:oracle:thin:@//myhost:1521/myservicename
   • Oracle MySQL
     • Username: Enter a user name that corresponds to a user account for the database. This is the user name that should be used to connect to the database.
     • Password: Enter the password associated with the user name.
     • JDBC URL: Enter the MySQL database connect string in the following format: jdbc:mysql@host:port/[database_name], where host and port are the database host and port and database_name is optional. For example: jdbc:mysql://myhost:3306 or jdbc:mysql://myhost:3306/mydatabase
6. On the Access page, use the arrows to specify which users can see this storage from within Oracle Big Data Manager. This setting only affects whether users can see the storage. Whether they can access data on a given storage depends on the settings of the service that provides the storage.
7. Review the details on the Confirmation page, and then click the Register button.