'archive' Service
The configuration of the 'archive' service is used to set up and configure connections to the following archiving systems.
iCAS/HCP archive/Cloudian Hyperstore/Dell EMC ECS/S3 (AWS)/enaio® cloud-archive
The configuration is carried out using profiles in the application-storage.yml configuration file from the \services\service-manager\config\ directory.
Configuration values such as user name and password can be specified in the encrypted configuration file.
The installed configuration file contains sample profiles with profile parameters for supported archiving systems.
The 'archive' service must be restarted via enaio® services-admin after changes have been made to the application-storage.yml configuration file.
storage: | |||||||||||||||||||||
profiles: | |||||||||||||||||||||
iternity: | |||||||||||||||||||||
<Profilname>: |
Profile name. The profile name is specified during configuration of the virtual archive in enaio® enterprise-manager. You can create more than one profile. |
||||||||||||||||||||
userName: |
Name of the user with the appropriate rights for the archive. |
||||||||||||||||||||
userPassword: | The user's password. | ||||||||||||||||||||
endpoint: | URL of the iCAS/iCAS FS web service. | ||||||||||||||||||||
cscMode |
Storage mode for documents and index data. The storage mode is specified with a sequence of four parameters:
Example: LSSN The document is compressed (L) and encrypted with the standard method (S); the index data is not compressed (S) and not encrypted (N). |
||||||||||||||||||||
maxCreateCscSize |
Determines the maximum size of containers created with the 'CreateCsc' write method. The information is expressed in bytes. Default: 10 MB. |
||||||||||||||||||||
maxCreateCscFile |
Determines the maximum number of documents for the containers created with the 'CreateCsc' write method. Default: 1000. |
||||||||||||||||||||
maxCreateCscSingleFileLimit |
Determines the individual size limit of a document. The 'CreateCsc' write method is used up to this limit. The information is expressed in bytes. Default: 4 MB If the limit is exceeded, the 'AddToWork' write method, which is less memory-intensive and creates the containers divided over several chunks, is used. |
||||||||||||||||||||
maxWorkChunkSize |
Determines the maximum size of a single chunk for the 'AddToWork' write method. The information is expressed in bytes. Default: 5 MB |
||||||||||||||||||||
clientSslTrustStore: |
Optional: Resource path to a certificate trust store for encrypted communication with iCAS. The path to the certificate file is specified with a 'file' log. Example: clientSslTrustStore: file:D:\s-m\zertifikate\cert_icas.PFX |
||||||||||||||||||||
clientSslTrustStorePassword: |
Optional: Password for the certificate trust store. |
||||||||||||||||||||
defaultRetentionInDays: |
Retention time in days, default=0 (do not transmit retention time) For documents with a scheduled retention time, this has priority over any times specified here. |
storage: | |
profiles: | |
hcp_s3: | |
<Profilname>: |
Profile name. The profile name is specified during configuration of the virtual archive in enaio® enterprise-manager. You can create more than one profile. |
access-key: |
Access key |
secret-key: | Password |
url: | URL for HCP |
bucket: | Name of the bucket in the storage system for filing. |
defaultRetentionInDays: |
Retention time in days, default=0 (do not transmit retention time) For documents with a scheduled retention time, this has priority over any times specified here. |
Profile for Cloudian HyperStore:
The Cloudian Hyperstore Content Platform provides an AWS-S3-compatible rest API with few extensions used by the 'archive' service. In order to configure the Cloudian Hyperstore archive, you need to configure the following S3-relevant parameters.
storage: | |
profiles: | |
cloudian_s3: | |
<Profilname>: |
Profile name. The profile name is specified during configuration of the virtual archive in enaio® enterprise-manager. You can create more than one profile. |
access-key: |
Access key |
secret-key: | Password |
url: | URL for Cloudian HyperStore |
bucket: | Name of the bucket in the storage system for filing. |
defaultRetentionInDays: |
Retention time in days, default=0 (do not transmit retention time) For documents with a scheduled retention time, this has priority over any times specified here. |
pathTemplate | Optional: This parameter can be used to store objects in specific directories (paths) within a bucket. |
Profile for Dell EMC ECS:
It is necessary to make customizations for Dell EMC ECS.
storage: | |
profiles: | |
ecs-cas: | |
<Profilname>: |
Profile name. The profile name is specified during configuration of the virtual archive in enaio® enterprise-manager. You can create more than one profile. |
access-key: |
User name |
password: | Password |
clusterId | Number of the cluster that is being accessed. |
url: | URL to Dell EMC ECS |
bucket: | Name of the bucket to be displayed in the health check. |
defaultRetentionInDays |
Retention time in days, default=0 (do not transmit retention time) For documents with a scheduled retention time, this has priority over any times specified here. |
calculateDigestMetadata | Default=false, optional: It may be necessary to compute a digest in the getMetadata query. |
calculateDigestContent | Default=false, optional: It may be necessary to compute a digest in the getContent query. The digest is sent in the Content-hash-HTTP header. |
Customizations for Dell EMC ECS
The following customizations for Dell EMC ECS are required:
-
Integrate libraries
-
Download the archive dell_ecs_cas_lib64.zip, extract the archive on the enaio® service-manager computer, and extend the 'Path' system variable with the path to the directory.
-
Make sure that the following files are available in the System32 or Syswow64 directory:
msvcp110.dll and msvcr110.dll
If these files are not found in the directory, they can be installed via the Microsoft Visual C++ 2012 Redistributable Package.
-
Restart the computer.
-
storage: | |
profiles: | |
s3: | |
<Profilname>: |
Profile name. The profile name is specified during configuration of the virtual archive in enaio® enterprise-manager. You can create more than one profile. |
access-key: |
Access key |
secret-key: | Password |
url: | URL for S3 |
bucket: | Name of the bucket in the storage system for filing. |
defaultRetentionInDays: |
Retention time in days, default=0 (do not transmit retention time) For documents with a scheduled retention time, this has priority over any times specified here. |
Profile for enaio® cloud-archive
A plug-in must be integrated for enaio® cloud-archive.
storage: | |
profiles: | |
enaio-cloud-archive: | |
<Profilname>: |
Profile name. The profile name is specified during configuration of the virtual archive in enaio® enterprise-manager. You can create more than one profile. |
url: | URL |
tenant: |
Tenant |
username: | User name |
password: | Password |
silo: |
Value to categorize data and make it easier to find. No configurations are needed in enaio® cloud-archive in order to specify silo values. |
defaultRetentionInDays: |
Retention time in days, default: 0 (do not transmit retention time) For documents with a scheduled retention time, this has priority over any times specified here. |
connectionTimeoutInMillis: |
Timeout (in milliseconds) for the connection Default: 5000 |
readTimeoutInMillis: |
Timeout (in milliseconds) for reading files Default: 1800000 |
Plug-in for enaio® cloud-archive
A plug-in is required for enaio® cloud-archive. The enaio-cloud-archive.zip plug-in is part of the installation data located in the \Backend\Service-Manager-Update\Plugins directory.
Plug-ins need to be activated via the application-storage.yml file located in the enaio® service-manager \config\ directory, and the directory for the plug-in needs to be specified.
storage:
plugins:
enabled: true
directory: "c:\enaio\data\plugins"
The plug-in needs to be copied to the specified directory: in the example here C:\enaio\data\plugins.
The enaio-cloud-archive.zip plug-in is not included in enaio_services_versionfix.exe and needs to be updated manually by copying it to the specified plug-in directory if required.
Then the 'archive' service needs to be restarted. enaio-cloud-archive.zip is extracted to a subfolder with the same name. The plug-in will only be updated if the subfolder with the extracted plug-in is deleted first.
The data for the configuration (URL, tenant, user name, password) can be obtained from OPTIMAL SYSTEMS, including the information for changing the user name and password.
Encryption of Configuration Values
The configuration values of the application-storage.yml file in the \config\ directory of enaio® service-manager can be encrypted:
-
Open the command prompt as the administrator and change to the \service-manager\tools\encryption\ directory.
-
Run the following command: encode.bat "value" -W.
The encrypted value is displayed in round brackets with 'ENC' before it: ENC(encryptedvalue).
-
Copy the encrypted value with the leading 'ENC' and with the round brackets and enter it into the configuration file.
-
Save the configuration and restart the service, if necessary.
If the value to be encrypted contains quotation marks or ends with a backslash, these characters must be preceded by the backslash.
Example: encode.bat "passwordwith\"quotation\"marks" -W