---
name: "appmgr"
section: "8"
platform: "linux"
package: "boinc-server-maker"
version: "7.0.27+dfsg-5"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/appmgr"
---

# appmgr(8)

Tool to manage applications and platforms

## NAME

appmgr - Tool to manage applications and platforms

## SYNOPSIS

**appmgr**  list \[**--no-versions**\] **appmgr**  add *NAME* *DESC* \[**--hr=no** \| **--hr=fine** \| **--hr=coarse**\] \[**--beta**\] \[**--weight=***NUM*\] \[**--target\_nresults=***NUM*\] **appmgr**  delete *NAME* \[**--version=***VER*\] \[**--platform=***NAME*\] \[**--plan\_class=***NAME*\] **appmgr**  update *NAME* \[**--hr=no** \| **--hr=fine** \| **--hr=coarse**\] \[**--beta** \| **--no-beta**\] \[**--weight=***NUM*\] \[**--target\_nresults=***NUM*\] \[**--user\_friendly\_name=***DESC*\] \[**--min\_version=***VER*\] \[**--deprecated** \| **--no-deprecated**\] **appmgr**  update\_appver *NAME* \[**--version=***VER*\] \[**--platform=***NAME*\] \[**--plan\_class=***NAME*\] \[**--deprecated** \| **--no-deprecated**\] \[**--min\_core\_version=***VER*\] \[**--max\_core\_version=***VER*\] **appmgr**  list\_platform \[**--short**\] **appmgr**  add\_platform *NAME* *DESC*  **appmgr**  delete\_platform *NAME* \[**--force**\] **appmgr**  update\_platform *NAME* \[**--user\_friendly\_name=***DESC*\] \[**--deprecated** \| **--no-deprecated**\] **appmgr**  add\_standard\_platforms  **appmgr**  {**-h** \| **--help**}

## DESCRIPTION

**appmgr** is a tool to manage platforms, applications and application versions from the command-line.

Note: *application* refers to data in the FCappF\[0\] table; *application version* refers to data in the FCapp\_versionF\[0\] table and in the file system.

## COMMANDS

The generic syntax is:

**appmgr**  COMMAND \[*command arguments*\]

Note that command-specific options must came after the command, never before. Here is a short list of the available commands. The following sections describe the commands in detail.

- list

  List the installed applications and application versions.

- add

  Add a new application.

- delete

  Delete an application or application version.

- update

  Update the properties of an application.

- update\_appver

  Update the properties of an application version.

- list\_platform

  List the platforms known to the project.

- add\_platform

  Add a new platform.

- delete\_platform

  Delete a platform.

- update\_platform

  Update the properties of a platform.

- add\_standard\_platforms

  Add all standard platforms to the project.

### LIST

List the installed applications and application versions, together with any non-default properties (beta, deprecated, min. core version etc.). If the FC**--no-versions**F\[0\] option is specified, then the list of application versions is omitted and just the application definitions are listed.

### ADD

Add a new application. *NAME* is the short name of the application as used in the file system. *DESC* is the user-friendly name that is displayed to users.

The following options can also be specified:

- FC**--hr=no**F\[0\], FC**--hr=fine**F\[0\], FC**--hr=coarse**F\[0\]

  Set the homogeneous redundancy class. FCnoF\[0\] means all hosts are equivalent, FCfineF\[0\] means fine-grained classification of 80 classes, FCcoarseF\[0\] means coarse classification of 4 classes.

- FC**--beta**F\[0\]

  Indicate that this is application is in beta testing. Users can select if they are willing to test applications marked as beta in their preferences; see the wiki section "Beta-test applications" about how to enable this on the web interface.

- FC**--weight=**F\[0\]*NUM*

  Specify the weight of this application if the feeder is run with the FC**-allapps**F\[0\] option. *NUM* is a floating-point value, the default is 1.

- FC**--target\_nresults=**F\[0\]*NUM*

  Set the number of replicas when an otherwise unreplicated work unit is sent to a host that is not trusted. See the wiki section "Adaptive replication" for details.

### DELETE

Delete applications or application versions. This command deletes both the database records and the files under the FC*download*F\[0\] and FC*apps*F\[0\] directories, so use with care.

The following options can be specified:

