(DTERP-2211) Settings
Table of Contents:
The product contains multiple parameters that can affect behavior. Here you can find a list of the parameters and their meaning. Settings can be accessed using transaction /DVD/RL_SETT_EXPERT or using cockpit transaction /DVD/CRP and choose Goto->Expert settings.
General content repository settings
Tool name: CRP
Description | Name | Default value | Allowed values | Details |
---|---|---|---|---|
Execute APPEND in compatibility mode | APPEND_COMPATIBILITY_MODE | X | Enumeration <empty> - disabled X - enabled | If storage does not support append to already created binary files, then the append command is simulated. Steps to simulate append command Get already existing data Append new data to existing data in runtime Overwrite data With this approach, you can store max up to 1,99 GB into one file. |
Default retention implementation | DEFAULT_RETENETION_IMPL |
| Enumeration <empty> - disabled X - enabled | The cockpit will show you the default retention implementation option instead of the DataFrigde implementation option. This setting will only affect if DataFridge is present on the service system. In other cases default implementation option is shown as default. |
License expiration reminder (days) | LICENSE_REMINDER_DAYS | 30 |
|
|
Repair multipart in request | REPAIR_REQ_MULTIPART |
| Enumeration <empty> - disabled X - enabled | Repair functionality for the repair of HTTP requests containing multipart that cannot be read by standard SAP functionality. Client application created HTTP request multipart data in the wrong format, this could happen when the request is created on an older SAP release. Usually, this happens during attachment migration. If you have to migrate multipart attachment you can switch this functionality and see whether the issue will be resolved. |
Write data size to logs | WRITE_DATA_SIZE_TO_LOG |
| Enumeration <empty> - disabled X - enabled | Write data size to logs. As a possible performance loss, we have this on the switch. If we perform read or write on a document, its content size will be written to a log. This should ease up the fixing process and speed up problem analysis. |
Write performance statistics | WRITE_PERFORMANCE_STATS |
| Enumeration <empty> - disabled X - enabled | Write performance statistics. Chosen Actions and Parameters will be written to a table for further analysis. Main table /DVD/CRP_STAT, Actions are stored in /DVD/CRP_STATA and parameters in /DVD/CRP_STATP. |
Write statistics to logs | WRITE_STATS_TO_LOG |
| Enumeration <empty> - disabled X - enabled | Write runtime statistics to service logs. This is mainly aimed at runtime analysis and troubleshooting. Set SM attributes - possible creation of new container on storage Write package - write binary data to storage Delete package - delete binary data from storage Drop container - drop complete data container from storage Read package - read binary data from storage
|
Retention management registration
Tool name: CRP_RM
Parameters can affect the registration of document ID to retention management.
Description | Name | Default value | Allowed values | Details |
---|---|---|---|---|
Delay for registration job (seconds) | REG_JOB_DELAY_SEC | 20 | Minimum 0 Maximum 2147483647 | Registration job DVD_RM_REG_DOCUMENT is scheduled after the successful creation of the file in storage. To be able to identify archiving sessions for a given Document ID, we need to delay the registration job at least to the moment when the Document ID is updated in the ADMI_FILES table. Delay comes in handy also when you plan to get retention date and legal entity from infrastructure which is built after successful creation of the file. |
Retention registration enabled | REG_RET_ENABLED |
| Enumeration <empty> - disabled X - enabled | Automatic registration of the files for retention management can be switched ON or OFF by this setting. When settings are ON, mentioned job DVD_RM_REG_DOCUMENT is scheduled after each successful creation of the file. Please be careful with this setting especially during migration projects where lots of documents are stored in a short time. This can cause the job overflood as each stored document will schedule a new retention registration job. Recommendation is to switch off this setting during activities that massively store the documents. After such activity is over, you can execute/schedule the registration report /DVD/CRP_RM_REGISTER_DOCUMENT manually, which will add multiple documents in one run. More information can be found in the Retention management section. |
The setting window can contain also dynamically generated parameters relevant to specific Source ID.
Description | Name | Default value | Allowed values | Details |
---|---|---|---|---|
Auto <Source ID>_LAST_TS | <Source ID>_LAST_TS | 0 | Timestamp value in the format YYYYMMDDhhmmss | When you use the report /DVD/CRP_RM_REGISTER_DOCUMENT or use transaction /DVD/CRP and choose Manual registration of documents. You can register all documents for a specific Source ID from the last execution of the report. This parameter is holding the last execution of the report for Source ID. |
Storage management connector
Tool name: CRP_SMC
Parameters can affect the creation of containers in storage management.
Description | Name | Default value | Allowed values | Details |
---|---|---|---|---|
Add file extension to name | ADD_FILE_EXTENSION_TO_NAME |
| Enumeration <empty> - disabled X - enabled | Enables adding file extension to name. File extension is recognized from the mime type of the file and is stored in the external ID of the documents. Not all storages support this feature. Unsupported Storages: BLOB - BLOB Storage (Primary Database) |
Max size of the container (kB) | CONT_SIZE_THRESHOLD_KB | 100000000 | Minimum 0 Maximum 2147483647 | For each Source ID, you can specify a prefix for containers that will be created on specified storage (more details can be found in the section Source to storage mapping). Containers are then created with the following names <container prefix><sequence number>. During the first creation of the file, a container is automatically created with sequence number 0. This parameter is limiting how much data can be stored in one container in kB. When this size threshold is overreached, a container with the next sequence number is created. |
Check container size threshold period (secs) | CONT_SIZE_CHECK_SECS | 1440 | Minimum 0 Maximum 2147483647 | Parameter CONT_SIZE_THRESHOLD_KB defines the max size of the container. Due to performance reasons, it's not a good idea to check the size of the container each time when a new file is created. Using this parameter, you can set the period of how often the size of this container should be checked. |
Delete empty container | DELETE_EMPTY_CONTAINER | X | Enumeration <empty> - disabled X - enabled | Container for source ID is created during the first attempt of data insertion to it and eventually, it will be deleted by deletion of last of its file. For some storage, there can be the issue of re-creating containers with the same name; therefore, this option was added. You can switch off the deletion of a container by this setting. The container will not be deleted. If there is another attempt to insert data into the source container, it doesn’t need to be re-created again because it is already available. |
Number of allowed lock attempts | LOCK_WAIT_ATTEMPTS | 10 | Minimum 1 Maximum 2147483647 | When a new file is being created, we need to check to which container it should be written. This information is stored in the table /DVD/CRP_SMC_LUC. To make sure this table will not be updated with another concurrent execution, we need to lock access to this table. This parameter restricts how many times the program can try to get this log. If several attempts are overreached, an exception is raised with the following error message: Creation of package is locked for storage ID '<Storage ID>' |
Raise error when storing empty data | RAISE_EMPTY_DATA_EXCEPTION | X | Enumeration <empty> - disabled X - enabled | Test report RSCMST expecting different behaviour on different SAP releases for storing documents with empty data. You can choose whether you want to raise an exception (service return code 500) or you want to pass such a request (return code 0). |
The setting window can contain also dynamically generated parameters relevant to specific Source ID.
Description | Name | Default value | Allowed values | Details |
---|---|---|---|---|
Auto AUTO_CONT_SIZE_CHECK_<Source ID> | AUTO_CONT_SIZE_CHECK<Source ID> | 0 | Timestamp value in the format YYYYMMDDhhmmss | Parameter CONT_SIZE_CHECK_SECS is limiting how often the size of the container will be checked, this dynamical parameter holds the last timestamp when container size was checked. |
Information system
Tool name: CRP_AIND
Location: SNP OutBoard™ ERP Archiving → Information system → Settings.
The parameter affects the behavior of virtual indexes functionality.
Description | Name | Default value | Allowed values | Details |
---|---|---|---|---|
Virtualization of indexes enabled | VIRTUAL_INDEX_ENABLED |
| Enumeration <empty> - disabled X - enabled | Parameter disables/enables virtual index functionality in general. |
Infostructure access mode | INFOSTRUC_ACC_MODE | T | Enumeration T - use Infostructure management table A - enable for all infostructures | The parameter specifies for which infostructures virtual indexes can be used. Either you use the table with a list of info structures to enable or disable a particular infostructure or you can allow it for all infostructures. We recommend using the method with the table as you know the exact list for which info structures is a virtual index used. You can edit the table by using transaction /DVD/CRP_AIND_IE |
Transparentization runs | TRANSPARENT_RUNS |
| List of Run ids in CSV format <empty> - search in all runids <runid1>;<runid2>; …;<runidN> | To identify which storage and which table for which archiving object should be read, you can define allowed transparentization runids that will be used to get this metadata information. Runids need to be added in CSV format. Possible runid can be found in transaction /DVD/SARA using F4 help. |
Automatic transparentization
Tool name: CRP_TSP
Location: SNP OutBoard™ ERP Archiving → Transparentization → Settings.
The parameter affects the behavior of auto transparentization functionality.
Description | Name | Default value | Allowed values | Details |
---|---|---|---|---|
Transp. job delay | JOB_DELAY | 20 | Minimum 0 Maximum 2147483647 | Transparentization execution job /DVD/CRP_TSP_EXECUTE is scheduled after the successful registration of components in the repository. To be able to identify archiving sessions for a given Document ID we need to delay the registration job at least to the moment when the Document ID is updated in the ADMI_FILES table. |
Enable auto transparentization | ENABLE_AUTO_TRANSP |
| Enumeration <empty> - disabled X - enabled | Parameter disables/enables automatic transparentization functionality in general. |
Mass Archiving
Tool name: EM_MASS
Location: SNP OutBoard™ ERP Archiving → Mass archiving → Settings.
The parameter affects the behavior of auto mass archiving functionality.
Description | Name | Default value | Allowed values | Details |
---|---|---|---|---|
Default value var. gen object count | DEFAULT_OBJ_COUNT | 50000 | Minimum 0 Maximum 2147483647 | Maximum object count in one variant |
Default value for var gen size (MB) | DEFAULT_SIZE | 500 | Minimum 0 Maximum 2147483647 | Maximum variant size |
Threads to calculate estimates | ESTIMATE_THREADS | 5 | Minimum 1 Maximum 2147483647 | Number of threads to calculate estimates |
Number of runs to enable filtering | RUNS_TO_FILTER | 50 | Minimum 1 Maximum 2147483647 | Filter will appear if number of runs is exceeding this value |
Maximum number of tasks for scheduler | MAX_SCHEDULER_TASKS | 3 | Minimum 2 Maximum 2147483647 | Number of tasks (phases) you want to be able to execute at the same time . One phase is executed in one task. Additionally, one more job is required for the dispatcher. |
Bottom time limit for scheduler | SCH_TIME_FROM |
| Minimum 000001 Maximum 235959 | Bottom time of the time frame in which the tasks execution is allowed. The execution of tasks will not start before this time. This setting together with 'Top time limit' can be used to limit the execution of tasks to a specific time frame. |
Top time limit for scheduler | SCH_TIME_TO |
| Minimum 000001 Maximum 235959 | Top time of the time frame in which the tasks execution is allowed. After reaching the upper time limit the job will be canceled (already running tasks will continue to run until they finish). This setting together with 'Bottom time limit' can be used to limit the execution of tasks to a specific time frame. |
Use direct execution method | USE_DIRECT_EXECUTION | X | X - use new execution method <space> - use older execution method | Execute archiving jobs using method that use only one extra job for dispatcher. Older method using one extra job for each execution of archiving job. Use older method only if you have troubles with new one. |
Wait time in dispatcher | WAIT_TIME_SECONDS | 5 | Minimum 0 Maximum 2147483647 | Dispatcher is executing archiving jobs, once all allowed jobs are running dispatcher is checking whether any of them is finished. To avoidactive waiting of dispatcher it is possible to wait with further execution few seconds. |