Developers Documentation



301 error for file:

User Tools

Site Tools

Anatomy of an App

This document provides a technical review of a ClearOS app:

  • Where files are installed
  • Packaging information
  • Naming conventions

Naming Conventions

Every app has a simple basename that is used as a keyword across various systems. For example, the PPTP Server uses the basename pptpd.

Bug TrackerList of issues
TranslationsPPTP en français

… and many others.

File and Directory Locations

An app uses the traditional Linux file system layout, so you can find an app installed in the locations defined in the following table.

/etc/clearos/basenameFileSimple configuration file (optional)
/etc/clearos/basename.dDirectoryConfiglet files (optional)
/usr/clearos/apps/basename/DirectoryCore software, libraries and GUI (required)
/var/clearos/basenameDirectoryState files (optional)

Two Software Packages: Core Libraries and GUI

In many circumstances, a ClearOS app may need to use a library from another app. For example, the PPTP Server requires bits and pieces from the Samba library. For this reason, every app is packaged into two distinct RPMs:

  • app-basename-core: core libraries
  • app-basename: GUI frontend

When the PPTP Server is installed, it will pull in the app-samba-core library, but not the whole Samba GUI frontend.

content/en_us/dev_architecture_anatomy_of_an_app.txt · Last modified: 2015/03/03 11:07 (external edit)