Skip to content

ZFC Server Installation

Introduction#

The ECMP ZFC Server is an Java Enterprise application that must be deployed on an IBM WebSphere Server. Is is packaged as an EAR-file containing all the necessary deployment and runtime artifacts. The latest version of this file can be requested from ECM Partners.

When you install the application it must be bound to the root context of your application server(/). The actual URL the clients will use will not use the root context of your application server as the base context. However, Windows Explorer will still make requests to the root context of your application server and also expect an answer for these requests. Therefore you have to make sure that there is not already an application present which is bound to the root context of your application server. In that case you should consider moving that application to a dedicated context.

Installing the application#

You can use the WebSphere console or your other preferred installation method to deploy the EAR-file. After the installation of the EAR-file is completed you have to attach the shared library you defined in this step to the application and map the security roles to the special subjects. For these task you have to complete these steps:

  • Login to the WebSphere console.
  • Navigate to Applications > WebSphere enterprise applications and open the ZFC Server application.
  • In the References section select Shared library references.
  • Select the checkbox before the module ECMP ZFC WebDAV Server Application.
  • Select Reference shared libraries.
  • In the new Shared library Mapping page move the library ZFCClientLibraries to the right and press the OK button.
  • Also press the OK button in the Shared library references page.
  • (Don't press te Save button yet)
  • In the Detail Properties section select Security role to user/group mapping.
  • Check the Authenticated role and select All Authenticated in Application's Realm when pushing the Map Special Subjects button.
  • Check the Everyone role and select Everyone when pushing the Map Special Subjects button.
  • Press the OK button
  • Save your configuration changes to the master configuration.
  • Return the applications list and start the ECMP ZFC Server application.
  • Check the server logs for any errors.

Testing the application#

You can test your installation by using a webbrowser to navigate to the URL you configured in the application configuration. First you will be prompted to supply credentials to login to your Content Engine Server. Next a webpage will show the structure of your Object Store(s) where you will be able to browse through the different folders and collections.

Note

For this to work your browser should not disable Basic Authentication. For the Microsoft Edge browser you can check this by navigating to the edge://policy/ page and checking for the entry AuthSchemes.