(DTERP-1908) Set Up and Install
Configuration of the Outboard DataTiering ERP is logically divided into configuration steps required on Outboard service side and Archiving Client side.
- Outboard Service
- Set up and activate Outboard HTTP service in ICF
- Set up Storage connection in Storage Management
- Define Source ID as archiving client identifier
- Assign Storage to Source ID
- Archiving Client
- Define Content Repository
- Send system security certificate to the Outboard Service
- Verify and allow the security certificate by the Outboard Service
Outboard Service
ICF HTTP Service
Transaction code: SICF
→ MANUAL STEP – Requires separate setup on each system (no transports)
The Outboard is deployed as an ICF (Internet Communication Framework) HTTP service running locally on the system. The service definition is delivered out of the box. Parameters which require attention are listed and described in the table below. Once it is configured, activate the service.
Parameter | Value | Description |
---|---|---|
Server Path | /default_host/dvd_crp_http | Host URL of the ICF service. This path is part of the host script identification in Content Repository definition. |
Logon Group | <optional> | The logon group delimits applications servers that are used to execute incoming HTTP requests from archiving client. |
Service User | <mandatory> | Service user which executes incoming HTTP requests from archiving client. |
Handler | /DVD/CRP_HAL_CL_REQ_HANDLER | Request handler class of the OutboardTM DataTiering solution. |
SSL | Not required – running within internal network | Requirement to use secured communication |
Authentication | Standard SAP User | Only SAP users may request service |
Storage ID Definition
Follow setup of a Storage ID in Storage Management.
If you want use data validation functionality, please turn on hash calculation for created storage ID.
Source Definition
Transaction code: /DVD/CRP_SRC
→ Changes written to workbench transport request
Archiving client represented by a system and a content repository is recognized by the Outboard as a Source. Source definition in Outboard customizing referring to the content repository D1 is shown in the table below:
Property | Description | Value Example |
---|---|---|
Source ID | Unique source identifier. Recommended naming convention: <system line or ID>_<content repository defined in source> | E1_D1 |
Source Description | Short description of the source. | System Line E1, Content Rep. D1 |
Source SID | [Optional] SID of the source system. <initial> = empty | n/a |
Source Client | [Optional] Client of the source system. <initial> = 0 (zero) | n/a |
Content Repository ID | Content repository defined in the source that is being identified by the source ID. (1:1 mapping) | D1 |
Folder Full Path | [internal use only] Virtual folder path used for categorization of documents. Follows name of the Source ID. | /E1_D1 |
No Signature (checkbox) | The property indicates whether the operations must be secured with signature or not. <not checked> = signature must be present | <not checked> |
Example Values of the properties Source SID and Source Client in the table above are <initial>. Reason for this is to have an unified customizing utilizable by all system levels which simplifies transportability as well as future maintenance.
Initial values of the properties do not influence functionality of the solution - these properties have informative character.
When the “No Signature“ option is On and then switched Off all documents that has been stored in meantime can not be accessed without the signature.
Storage Mapping
Transaction code: /DVD/CRP_SRC_SM
→ Changes written to workbench transport request
Each individual Source must be mapped to a target Storage ID which identifies the storage connector and its corresponding customizing. This enables distribution of different data categories into dedicated storage locations – different storages or just different containers (folders). Mapping of the Source D1 to a Storage ID is shown in the table below:
Property | Description | Value Example |
---|---|---|
Source ID | Unique source identifier. Defined in the Outboard DataTiering’s Source customizing. | E1_D1 |
Storage ID | Unique storage identifier. It is defined in the Storage Management customizing. | ARCH_STOR |
Storage Type | Type of storage connector. | <storage type> |
Binary Container ID | Prefix for a container name. The container is an equivalent to a folder in a file-system-like storage. | E1-d1- |
The Binary Container ID (container name prefix) must conform to naming rules of the Binary Storage platform.
Archiving Client
Content repository Definition
Transaction code: OAC0
→ Can be assigned to a transport request
The archiving client connects with the archiving service using Content Repository definition. Once setup perform connection test.
- Content Repository connecting to the Outboard service: D1
Property | Description | Value Example |
---|---|---|
Content Rep. | Content Repository name. | D1 |
Description | Datavard Outboard – <storage type> Content Repository | |
Document Area | Communication interface. | <depends on data to be stored> |
Storage Type | Repository type. | HTTP content server |
Protocol | Protocol is required in case there is a need for a specific application to be used to display ArchiveLink document attachments. | n/a |
Version no. | ArchiveLink protocol version. | 0047 |
HTTP Server | Host name of target storage service. The Outboard service runs locally on the same SAP system, therefore it must be system host name. | <system host name> |
Port Number | HTTP port number of the system. | 8000 |
HTTP Script | Content Server path on the Web server with Outboard’s Source ID. | dvd_crp_http/E1_D1 |
SSL | Requirement to use secured communication | Not required – running within internal network |
Basic Path | File path for asynchronous storing of archived data. | <ideally same as the phys. path in the logical file path used as staging folder for archiving> |
Archive Path | File path for archive file retrieval. | <ideally same as the phys. path in the logical file path used as staging folder for archiving> |
No signature | Forging communication without signature verification. Accepted if the Outboard Service is in the “No signature” mode too. | <empty> |
Security Certificate for Outboard Service
Transaction code: OAC0
System’s public security certificate MUST be sent to the Outboard Service to ensure it can validate security signatures of incoming data.
Verification and Approval of Client Security Certificate
Transaction code: /DVD/CRP_HAL_CERT
Each archiving client trying to communicate and manage data in Outboard Service must be verified and approved by an administrator. Without an approved certificate signature verification fails and consequently the requested operation is aborted.
Verification
Verification whether the communication from an Archiving client to an External Storage has been correctly set up is performed
- Running the connection test for the Content Repository definition
- Running Storage Check in Storage Management configuration cockpit
Additional check can be performed using the SAP program RSCMST, see more details provided in the SAP Note 1482012 - Check the connection to content server.
Retention management
Retention management enables content repository to delete stored document when its retention period is over. Functionality itself is provided by integration with product Datavard DataFridge. There are few steps that you need to accomplish before you can start using retention management.
Please note retention management can be currently used only for archiving files created and stored using transaction SARA.
Prerequisites
Datavard DataFridge transports imported on system.
Initial configuration
- Request and install license for Datavard Glue and Datavard DataFridge
- Create storage using /DVD/SM_SETUP
- for primary database
- Setup archiving object customizing in /DVD/CRP_RM_SETUP for all relevant archiving objects
- Switch on retention management in /DVD/RL_SETT_EXPERT
- use tool CRP_RM and switch parameter REG_RET_ENABLED to 'X'
- Do quick setup of DataFridge using /DVD/RMX_SARA_SETUP
- Set retention for legal entities in /DVD/RMX_SARA_RET