Index SD-UX Mkpkg Mkbdl Glossary
SD-UX elements: bundle product subproduct fileset vendor

Products

  1. Overview
  2. Fields
    1. Attributes
    2. Control Scripts

Overview

The product is the top-level container for all bits associated with a single software package. It can contain both subproducts and filesets. Small software packages will often have a single fileset and a single subproduct, but larger packages may have many filesets and subproducts.

If you are using mkpkg, then you are building a Software Distributor product.

Fields

Attributes

tag
The identifier for the product. It appears on the Software Selection window as the basic name for the product.

limit 16 characters. Type tag_string/version_component

title
The one-line, more detailed name for the product. It appears on the Software Selection window. This attribute will be seen often so it should clearly and consisely describe the product.

limit 80 characters. Type one_line_string

description
A file or text string describing the product. The free-form ASCII style allows for a detailed description of your software.

limit 2kB characters. limit 72 characters/line. Do not use <TAB> characters. Type multi_line_string

copyright
A file or text string describing the copyright restrictions for the product. This is required for legal reasons.

limit 8kB characters. limit 72 characters/line. Do not use <TAB> characters. Type multi_line_string

readme
A file describing the product.

limit 1MB characters. limit 72 characters/line. Do not use <TAB> characters. Type multi_line_string

revision
The revision (release) number of the product. The revision field is a string consisting of a series of dot-separated fields. Revision numbers are often compared to determine relative position within release cycles. The basic strategy for comparison is:
  1. field by field, left to right
  2. smaller "numbers" specify older revisions
  3. ASCII comparison (0<A<a), if the revision number contains non-numeric characters
  4. number comparison (shorter numbers padded with trailing 0s), if the revision number contains only digits
Type revision_string/version_component
architecture
The target system for which this bundle is intended. Summarizes the supported hardware and operating systems.

There are three parts of the architecture attribute: OS, OS revision, and machine type. The attribute is structured like:

<OS>_<OS revision>_<machine type>

The OS is always "HP-UX".

The OS revision is different for ISU and Core software. For Core software (BSU's and CSU's) the OS revision is identical to the revision attribute, so the architecture attribute changes for each HP-UX release. For ISU software the OS revision is the minimum OS revision necessary to run the software. For example, if the software runs on 10.00 and 10.10, then you would specify B.10.00.

The machine type can only have three values:
700 runs on series 700 only
800 runs on series 800 only
700/800 runs on either series 700 or series 800

limit 80 characters. Type one_line_string/version_component

machine_type
machine types on which the bundle will run (uname -m). May use shell pattern matching to cover a range of machine types. Some examples:
9000/7?? series 700 only
9000/[68]?? series 800 only
9000/[678]?? series 700 and series 800

limit 64 characters. Type uname_string

os_name
OS'es on which the bundle will run (uname -s)

HP-UX

limit 32 characters. Type uname_string

os_release
OS releases on which the bundle will run (uname -r). May use shell pattern matching to cover a range of releases. Some examples:
?.10.* any 10.0 release
?.10.*|?.11.* any 10.0 or 11.0 release

limit 32 characters. Type uname_string

os_version
OS versions on which the product will run. May use shell pattern matching to cover a range of releases.
* Allow all versions

limit 32 characters. Type uname_string

directory
The default, absolute pathname of the direcotry which is the root of the file system tree under which the product will be installed. Can be re-mapped by the user if is_locatable is TRUE.

For information on configuring software please see the Software Porting and Configuration Guide (for non-HP software), or the HP Guidelines (for HP software)

Type path_string/version_component

is_locatable
A boolean, which if set to TRUE, allows users to install the product into an alternate product directory.

Type boolean

share_link
An optional attribute which tells SD-UX that the product may be link-installed for diskless support. The attribute contains one or more pathnames which are share link points for this product. The pathnames are always relative to the application install directory. For more details, see NFS Diskless Concepts and Administration.

Type boolean

number
The HP part number for the software, such as J2326AA

Limit 32 characters. Type tag_string

category
The short name for the software category

limit 16 characters. Type tag_string/version_component

category_title
A descriptive title for the software category. This attribute is automatically set by mkpkg based on the value of the category attribute.

Limit 80 characters. Type one_line_string

Control Scripts

Products may have control scripts which are executed during various phases of software installation/deinstallation. Both products and filesets may have associated control scripts. SD-UX defines a standard set of control script attributes and functions. For more information, please see Control Scripts.

Mkpkg has the ability to automatically generate control scripts for various customization and configuration actions. For more information, please see Mkpkg.


(C) Copyright 1994, 1995, 1996 Hewlett-Packard Company