White Paper Installation and Configuration of Fabasoft iarchivelink Fabasoft Folio 2017 R1 Update Rollup 1
Copyright Fabasoft R&D GmbH, Linz, Austria, 2018. All rights reserved. All hardware and software names used are registered trade names and/or registered trademarks of the respective manufacturers. No rights to our software or our professional services, or results of our professional services, or other protected rights can be based on the handing over and presentation of these documents. Installation and Configuration of Fabasoft iarchivelink 2
Contents 1 Introduction 4 2 Software Requirements 4 3 Installation of the Fabasoft iarchivelink Service 4 3.1 Enable HTTPS for a Fabasoft Folio Web Service 4 3.1.1 Linux 5 4 Configuration of the SAP System 5 4.1 Output Device 5 4.2 Content Repository 7 4.3 Document Type 8 4.4 Link for Content Repository 9 4.5 Document Type Customizing Wizard 9 4.6 Configuration of the GUI Integration 13 4.7 Support of Two Archives 16 4.8 Enable HTTPS Communication Between SAP and the Fabasoft Folio Web Service 17 4.8.1 Installation of the SAPCRYPTO Library 17 4.8.2 Configuration in SAP 17 4.8.3 Check SSL Configuration 18 5 Importing Certificates 19 6 Solution Manager Integration 19 6.1 SLD-Registration 19 6.2 Log and Configuration Files 20 7 Configuration of the Fabasoft Folio Domain 20 8 Checking the Installation 22 9 Client Configuration 24 9.1 Installation of SAP Control Stub on the Client Computer 24 9.2 Configuration of the Fabasoft Search Dialog 24 Installation and Configuration of Fabasoft iarchivelink 3
1 Introduction This document describes the installation and configuration of Fabasoft iarchivelink in a Microsoft Windows environment or Linux environment using an existing Fabasoft Folio Domain. Fabasoft iarchivelink provides a software product package, a setup for the installation of a system service and a setup for the installation of the SAP control stub. 2 Software Requirements System environment: All information contained in this document implicitly assumes a Microsoft Windows or Linux environment. Supported platforms: For detailed information on supported operating systems and software see the software product information on the Fabasoft distribution media. Descriptions in this document are based on the following software: SAP ERP Central Component (ECC) 6.0 SAP GUI for Windows 7.40 (Fabasoft Folio Web Client with supported Microsoft Windows operating system) Microsoft Visual C++ Redistributable 2017 3 Installation of the Fabasoft iarchivelink Service Fabasoft iarchivelink can be installed on a dedicated server or on an existing Fabasoft Folio Web Server. During the installation process of your Fabasoft product, additionally select Fabasoft iarchivelink. 3.1 Enable HTTPS for a Fabasoft Folio Web Service If the HTTPS protocol should be used for communication with the Fabasoft Folio Web Service, it has to be enabled explicitly. Installation and Configuration of Fabasoft iarchivelink 4
3.1.1 Linux To enable HTTPS in a Red Hat environment, perform the following steps: 1. Edit the file /etc/fabasoft/web/ssl.conf. Uncomment and configure the following lines: SSLEngine on SSLCertificateFile <path to server certificate> SSLCertificateKeyFile <path to keyfile> SSLCACertificateFile <path to ca certificate> SSLVerifyClient require SSLVerifyDepth 10 SSLUserName SSL_CLIENT_S_DN_CN 2. Edit the file /etc/fabasoft/web/webservice_<number>.conf. Replace <number> with the number of the Fabasoft Folio Web Service, where the HTTPS protocol should be used for communication. Add the following line to the include paragraph: Include /etc/fabasoft/web/ssl.conf 3. Comment or remove other login directives like: # AuthName "Fabasoft Folio" # AuthType Basic # AuthUserFile /etc/fabasoft/web/htpasswd # AuthGroupFile /etc/fabasoft/web/htgroups # Require valid-user 4. Restart the Fabasoft Folio Web Service. 4 Configuration of the SAP System Fabasoft iarchivelink can only be used with a well configured SAP system. The next chapters describe several configuration steps. 4.1 Output Device First it has to be checked whether an output device for Fabasoft iarchivelink is configured. If no output device is configured, a new one has to be created. Perform the following steps: 1. Start the transaction SPAD and click Display next to Output Devices. Installation and Configuration of Fabasoft iarchivelink 5
2. If there is no entry with Dev. type ARCHLINK, create a new one. 3. To switch into edit mode click Change or F8 and then click Create or Shift+F1. 4. Configure the output device on the DeviceAttributes tab. Click the Access Method tab and define the Host Spool Access Method. 5. Afterwards click Save to save the changes. Installation and Configuration of Fabasoft iarchivelink 6
4.2 Content Repository In SAP the Fabasoft iarchivelink HTTP content server has to be configured as content repository. Perform the following steps: 1. Start the transaction OAC0. 2. To switch into edit mode click Display/Change. 3. Create and configure a new entry for Fabasoft iarchivelink ( or F5). 4. Ensure that you are in Full administration mode by using the corresponding buttons. 5. The following options must be configured at least: o HTTP server Type the IP address or server name of the Fabasoft iarchivelink server. o Port Number Specify the port on which the Fabasoft iarchivelink Service is listening (typically in a Microsoft Windows environment: 80 and in a Linux environment: 17050). Installation and Configuration of Fabasoft iarchivelink 7
o No Signature The checkbox needs to be unchecked. o HTTP Script Specify the HTTP script. Type FSCArSap/fscarsap.dll. Note: For an optional HTTPS configuration type %HTTPS in the transaction field: 6. Use Test Connection to test the connection between SAP and the Fabasoft iarchivelink Service. 7. Click Send Certificate to send the certificate to the Fabasoft iarchivelink Service. 8. Click Exit to save the configuration settings. Note: If one Fabasoft iarchivelink Service should connect to several SAP systems it is mandatory that each content repository ID is unique and each certificate has a unique common name. 4.3 Document Type For testing purpose create your own document types. The names of these document types have to start with Z (e.g. ZZPRILIST ). To create a new document type, perform the following steps: 1. Start the transaction OAC2. 2. Click New Entries. Installation and Configuration of Fabasoft iarchivelink 8
3. Specify the settings for the new document type (e.g. FAX, PDF or DOC in the Document Class field). 4. Afterwards the document type has to be linked. 4.4 Link for Content Repository To link a document type, perform the following steps: 1. Start the transaction OAC3. 2. To switch into edit mode click Display/Change. 3. Click New Entries. 4. Create a new entry for the desired document type. Note: Only links with L=X will be active. 5. Click Save to save the configuration. 4.5 Document Type Customizing Wizard The document type customizing wizard can be used to specify workflow pre-settings for existing document types or new document types created using this wizard. Perform the following steps: 1. Start the transaction OAD5. Installation and Configuration of Fabasoft iarchivelink 9
2. Select the document type created before and click Continue. 3. Select a document type template and click Continue. Note: If no template is selected the default value is incoming invoice. 4. Select the checkbox Workflow document type to define workflow pre-settings and click Continue. Installation and Configuration of Fabasoft iarchivelink 10
5. Specify the object type. Select CREATE as entry method and specify the tasks. Afterwards click Continue. 6. Specify the content server and the link table and click Continue 7. Select available pre-settings if you want to maintain these. Otherwise click Continue without selecting. Installation and Configuration of Fabasoft iarchivelink 11
8. To create new pre-settings specify a unique ID and the name. Afterwards click Continue. 9. Define the details of the pre-settings. Select an organizational unit for which these pre-settings will take effect and configure appropriate restrictions. Click Continue. 10. Click Complete to finalize the configuration. Installation and Configuration of Fabasoft iarchivelink 12
Note: Start the transaction OAWD. The pre-settings defined before should be available. 4.6 Configuration of the GUI Integration To configure the GUI integration, perform the following steps: 1. Start the transaction OAA3. 2. Double-click SAPHTTP to edit this protocol. 3. Click Application maintenance. Installation and Configuration of Fabasoft iarchivelink 13
4. Click Create to create a new application. 5. Double-click the new application. 6. Double-click Display Stored Document and configure the settings of the stored documents. Afterwards click Back. Installation and Configuration of Fabasoft iarchivelink 14
7. Double-click Archive from Frontend and configure the settings. Afterwards click Back. 8. Click Save to save the settings. 9. Click Back twice to switch back to ArchiveLink Protocols: Overview of Protocol. Installation and Configuration of Fabasoft iarchivelink 15
10. Double-click Archive from frontend. Select a document class that should be maintained and double-click this document class or click Change. 11. Select the communication type OPEN (OLE) and the application created before. Click Continue. 12. Repeat the last two steps for all document classes that should be maintained. Afterwards click Save to save the configuration. 13. Double-click Display Stored Document. To maintain the stored documents repeat the steps described before to maintain a document class. 4.7 Support of Two Archives In SAP a document type can only be active for one content repository, but archived contents are also available if the document type is inactive ( L!=X, see chapter 4.4 Link for Content Repository ). To configure a new archive edit the link of a document type, perform the following steps: 1. Create a second content repository. See chapter 4.2 Content Repository. 2. Start the transaction OAC3. 3. To switch into edit mode click Display/Change. Installation and Configuration of Fabasoft iarchivelink 16
4. Select the line of the link that should be configured to use the new content repository and click Copy as. A new line with a copy of the link configuration is created. 5. In the new entry change the L property to something different than X. Click Continue to confirm. 6. In the original entry change the Cont.Rep.ID and Link properties. Specify the newly created content repository. 7. Click Save to save the configuration. 4.8 Enable HTTPS Communication Between SAP and the Fabasoft Folio Web Service Optionally, the communication between SAP and the Fabasoft Folio Web Service can be configured as HTTPS communication. To enable HTTPS communication the newest version of sapcrypto-library has to be installed. Download this library on the SAP marketplace (http://service.sap.com) for example. The following steps are also described in the SAP hints 510007 and 712330. 4.8.1 Installation of the SAPCRYPTO Library To install sapcrypto-library, perform the following steps: 1. Copy the files sapcrypto.dll and sapgenpse.exe, compatible to your system, in the exe folder of the SAP installation (e.g. C:\usr\sap\TST\SYS\exe\nuc\NTAMD64\). 2. Edit the file <SAPSYSTEMNAME>_<INSTANCE_NAME>_<SAPGLOBALHOST> (e.g.: TST_DVEBMGS00_sapsrv). Add the following lines in the profile directory: ssf/name = SAPSECULIB ssf/ssfapi_lib = <path to sapcrypto>\sapcrypto.dll sec/libsapsecu = <path to sapcrypto>\sapcrypto.dll ssl/ssl_lib = <path to sapcrypto>\sapcrypto.dll icm/server_port_x = PROT=HTTPS,PORT=443 Example: ssf/name = SAPSECULIB ssf/ssfapi_lib = C:\usr\sap\TST\SYS\exe\nuc\NTAMD64\sapcrypto.dll sec/libsapsecu = C:\usr\sap\TST\SYS\exe\nuc\NTAMD64\sapcrypto.dll ssl/ssl_lib = C:\usr\sap\TST\SYS\exe\nuc\NTAMD64\sapcrypto.dll icm/server_port_2 = PROT=HTTPS,PORT=443 4.8.2 Configuration in SAP Perform the following configuration steps in SAP: Installation and Configuration of Fabasoft iarchivelink 17
1. Start the Trust Manager (transaction STRUST ). 2. Right-click SSL Server and click Create. 3. Create PSEs for all instances. 4. Double-click on the (first) new entry below SSL Server. 5. A CA-certificate has to be imported. In the Certificate area, click Import certificate. Specify the path to the CA-certificate and choose the right encoding (e.g. Base64). Click Continue to save the changes. 6. Click Add to Certificate List to add the certificate to the Certificate List. 7. The CA-certificate has to be added to the SAP trust store. Click Export certificate and switch to Database. Specify the name of your CA in the field Trust Center. Note: This identifier has to start with ZZ. Otherwise the error message Choose the key from the allowed namespace will occur. Click Continue to save the changes. 8. The certificate has to be configured for an instance. In the area Own Certificate click Create a Certificate Request. This request has to be signed by a trusted CA. Click Import Cert. Response and Load local file to import the response of the trusted CA. Afterwards click Continue to save the changes. 9. Repeat the last step for all instances. 10. Right-click SSL Client (Standard) and click Create. 11. Configure the client PSE like Name=<SID>. Note: This step is very important because otherwise the SSL agent will not start. 12. For this PSE also import the CA-certificate and add the certificate to the Certificate List. 13. Save the configuration settings and restart all ICM processes. To restart the ICM processes start the transaction SMICM. Click Administration ICM Exit Hard Global : Confirm with Yes : 4.8.3 Check SSL Configuration To check the SSL configuration, perform the following steps: Installation and Configuration of Fabasoft iarchivelink 18
1. Start the transaction SMICM. 2. Click Services and verify that the HTTPS service is running. 3. If the service is not running navigate Back. Click Display All to check the log for errors. Note: Be sure that the content repository is configured to use HTTPS. See chapter 4.2 Content Repository to enable HTTPS. 5 Importing Certificates To import a generated certificate (see chapter 4.2 "Content Repository") open a command shell on the server the Fabasoft iarchivelink Services are executed and perform the following steps: 1. Change to the Fabasoft iarchivelink installation directory (e.g.: C:\program files\fabasoft\components\iarchivelink (Microsoft Windows) or /opt/fabasoft/bin/ (Linux)). Note: On Linux platforms run the following commands as fscsrv. 2. Type fscaradm DumpPutCert to display the content of the certificate that was sent by SAP. 3. Type fscaradm AcceptCert "<Subject>" (e.g.: fscaradm AcceptCert "CN=ID3") to use this certificate. 4. Type fscaradm DumpUseCert to display the content of the certificate that is in use. Note: If one Fabasoft iarchivelink Service should connect to several SAP systems it is mandatory that each certificate has a unique common name. 6 Solution Manager Integration 6.1 SLD-Registration The environment variable JAVA_HOME (path to Java) must be set. Type fscaradm PostSLDREG http://<sldserver>:<port>/sld/ds <username> <password> [<proxy> <proxy user> <proxy password>] to register your system. Example: fscaradm postsldreg http://sapserver:50000/sld/ds sldadmin sldpwd) The response should look like this (Status: 200, Status-Text: OK): Calling: "C:\Program Files\Java\jre1.6.0_06\bin\java" -cp "ThirdPartySystemXMLGenerator.jar" Installation and Configuration of Fabasoft iarchivelink 19
com.sap.lcr.tools.xmltools.thirdpartysystemxmlgenerator. FabasoftiArchiveLink.properties.tmp FabasoftiArchiveLink.template. FabasoftiArchiveLink.properties.xml Wed May 07 09:21:25 CEST 2008 ThirdPartySystemXMLGenerator - generates XML Documents to send with the SLDReg. Returncode = 0 SLDReg XML File successfull created. All variables replaced. FileUpload - Response Status: 200 FileUpload - Response Status-Text: OK FileUpload - Response-Text: 6.2 Log and Configuration Files The log and configuration files are placed in <temp-folder>/sapdata/ (e.g.: C:\WINDOWS\Temp\sapdata (Microsoft Windows) or /tmp/sapdata/ (Linux)). 7 Configuration of the Fabasoft Folio Domain To configure the Fabasoft Folio Domain, perform the following steps: 1. Open the Fabasoft Folio Web Client. 2. Navigate to the Domain Administration and click the Configuration Objects tab. Installation and Configuration of Fabasoft iarchivelink 20
3. Edit the properties of FSCSAP@1.1:DefaultConfiguration. The following fields are available: o Content Repository (SAP) This field is used to specify the identification of the SAP content repository. Enter the ID of the content repository defined in chapter 4 Configuration of the SAP System. o Default Protection (SAP) The default document protection used for objects connected to SAP ArchiveLink can be defined in this field. cdur is selected by default. c Create d Delete u Update r Read o Archive Contents Automatically This field can be used to define if writing of objects is allowed, that are stored by Fabasoft iarchivelink into an archive system by using Fabasoft iarchive. o SAP Document Class Mapping for Delivering Barcodes In this field a mapping for sending barcodes between Fabasoft Folio and SAP content classes can be configured. Object Class This field defines the object class in Fabasoft Folio. Installation and Configuration of Fabasoft iarchivelink 21
SAP Document Class The SAP document class can be specified in this field. Software Component This field defines the software component that inserted the mapping. o Object Class Mapping for Creating Objects In this field a mapping for newly stored documents between Fabasoft Folio and SAP content classes can be configured. File Extension The extension of the document to store. Object Class This field defines the object class in Fabasoft Folio. Software Component This field defines the software component that inserted the mapping. o SAP Content Repositories in Tenants This field allows to configure a mapping between an SAP content repository and Fabasoft Folio Tenant content classes. A list of multi-tenant domains can be specified with IDs of content repositories and an optional list of network addresses. Tenant In this field the Fabasoft Folio Tenant can be defined. Content Repository (SAP) In this field the SAP content repository can be defined. Network Address Patterns In this field the configuration of a network pattern for better separation options is possible. 4. Click Next to save the settings. 5. Make sure, that the configuration object is referenced in the current domain. 8 Checking the Installation To check the installation of Fabasoft iarchivelink HTTP content server perform the following steps: 1. Open a web browser and enter the following URL http://<webserver>/fscarsap/fscarsap.dll?serverinfo&pversion 2. Check the output: serverstatus="running"; servervendorid="fabasoft R&D GmbH"; serverversion="8.0"; Installation and Configuration of Fabasoft iarchivelink 22
serverbuild="114"; servertime="09:18:32"; serverdate="2008-04-04"; pversion="0045"; To check the integration of Fabasoft iarchivelink execute the SAP test SE38. Perform the following steps: 1. Start the transaction SE38. 2. Type RSCMST in the Program field and click Execute. 3. Type the ID of the content repository in the Repository field and click Execute. Installation and Configuration of Fabasoft iarchivelink 23
4. Click Execute All to execute all tests. 9 Client Configuration 9.1 Installation of SAP Control Stub on the Client Computer On each workstation that uses Fabasoft iarchivelink the SAP control stub has to be installed. Installation Prerequisites as described in chapter 2 Software Requirements : SAPGUI Microsoft Visual C++ Redistributable Package To install the stub, type the following URL in the web browser: http://<fscserver>/<fscvdir>/fscasp/content/lib/folioclientsap.msi or execute Setup\ComponentsWeb\Client\FolioClientSAP.msi from the Fabasoft installation media. 9.2 Configuration of the Fabasoft Search Dialog The window size of the Fabasoft search dialog can be configured using the following registry settings: [HKEY_CURRENT_USER\Software\Fabasoft\FSCSAP] "DialogOptions"="resizable:yes;dialogWidth:800px;dialogHeight:500px" Installation and Configuration of Fabasoft iarchivelink 24
DialogOptions is a string value. The options dialogwidth and dialogheight define the size of the Fabasoft search dialog. Installation and Configuration of Fabasoft iarchivelink 25