Glossary term: AppConfigId

Uniquely identifies a particular deployment of an App.

UBOS Gears identifies each Deployment of any App at any Site (called an AppConfiguration) with a unique identifier, called the AppConfigId, which consists of an a and a long hexadecimal number.

For example, aa6b76deec72fc2e86c812372e5922b9533ca2d58 is a valid AppConfigId.

An AppConfigId establishes the identity of the AppConfiguration and remains persistent even if the AppConfiguration’s Context Path is changed, or the AppConfiguration is moved to an entirely different Site.

AppConfigIds are used with UBOS Gears commands that refer to a particular AppConfiguration.

To determine an AppConfiguration’s AppConfigId, execute:

% sudo ubos-admin listsites --detail

Because AppConfigIds are long and unwieldy, many UBOS Gears commands allow the use of only the first few characters, as long as they are unique on the Device, and you append three periods at the end in lieu of the remainder.

For example, if there is no other AppConfiguration installed on your Device and the AppConfigId you wish to specify is the one shown above, you can use aaa..., aa6b76dee... or even a... as a shorthand.

Many commands also accept the Hostname of the Site at which the AppConfiguration is deployed, plus the AppConfiguration’s Context Path instead of the AppConfigId.