Skip to content

Home

Introduction

Development

IDEs

Services

API Explorer

Releases

Release notes

Martini Runtime

Martini Desktop

Martini Online

Feature requests

Bug reports

Martini package metadata

Martini packages were designed to be customizable in order to suit any organization's application needs. A package has 'meta-fields' that help identify, document, and configure the package's behavior during runtime.

Fields

  • Name

    This is used to identify a package within an instance. It must be unique (within the instance) and is required. Only alphanumeric characters, dashes, and underscores are allowed. This property cannot be changed once set.

    Rules and conventions for package names

    Aside from character restrictions, there are certain terms which cannot be used to name a package. Learn more about naming packages here.

  • Marketplace ID

    It's possible to upload a package to the TORO Marketplace to make it publicly available. The TORO Marketplace is Martini's official platform for sharing applications, API specifications, individual services, and more. This key will be used to uniquely identify the package there.

  • Version

    This is used to identify your package from its other variants.

  • Documentation Page

    The URL of the documentation page of a package.

  • Dependencies

    The packages that are required for a package to run. A package cannot move to the LOADED state when its dependencies are not present.

    During runtime, services and properties belonging to specified dependencies will be accessible to the dependent package. To be specific, they are accessible when a package is in the LOADED state. Modifications on dependencies will not be captured by a dependent package unless a reload occurs.

    The Required State On Start property can be configured in order to specify the bare minimum state a package should have for a dependent package to be able to start. Martini uses Apache Ivy's version matchers for this feature so you can specify a version such as [1.0,2.0], which means the package's version should be greater or equal to 1.0 and lower or equal to 2.0.

    A package is also not allowed to have cyclic dependencies.

  • State on startup

    The default state a package should be in during the instance startup.

  • Startup Services

    The services that are called when a package is started.

  • Shutdown Services

    The services that are called when a package is stopped.

Configuration

The majority of these meta-fields can be configured via the Package configuration editor, using the following steps:

  1. Stop the Martini package you want to configure if it has not been stopped yet.
  2. In the Navigator view, right click on said Martini package and click Configure from the context menu. This will launch the Package configuration editor.
  3. Edit properties as you wish.
  4. Save your changes by pressing (Martini Desktop) or clicking the Save button (Martini Online).

Configuring a Martini package

Configuring a Martini package

Specify startup and shutdown services by dragging and dropping

You can drag and drop services from the Navigator view to the Startup Services or Shutdown Services table. Only valid startup or shutdown services will be added by Martini; that is, services without required inputs or whose only input is event.

Setting startup and shutdown services via dragging and dropping

Setting startup and shutdown services via dragging and dropping