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 Configuration Adapter of the J2EE Visual Administrator. Under Configurations choose:

apps ® sap.com ® tc~TechSrv~XML_DAS ® appcfg ® Propertysheet application.global.properties

Under the following entries enter a user name and password of your choice:

WEBDAVCLIENTUSR = <for example xmldas>

WEBDAVCLIENTPWD = <for example sap630>

·        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 SAP J2EE Engine 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 J2EE Engine.

·         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

Defining an archive store

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

http://<Host of SAP J2EE Engine>:<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 administration user.

       3.      Choose Define Archive Stores.

       4.      Choose New.

       5.      Enter the properties of the new archive store:

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

                            b.      Storage System: Enter a description of the archive store.

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

                            d.      WebDAV Root or Win Root: Enter the appropriate archive store root:

                                                  i.       If you are using a WebDAV system, enter its URL including the port and the collection to be used.

http://myWebDAVhost:1080/archive_collection

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

\\myfileserver\archive_directory

                            e.      Unix Root: Enter the appropriate root.

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

/mountedfilesystem/archive_directory

                              f.      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.

                            g.      Choose Insert Archive Store.

                            h.      Select Home to return to the home page of the XML DAS Administration and check the successful creation of the archive store with Test Archive Stores.

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 Synchronize Home Path.

       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 Insert New Home Collection.

                            c.      Context: This field is currently optional.

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

Here you also have the option to choose None. If you decide to choose an archive store at this point, be aware that all sub collections 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 Assign Archive Stores in the SAP Help Portal under Administration of the XML Data Archiving Service.

                            e.      Choose Execute.

                              f.      Select Home to return to the XML DAS Administration initial page and choose List Archive Paths to check the successful creation of the home path.

Time-Out and Other Tuning Parameters

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