Configuring the XML Data Archiving Service 

You set up the XML DAS in two steps:

●      Define an archive store.

●      Create a home path for your archiving set.

Prerequisite

Defining an archive store: A prerequisite for archiving (storing the resources) is either one or more WebDAV servers or one or more directories in an appropriately secure and large file system. For a quick minimum setup (file system), start with the second bullet.

●      Choose an empty or create a new root collection in your WebDAV system.

The XML DAS authenticates against WebDAV servers using user and password set in the Destination Service of the Visual Administrator located on the AS Java of the XML DAS.

●      In case a file system is used, no such authentication takes place. Instead, the directories chosen must be accessible (read/write/create dir) for the operating system user <sid>adm in case of a UNIX system, and SAPService<sid> in case of a Windows system.

Choose an empty or create a new directory or directories and make sure they are globally mounted to all servers belonging to the AS Java running the XML DAS.

You want to store your archived data on host “myfileserver”.  Choose a name for your directory and create it on your host; for example “archive_directory”. Now you must make this new directory accessible to your AS Java.

●        For a Windows server you might have: \\myfileserver\archive_directory

●        For a Unix server you might have: /mountedfilesystem/archive_directory

To prevent unauthorized access or harmful alteration or deletion of resources or directories in the file system, give the appropriate access privileges only to SAPService<sid> or <sid>adm, respectively.

Do not manually create or delete directories or files once the archive store root directory is fixed.

Procedure

Creating a WebDAV Destination

If you are using a WebDAV system you have to create a destination in the AS Java on which the XML DAS is running. The destination points to the WebDAV server you want to use.  You must do so before you can begin using the XML DAS Administration to define an archive store.

       1.      Open the Visual Administrator of the AS Java on which the XML DAS is running.

       2.      Under Cluster, select <your server>  ® Services ® Destinations.

       3.      Choose New to create a new destination.

       4.      Enter the URL to the WebDAV Server, including the root collection you have created or reserved previously:

http://<WebDAV host>:<port>/<root collection>

       5.      Choose BASIC as authentication method.

       6.      Set User Name and Password to the communication user your WebDAV server supports.

       7.      Choose Save to activate your settings.

Defining an archive store

...

       1.      Open the XML DAS Administration as a browser application by using the following address:

http://<Host of AS Java>:<HTTP port>/DataArchivingService/DAS

 

URL for accessing the XML DAS residing on machine P4711:

http://P4711:50000/DataArchivingService/DAS

 

       2.      Login to the XML DAS Administration using a username and password dedicated to the individual administration user.

       3.      Choose Archive Store Management.

       4.      Choose Define.

       5.      Enter the properties of the new archive store:

                            a.      Archive Store: Enter an arbitrary name for the store you choose.

The archive store _TEST_ARCHIVE_STORE appears in the list of already created archive stores and is provided for test purposes. It is used together with the placeholder for the global directory <DIR_GLOBAL> on AS Java. For more information on the global directory see SAP Profile Parameters and Profiles. It should not be used for production unless you ensure that all the security aspects are met. To use this archive store, you must first create it in the file system as subdirectory testarchivestore under the global directory.

 

For example: C:\usr\sap\q2w\SYS\global\testarchivestore

 

                            b.      Description: Enter a description of the archive store.

                            c.      Default: This indicator is meant for future use only.

                            d.      Store Type: Choose the option that corresponds to the storage system you are using – WebDAV or File System.

File System

■       Windows Root: Enter the appropriate archive store root (file system only)

                                                  i.       If a server running on an operating system of the Windows syntax group belongs to your AS Java, enter the root to the storage system as it is seen from the perspective of the Windows server.

\\myfileserver\archive_directory

■       Unix Root: Enter the appropriate root. (file system only)

If a server running on an operating system of the Unix syntax group belongs to your AS Java, enter the root to the archive store as it is seen from the Unix server.

/mountedfilesystem/archive_directory

WebDAV System

■       Destinations: If you are using a WebDAV system, choose the appropriate WebDAV destination from the dropdown list. You can create destinations in the Visual Administrator. For more information follow the instructions under Creating a Destination described above. 

■       Proxy Host and Proxy Port: If the archive store is WebDAV-enabled and can be reached via a proxy, enter the information about the proxy in the fields Proxy Host and Proxy Port.

                            e.      Choose Ok.

Creating a home path

In case of archiving set XI_SEC this step is not to be carried out as described here, because this archiving set itself takes care of synchronizing its home paths.

...

       1.      In the XML DAS Administration, select Home Path Synchronization.

       2.      Enter the information for the home path:

                            a.      Home Path: Enter the home path URL. We suggest you adhere to the following convention: /<system from which to archive>/<archiving set>/

                            b.      Action: Choose Create New Home Collection.

                            c.      Archive Store: Choose the archive store under which you would like to create the home path.

Here you also have the option not to choose any archive store. If you decide to choose an archive store at this point, be aware that all subcollections will be located exactly in this archive store. If you want more flexibility and want to assign your archive stores later,  you can use the Assign archive stores function available in the XML DAS Administration. For more information see Archive Hierarchy and Store Assignment in the SAP Help Portal under Administration of the XML Data Archiving Service.

                            d.      Choose Start.

                            e.      Check the successful creation of the home path under Archive Hierarchy & Store Assignment.

 

Time-Out and Other Tuning Parameters

To maintain time-out parameters for HTTP communication with WebDAV see Additional Configuration and Tuning Parameters.