5 Setting Up Your Application
5.2 Setting up Delivery Units
A delivery unit is a collection of packages that are to be transported together. You assign all the packages belonging to your application to the same delivery unit to ensure that they are transported consistently together within your system landscape. Each delivery unit has a unique identity.
The identity of a delivery unit consists of two parts: a vendor name and a delivery-unit name. The combined ID ensures that delivery units from different vendors are easy to distinguish and follows a pattern that SAP uses for all kinds of software components.
To create and manage delivery units you first need to maintain the identity of the vendor, with whom the delivery units are associated, and in whose namespace the packages that make up the delivery unit are stored. As part of the vendor ID maintenance process, you must perform the following tasks:
1. Understand delivery units
You must be familiar with the conventions that exist for delivery-unit names and understand the phases of the delivery-unit lifecycle.
2. Maintain details of the vendor ID associated with a delivery unit.
Delivery units are located in the namespace associated with the vendor who creates them and who manages the delivery-unit's lifecycle.
3. Create a delivery unit. Related Links
Maintaining the Delivery-Unit Vendor ID [page 39]
In SAP HANA, the vendor ID is used primarily to define the identity of the company developing a software component that they plan to ship for use with SAP HANA. If you want to create a delivery unit, it is a prerequisite to maintain a vendor ID in your system.
Creating a Delivery Unit [page 40]
A delivery unit is a group of transportable objects used for content delivery. You can use a delivery unit to
transport the design-time objects that are stored in the SAP HANA repository between two systems, for example, from a development system to a consolidation system.
5.2.1
Maintaining the Delivery-Unit Vendor ID
In SAP HANA, the vendor ID is used primarily to define the identity of the company developing a software component that they plan to ship for use with SAP HANA. If you want to create a delivery unit, it is a prerequisite to maintain a vendor ID in your system.
Before creating your first own delivery unit you must set the identity of the vendor in the development system's configuration. To maintain details of the delivery-unit vendor ID, perform the following steps:
1. Start the SAP HANA studio.
2. Switch to the Administration Console perspective.
In the SAP HANA studio's Navigator view, select the desired system, and choose Administration from the context-sensitive menu. Alternatively, use the menu path: Window > Open Perspective > Administration Console .
3. Display configuration details for the SAP HANA instance; choose the Configuration tab page. 4. Maintain details of the vendor ID.
In the Configuration tab page, perform the following steps:
a) Locate indexserver.ini in the list of configuration files displayed in the Name column. b) Expand the indexserver.ini entry.
c) Expand the repository entry. d) Edit the content_vendor parameter.
e) Double-click content_vendor and enter the name of your vendor. Note that guidelines and conventions exist for vendor names.
Note
We recommend that you use your DNS name to set the vendor ID, for example, acme.com. f) Save your changes.
5.2.2 SAP HANA Delivery Unit Naming Conventions
In SAP HANA, conventions and guidelines exist for the naming of delivery units (DU). The delivery unit is the vehicle that lifecycle management (LCM) uses to ship one or more software components from SAP (or a partner) to a customer. The DU is also the container you use to transport application content in your system landscape. If you are creating a delivery unit, you must adhere to the following naming conventions
● The name of a delivery unit must contain only capital letters (A-Z), digits (0-9), and underscores (_) ● You cannot use an underscore (_) as the first character of a delivery-unit name.
Note
The naming conventions for packages in a delivery unit differ from the naming conventions that apply to the delivery unit itself. For example, the maximum length of a package name is not restricted to 30 characters; it must be less than 190 characters (including the namespace hierarchy).
5.2.3 Creating a Delivery Unit
A delivery unit is a group of transportable objects used for content delivery. You can use a delivery unit to
transport the design-time objects that are stored in the SAP HANA repository between two systems, for example, from a development system to a consolidation system.
Note
You cannot create a delivery unit unless you have already defined the delivery unit's vendor ID; the vendor ID defines the namespace in which the new delivery unit resides.
To create a new delivery unit, perform the following steps: 1. In the SAP HANA studio, start the Modeler perspective.
2. In the Setup screen area of the Quick Launch tab, choose Delivery Units.... 3. Create a new delivery unit.
In the Delivery Units dialog, choose Create...
4. Maintain delivery unit details.
a) Enter a name for the new delivery unit. The delivery unit Name is mandatory. b) Fill in the other information as required:
Note the following points when entering information:
○ The name of the Vendor is set to the vendor ID that is specified in the system configuration, for example, acme.com.
○ The Responsible text box enables you to specify the name of the person responsible for managing the delivery unit.
○ In the text boxes Version, Support Package Version, and Patch Version enter integer values only; the combined values define the version of the delivery unit that is currently being developed. For example, enter Version = 1, Support Package Version = 3, and Patch Version = 17 to specify that the current version of your delivery unit is 1.3.17. The version number is transported to other systems with every DU transport.
Note
The numbers you enter here refer to the application component that you are developing; the numbers do not refer to the patch or service-pack level deployed on the SAP HANA server. ○ The PPMS ID is the product ID used by the SAP Product and Production Management System
(PPMS).
Note
Customers and partners should leave the PPMS ID text box empty. Related Links
Maintaining the Delivery-Unit Vendor ID [page 39]
In SAP HANA, the vendor ID is used primarily to define the identity of the company developing a software component that they plan to ship for use with SAP HANA. If you want to create a delivery unit, it is a prerequisite to maintain a vendor ID in your system.
SAP HANA Delivery Unit Naming Conventions [page 40]
In SAP HANA, conventions and guidelines exist for the naming of delivery units (DU). The delivery unit is the vehicle that lifecycle management (LCM) uses to ship one or more software components from SAP (or a partner) to a customer. The DU is also the container you use to transport application content in your system landscape.