A module must include a META-INF directory containing the manifest file MANIFEST.MF. For example, the manifest used by the DPS module is located at:

<ATG10dir>/DPS/META-INF/MANIFEST.MF
Manifest Attributes

You can set a number of manifest attributes to specify the module’s environment and resources:

Manifest attribute

Description

ATG-Assembler-Class-Path

The CLASSPATH to use for the assembled EAR file. This attribute overrides attribute ATG-Class-Path. If no value is set,
ATG-Class-Path is used.

ATG-Assembler-Skip-File

Files to exclude from the assembled EAR file. By excluding unnecessary files, you can reduce the size of the EAR file.

ATG-cfgNameConfig-Path

The path to the directory that contains the configuration files for the named configuration layer cfgName. These configuration files are appended to the configuration path when the named configuration layer is enabled by the -layer switch. Paths are relative to the module’s root directory.

ATG-Class-Path

A space-delimited set of paths to module resources that contain classes required by this module, either .jar files or directories. As each module is processed, the Oracle ATG Web Commerce platform adds the ATG-Class-Path value to the beginning of the EAR file’s CLASSPATH.

Paths are relative to the module’s root directory. These libraries and directories of classes are imported into the lib directory of the assembled EAR file, and added to the CLASSPATH of the EAR-level class loader.

ATG-Client-Class-Path

A space-delimited set of paths to module resources that contain classes required by the module’s client-side features.

ATG-Client-Help-Path

A space-delimited set of paths to module resources that provide Java Help help-sets to the module’s client application. For example, the DPS module has this value for the ATG Control Center help set:

help/dps_ui_help.jar

ATG-Config-Path

A space-delimited set of paths to module resources that provide Nucleus configuration files needed by the module’s application components. These can be .jar files or directories.

ATG-EAR-Module

One or more EAR files for this Oracle ATG Web Commerce module whose J2EE modules are to be included in the assembled application.

ATG-EJB-Module

One or more EJB modules for this Oracle ATG Web Commerce module to include in the assembled application.

ATG-LiveConfig-Path

A space-delimited set of paths to module resources that provide Nucleus configuration files. These configuration files are appended to the configuration path when you enable the liveconfig configuration layer.

Paths are relative to the module’s root directory. For more information about the liveconfig configuration layer, see the ATG Installation and Configuration Guide.

ATG-Nucleus-Initializer

A Nucleus pre-initializer required for this module, the name of a class that implements interface atg.applauncher.
initializer.Initializer
. This class must be in the CLASSPATH specified by attributes ATG-Class-Path or
ATG-Assembler-Class-Path. Before Nucleus starts in the assembled application EAR file, the initialize() method for each of the named classes is invoked.

ATG-Required

A space-delimited set of module names, specifying modules on which this module depends. If you specify this module when you run the application assembler, the modules listed here also are included in the application.

When the application starts, the manifests of the modules listed here are processed before the current module’s, in least-dependent to most-dependent order .

Note: You should usually set this attribute to include DSS.

ATG-Web-Module

One or more web applications to include in the assembled application for this Oracle ATG Web Commerce module.

Individual Module Resource Entries

A module’s manifest can contain one or more entries for individual resources. The manifest must include an entry for each resource that is automatically downloaded to the client. For example:

Name: help/das_ui_help.jar
ATG-Client-Update-File: true
ATG-Client-Update-Version: 3.0.2 build 42

At a minimum, a resource entry must set ATG-Client-Update-File to true. The following table shows all attributes that can be set for each resource:

Resource attribute

Description

ATG-Assembler-Import-File

Optional, specifies whether to copy the resource into EAR files.

ATG-Client-Update-File

Required, this attribute must be set to true to enable auto-downloading of the file.

SHA-Digest

Optional, a SHA digest of the file in Base-64 form, permitting checking of the resource’s version and integrity.

MD5-Digest

Optional, a MD5 digest in Base-64 form, permitting checking of the resource’s version and integrity.

ATG-Client-Update-Version

Optional, a version string that specifies the resource’s version, overriding consideration any SHA-Digest or MD5-Digest hash digest attributes that might be present.


Copyright © 1997, 2013 Oracle and/or its affiliates. All rights reserved. Legal Notices