- FC**--version=**F\[0\]*VER*

  Select only application versions with the version number *VER*. The version number must be specified as FCmajor.minorF\[0\].

- FC**--platform=**F\[0\]*NAME*

  Select only application versions for the platform *NAME*.

- FC**--plan\_class=**F\[0\]*NAME*

  Select only application versions having the plan class *NAME*.

If more than one of the options FC**--version**F\[0\], FC**--platform**F\[0\] and FC**--plan\_class**F\[0\] are specified, then only application versions matching all the criteria are deleted. If none of these options are specified, then the application is also deleted. Note that if one or more of these options are specified then the application is not deleted even if there are no more application versions remaining.

### UPDATE

Update the properties of an application. The following properties can be modified:

- FC**--hr=no**F\[0\], FC**--hr=fine**F\[0\], FC**--hr=coarse**F\[0\]

  Set the homogeneous redundancy class. FCnoF\[0\] means all hosts are equivalent, FCfineF\[0\] means fine-grained classification of 80 classes, FCcoarseF\[0\] means coarse classification of 4 classes.

  **Warning**

  Do not change the homogeneous redundancy class while there are jobs in progress!

- FC**--beta**F\[0\]

  Indicate that this is application is in beta testing. Users can select if they are willing to test applications marked as beta in their preferences; see the wiki about how to enable this on the web interface.

- FC**--no-beta**F\[0\]

  Indicate that the application is no more in beta testing.

- FC**--weight=**F\[0\]*NUM*

  Specify the weight of this application if the feeder is run with the FC**-allapps**F\[0\] option. *NUM* is a floating-point value, the default is 1.

- FC**--target\_nresults=**F\[0\]*NUM*

  Set the number of replicas when an otherwise unreplicated work unit is sent to a host that is not trusted. See the wiki article on "Adaptive replication" for details.

- FC**--user\_friendly\_name=**F\[0\]*DESC*

  Update the user-friendly description of the application.

- FC**--min\_version=**F\[0\]*VER*

  Set the min. version of the application that the scheduler accepts. This is checked only if the client uses the FCanonymousF\[0\] platform. The version number must be specified as FCmajor.minorF\[0\].

- FC**--deprecated**F\[0\]

  Indicate that the application is deprecated. The feeder will then ignore this application when looking for new work.

- FC**--no-deprecated**F\[0\]

  Remove the deprecation mark from the application.

### UPDATE\_APPVER

Update the properties of an application version. The version(s) to operate on can be specified with the FC**--version**F\[0\], FC**--platform**F\[0\] and FC**--plan\_class**F\[0\] options, as described at the FCDELETEF\[0\] command.

The following properties can be modified:

- FC**--min\_core\_version=**F\[0\]*VER*

  Set the min. version of the core client that is required to run this application version. The version number must be specified as FCmajor.minorF\[0\]. The 3rd component (the patch level) of the core client version is ignored.

- FC**--max\_core\_version=**F\[0\]*VER*

  Set the max. version of the core client that is allowed to run this application. Note that the scheduler ignores this setting currently.

- FC**--deprecated**F\[0\]

  Indicate that the application version is deprecated. The feeder will then ignore this version when looking for new work.

- FC**--no-deprecated**F\[0\]

  Remove the deprecation mark from the application version.

### LIST\_PLATFORM

List the platforms known to the project. If the FC**--short**F\[0\] option is specified, then only the short names of the platforms are listed.

### ADD\_PLATFORM

Add a new platform. *NAME* is the short name of the platform that is used in the scheduler requests. *DESC* is the user-friendly name that is displayed to users.

### DELETE\_PLATFORM

Delete a platform. If the FC**--force**F\[0\] option is specified, the command deletes all application versions for this platform. Otherwise, if there are such application versions, the command will fail.

### UPDATE\_PLATFORM

Update the properties of a platform. The following properties can be modified:

- FC**--user\_friendly\_name=**F\[0\]*DESC*

  Update the user-friendly description of the platform.

- FC**--deprecated**F\[0\]

  Indicate that the platform is deprecated. The feeder will then ignore this platform when looking for new work.

- FC**--no-deprecated**F\[0\]

  Remove the deprecation mark from the platform.

### ADD\_STANDARD\_PLATFORMS

Add all the standard platform definitions to the database that do not exist yet.