Installed Files

This chapter gives a brief overview of the files installed with Web Center. Some of the files are described in greater detail in other chapters of this manual.

After installation, the files are located in the file:

  • install_path/web/webManager.zip (Windows) or

  • install_path/web/webManager.tar (UNIX).

The DirX Identity Configuration program unpacks the archive to folder

  • install_path/web/webCenter-domain

with the following subfolders:

  • api – API samples and documentation

  • endorsed – Files used by the DirX Identity Configurator to configure Web Center and deploy the Web Center applications into Tomcat.

  • samples – Sample files for Web Center’s file upload feature.

  • shared – A Java library used for single sign-on via SAP logon tickets.

  • tools – The Log Viewer tool. The tool is described in the “Utilities” chapter of the DirX Identity User Interfaces Guide.

  • webCenter – Web application files

The DirX Identity Configurator unpacks the archive again on each run, thereby overriding possible changes to files in the webCenter-domain folder.

API Samples and Documentation

The folder api includes two subfolders:

  • docs-api – The Javadoc specification of the API classes.

  • samples – Java source files showing how to use the API, and a small Windows batch file-based environment to set up and perform some API tests.See file samples/readme.html for details.

Configurator Files

The files in folder endorsed are used by the DirX Identity Configurator to

  • Complete the installation of Web Center; for example, by copying Java libraries from other DirX Identity components to the WEB-INF/lib folder.

  • Integrate Web Center with other DirX Identity components, for example by replacing placeholders in web.xml and setting passwords in password.properties.

  • Extend Tomcat’s Java classpath with jar files delivered with DirX Identity.

Context Descriptors

The context descriptors serve to integrate the Web Center applications into Tomcat and to define some configuration parameters that vary with the application.

  • selfService.xml – The context descriptor of the Self Service application.

  • webCenter.xml – The context descriptor of the main Web Center application.

    The DirX Identity Configurator replaces placeholders in the files (@DOC_PATH@) with the correct document root folder for the respective application.It also copies file webCenter.xml to Tomcat’s context descriptor folder and renames it to webCenter-domain.xml, thereby deploying the main Web Center application into Tomcat.The Self Service application, on the other hand, is not deployed by default.

Web Application Files

The webCenter folder serves as document root for the web applications.It contains two subfolders and a JSP file:

  • applets – Contains the applet for digital signing.

  • resources – Static files to be downloaded by clients (that is, browsers).

  • WEB-INF – Files that are required for request processing on the server but should not be downloaded by clients.

  • index.jsp – The application start page.

All files below the document root folder (besides the ones in subfolder WEB-INF) are subject to be downloaded by clients.Therefore, the folder should contain only those files that are intended to be served to clients.In particular, you should never put any sensitive files into the folder.

Resources Folder

The resource files are located in two subfolders:

  • build – Static files to be downloaded by clients. The URLs Web Center clients use to download the static resources vary with the Web Center version. This ensures that the static resources are downloaded anew after product upgrades, without having the end users to click refresh or empty their browser caches.

  • config – The configuration file config.js.

  • html – The source file of the customized confirmation box: confirm.html.

  • messages – Message files.

  • de – German message file message.js.

  • en – English message file message.js.

  • scripts – Javascript source files

  • main – A number of Javascript files that are downloaded by clients only as part of the file main.js, together with batch files to generate main.js anew after changes to the source files. Bundling several script files into a single large file reduces the number of HTTP requests required to load or reload a Web Center page.

  • styles – CSS style sheets.

  • large – The style sheet with large font sizes: styles.css.

  • medium – The style sheet with medium font sizes: styles.css.

  • small – The style sheet with small font sizes: styles.css.

  • help – Help files.

  • de – German help files. For each standard Web Center application, the (empty) help file itself (like WebCenterHelp.pdf) and a corresponding HTML wrapper (like WebCenterHelp.html).

  • en – English help files. For each standard Web Center application, the (empty) help file itself (like WebCenterHelp.pdf) and a corresponding HTML wrapper (like WebCenterHelp.html).

  • images – Image files.

  • bg – CSS sprites for background images. CSS sprites reduce the number of HTTP requests needed to download background images (or to check for newer versions). The file sprites.html gives an overview of the contents of the sprites.

  • logos – Company logos.

  • Other image files.

WEB-INF Folder

The application server (Tomcat) ensures that files in this folder are never served to a client. The folder contains the subfolders:

  • classes

  • log4j.properties – The log4j configuration file.

  • META-INF

  • jax-ws-catalog.xml – A configuration file for the request workflow client component of Web Center.

  • *.dtd – Document type definitions for some XML configuration files.

  • *.tld – Tag library descriptors.

  • resources

  • languages – English and German message files (text.properties) and static HTML and JSP fragments.

  • config – Configuration files.

  • bo – Struts configuration files for business objects.

  • certifications – Struts configuration files for access certifications.

  • delegation – Struts configuration files for old delegations.

  • delegations – Struts configuration files for new delegations.

  • functionalUsers – Struts configuration files for functional users.

  • identity – Struts configuration files with basic definitions and for login actions, and the main menu definition file.

  • imports – Struts form bean fragments which are imported by other form beans.

  • links – Struts configuration files for object selections.

  • personas – Struts configuration files for personas.

  • policies – Struts configuration files for password policies and provisioning rules.

  • privileges – Struts configuration files for roles, permissions, groups and accounts.

  • tools – Struts configuration files for reports.

  • userFacets – Struts configuration files for user facets.

  • users – Struts configuration files for users.

  • workflows – Struts configuration files for request workflows and tasks.

    In addition to that, the folder contains the following files:

  • converters.properties – Web Center user interface configuration file.

  • defaultRenderer.properties – Web Center user interface configuration file.

  • filters-config.xml – Configuration file for search filters with DN syntax attributes.

  • messages.properties – A mapping of some low-level error messages to message keys; a last resort to localize internal messages and display them with a more user-friendly text.

  • objects-config.xml – Web Center user interface configuration file.

  • paths.properties – Some lists of Struts actions and JSPs.

  • renderers-config.xml – Web Center user interface configuration file.

  • request.properties – A list of variables to be removed from request scope before processing an action.

  • session.properties –Lists of session attribute names used to initialize and clean-up sessions.

  • validation.xml – Struts forms validation configuration file.

  • validator-rules.xml – Struts forms validation configuration file.

  • webCenter.properties – High-level configuration file to control some features of Web Center.

  • configPwd – Configuration files variants for the Web Center for Password Management application.

  • identity – Struts configuration files with basic definitions and for login actions, and the main menu definition file.

  • users – Struts configuration files for users.

  • configSelf – Configuration files variants for the Self-Service application.

  • identity – Struts configuration files with basic definitions and for login actions, and the main menu definition file.

  • users – Struts configuration files for users.

  • jsp – Java Server Pages.

  • controller – JSPs performing the application’s business logic.

  • data – JSPs generating XML formatted data responses to asynchronous HTTP requests.

  • view – JSPs generating the user interface.

  • lib – Java libraries for Web Center applications. Note that all jar files in the folder are automatically loaded at runtime. If you put a newer version of a jar file into the folder, remove the old one from this folder, but don’t just rename it.

  • snippets – HTML and Javascript code snippets for user interface controls.

In addition to that, the folder contains two files:

  • password.properties – The passwords required to access other DirX Identity components, keystores and truststores. The file is changed by the DirX Identity Configuration program. Passwords entered in cleartext will be encrypted on application restart.

  • web.xml – The application’s deployment descriptor. The file is changed by the DirX Identity Configuration program.