Chat now with support
Chat with Support

Metalogix StoragePoint 5.9.1 - IBM COS Adapter Guide

IBM COS

This section will provide you details on how to configure a storage endpoint’s connection string to utilize the IBM Cloud Object Storage Adapter.  Please refer to the StoragePoint Reference Guide for information on managing Storage Endpoints.

On the Application Management page, click Storage and Backup Endpoints.

Click Create New Endpoint or click the name of an existing storage endpoint that you want to edit.

Click the Show link next to the Advanced Adapter Settings to see the additional fields.
IBMCOS1

IBM COS Adapter Connection String Parameters

Setting

Value/Options

Name

Enter the unique name of the Storage or Backup Endpoint.

Type
atmos2

See Backup Services Settings in the Reference Guide for more information on how Backup Endpoints are used.

Primary – this endpoint will be available for externalization when creating storage profiles.

Backup – this endpoint will be in the Backup Services dropdown on the profile page.

The selection is locked down when saving.

Status

amazon3

Online – Storage Endpoint should be available to associate to a Storage Profile and accept BLOBs. (default)

Offline (Read Only) – A storage endpoint can be configured, but not made available for externalizing content. The BLOBs already on the endpoint are still read only.

IBMCOS2

Select the adapter for the endpoint that is being created.

clversafe3

The Access Key ID provided by IBM when you signed up for the service. Required.

clversafe4

The Secret Access Key provided by IBM when you signed up for the service. Required.

IBMCOS3

IP or DNS name that represents the access point for the IBM COS service.

IBMCOS4

(true/false)  Determines whether or not the adapter negotiates an SSL connection for all data (and metadata) transfers. Default = False.

IBMCOS5

The container within your IBM COS account where content associated with a storage profile will be stored. Vault names are case sensitive and unique across the entire service namespace.

IBMCOS6

Port used to access the IBM COS service. Default = 80 (443 if UseSSL is True).

clversafe9

(Yes/No)  If UseSSL is Yes, the StrictSSL flag controls whether or not the use of "self-issued" or otherwise suspicious certificates on the system will be tolerated.

IBMCOS7

The provision code determines what features are enabled by way of a template. Please contact your IBM representative to get the latest provisioning codes for your organization.

Allows vaults to be created with specific location constraints.

amazon12

If the endpoint is on a WORM (Write Once, Read Many) device, Unused BLOB Cleanup will ignore this endpoint.

castor10

No – Externalized content BLOBs are not placed in folders.

Yes – Externalized content BLOBs are placed in folders (default).

If Folder Content in BLOB Store is Yes then you can select a date/time folder scheme from the dropdown.

YYYY/MM/DD/HH/MM is the default.

amazon15

The Test Storage Settings button can be used at this point, or after completing the endpoint configuration, to verify that the endpoint is accessible. For some adapters, testing the connection will create the vault if it doesn't already exist.

castor13

No – Externalized content BLOBs are not compressed (default).

Yes – Externalized content BLOBs are compressed.

castor14

None – Encryption will not be applied to externalized BLOBs (default).

AES (128 bit) – 128 bit AES encryption will be applied to externalized BLOBs.

AES (256 bit) – 256 bit AES encryption will be applied to externalized BLOBs.

amazon18

Enter a passphrase to use when generating the encryption key. Using a passphrase will help you re-create the encryption key if necessary. You can generate a random key by leaving the box blank and clicking the Generate Key button. The encryption key passphrase will be hidden.

amazon20

A warning email can be sent if the endpoint encounters errors.

amazon21

An online storage endpoint can be automatically taken offline if it encounters errors. If a storage endpoint is taken offline automatically, BLOBs that were intended to be written to that endpoint will go to the content database.

amazon22

Default email addresses for system error and offline notification can be entered. Check the box to include the list of Default Notification Contacts specified on the General Settings page.

Example Storage Endpoint using IBM COS Adapter

IBMCOS8

Click the Show Connection String checkbox to edit the connection string. Otherwise, fill in the connection fields shown for the adapter selected. Notice that the connection string parameters are name/value pairs separated by semi-colons.
IBMCOS9

NOTE: Adapter parameters are not case-sensitive.

NOTE: You should always use a passphrase when generating encryption keys. The passphrase gives you a means of re-creating keys should they become unrecoverable or corrupt. It is very important to remember or record the passphrase outside of Metalogix StoragePoint. Otherwise, encrypted content could become irretrievable in the event of a database failure.

If you choose to externalize content you should test the storage profile settings by clicking the Test Storage Settings button. A message under the button will indicate whether or not the test was successful. If the test fails the message will include the error that was the root cause of the failure.

NOTE: When testing access to an endpoint from within Central Administration, the Identity of the Application Pool hosting the Central Administration Site is the one that is being used for the test. If there are different Identities used for other Web Applications in the Farm then those identities will also need access but cannot be tested from within Central Admin itself. See BLOB Store Security and Metalogix StoragePoint Required Privileges in the Metalogix StoragePoint Reference Guide.

Appendix: Troubleshooting

 

Self Service Tools
Knowledge Base
Notifications & Alerts
Product Support
Software Downloads
Technical Documentation
User Forums
Video Tutorials
RSS Feed
Contact Us
Licensing Assistance
Technical Support
View All
Related Documents