Defining applications  Chapter 4: Defining Components

Chapter 3: Managing Applications and Packages in EAServer Manager

Defining packages

In EAServer Manager, a package contains a group of related components. Typically, components in a package work together to provide a coherent service or function.

NoteRefresh when you modify a package, component, or method When you modify an existing package, component, or method, you must refresh the server, package, or component for the changes to take effect. To refresh, highlight the icon for the server, package, or component and select File | Refresh. If you modify a component’s supported interfaces, you must regenerate stubs and skeletons for the component and clients that access the component.

You must install your components in packages before applications can access the components. Packages serve the following purposes:

Use EAServer Manager to create, modify, and delete packages, as described in the sections below:

You can also export and import package archives in the standard EJB-JAR format or in the Jaguar JAR format. For details, see Chapter 9, “Importing and Exporting Application Components,” in the EAServer System Administration Guide.


Creating a new package

StepsCreating a new package

  1. Start EAServer Manager if it is not running, and connect to your server.

  2. Expand the EAServer Manager icon.

  3. Highlight the Packages icon.

  4. Select File | New Package.

  5. Enter the name of the new package. The name must not match any existing package defined in the EAServer repository. To avoid name collisions, you can use the Java reverse domain naming style; for example, “com.foo.finance.”

  6. Supply the package information. The properties are described in “Configuring package properties”.

The new package appears on the right side of the screen when you highlight the package icon.

NotePackage names must begin with a letter, are not case sensitive, and must be unique Package names must be unique among other packages in the same EAServer installation, and begin with a letter.

Names are not case sensitive. Your packages must have unique names that differ in ways other than letter case. For example, you cannot define two packages named MyPack and mypack in the same EAServer installation. You cannot have two packages with the same name, even if one is installed in an application and the other is not.

StepsCopying package definitions

Use the Copy item in the package Edit menu to create a copy of a package. EAServer Manager creates a copy of the package definition and the definitions of the components it contains. You can modify the new package and component properties without affecting the original. However, the copied and original definitions refer to the same IDL interfaces and implementation files.

You cannot copy packages that are installed in an application. Packages that appear in the top-level Packages folder can be copied as follows:

  1. In the top-level Packages folder, highlight the icon for the package to be copied.

  2. Choose File | Copy.

  3. Enter a unique name for the new package and click Ok.

  4. EAServer Manager creates a copy with the specified name.

NoteThe Paste command in the package Edit menu pastes copied component definitions. See “Copying and pasting components”.


Installing packages to a server

Except for packages used internally by EAServer, packages to be run on a server must be installed in that server, using one of two methods:

Packages that you create must be installed in a server before that server’s clients can access components in the package.

You can only install a package in one application. Once a package is installed in an application, it cannot be installed directly in a server.

Default packages EAServer includes a set of default packages that include components used internally by EAServer. These packages are available whether or not they are installed to a server’s Packages folder. These include the packages: CosConcurrencyControl, CosNaming, CosTransactions, CtsComponents, CtsSecurity, DataWindow, EncinaInternal, EncinaOTS, JTS, Jaguar, JaguarOTS, JaguarProxy, JaguarServlet, OtsAdmin, PBDebugger, Proxy, TranLog. The list of default packages is subject to change without notice.

StepsInstalling packages

  1. Double-click the Servers folder to expand it.

  2. Double-click the server (listed on the left side of the screen) to which you want to install a package.

  3. Highlight the Installed Packages icon. A list of installed packages appears on the right.

  4. Select File |Install Package. Then select one of the following options from the Package Wizard:


Modifying packages

StepsModifying an existing package

  1. Highlight the package you want to modify. You can highlight the package icon displayed in a server’s package folder or in the main Packages folder (both icons represent the same package as long as the package names are identical).

  2. From the File menu, select one of the following options:

NoteDefault packages cannot be modified or deleted EAServer’s default packages cannot be modified or deleted, and you cannot modify or delete components installed in default packages. These components are run internally by EAServer. See “Default packages” for more information.


Configuring package properties

The Package Properties window has two tabs, General and Advanced.


Package properties: General

The following table describes the properties on the General tab.

Table 3-1: Package properties: General tab

Property

Description

Comments/example

Description

A description of the package. The description can be up to 255 characters.

View or change the description of an existing component or set the description of a new one.


Package properties: Java Classes

This tab allows you to define a custom class list shared by all components that are installed in the package. See “Custom class lists for packages, applications, or servers” for more information.


Package properties: Additional Files

Configures the com.sybase.jaguar.package.files property, which specifies additional files that are to be archived when the package is exported or replicated to another server with the synchronize feature. By default, the file set includes the files associated with components in the package.

The rules for setting this property are the same as for the com.sybase.jaguar.component.files component property. See “Component properties: Additional Files” for more information.


Package properties: Role Mapping

These settings map role names used in EJB components to role names that exist in EAServer Manager.

StepsMapping a J2EE role to an EAServer role

  1. If necessary, define a new EAServer role as described in “Configuring EAServer roles” in the EAServer Security Administration and Programming Guide for instructions.

  2. Select the Role Mapping tab from the Web application properties window.

  3. Click Add. Double-click the J2EE role and enter a name. You can also enter a description for the role in the provided field.

  4. Select an EAServer role from the drop-down list. This is the role from which the J2EE role inherits its permissions and members.


Package properties: JAXP Support

Configures the default JAXP, DOM, and XSLT parser implementations used by EJB components in the package. See Chapter 36, “Configuring Java XML Parser Support,”for more information on these properties.


Package Properties: Advanced

The Advanced tab allows you to edit package property settings as they are stored in the EAServer configuration repository. You can only delete properties that you have added—you cannot delete default properties, such as the com.sybase.jaguar.package.name property.

For information on repository properties, see Appendix B, “Repository Properties Reference,” in the EAServer System Administration Guide.

StepsSetting properties

  1. Look for the property name in the list of properties. If it is displayed, highlight the property and click Modify. Otherwise, click Add.

  2. If adding the property, fill in the Add Property fields as follows:

  3. If modifying a property, edit the displayed value in the Modify Property window.

NoteWhen to use the Advanced tab Though you can use the Advanced tab to set any property prefixed with com.sybase.jaguar.package, Sybase recommends that you use this tab to set properties only as specified by the EAServer documentation or by Sybase Technical Support. Most properties can be configured graphically elsewhere in the EAServer Manager user interface.





Copyright © 2005. Sybase Inc. All rights reserved. Chapter 4: Defining Components