This file lists all the applications on the host managed by
the Framework. It provides information on applications that the Framework
requires.
The format is a tabbable TextTable (you can tab everything
out to make the columns line up, making it more readable). You can comment
lines out with a hash ‘#’. The file is intended to be manually modified, the
bare minimum required to run your code is adding a row for your library (DLL).
“ApplicationId” is a key used to identify applications, the
project name is a good option. “Directory” is where the application lives.
There a 4 “ApplicationTypes” that we will run through next. Hosted is specific
to “Service” and “Web” application types and not required for the others.
ApplicationType
|
Description
|
“Hosted” Meaning
|
Service
|
Service Process (Windows Service) permanently running from when the
OS starts
|
Either just the OS service name or the service name followed by a
colon “:” then a port number. OS service name is required by the Framework
for management. The port number is required if you are using a Framework
managed service with configurable tasks. If you have your own Service that
you just want to monitor if it’s running or not then don’t use the port
number.
|
Web
|
Web Service or UI Web (Web Site or Intranet)
|
The Application Pool this web is running under. Required by the
framework for management.
|
Process
|
Standard Windows process (Console Application), you could also
include other application types, like Windows Forms
|
N/A
|
Lib
|
Class Library or DLL (Dynamic Link Library). Where you put your code!
|
N/A
|
“Service” and “Web” application types and managed by the
system, you can monitor there running state and start and stop them, this is what
they require the “Hosted” column for.
In contrast “Process” and “Lib” application types are not
managed, they do not appear on the Status page, the Framework just needs to
know where they are for updating through the Release system.
Example Applications.txt file, notice the 3 rows added to
the end, this could represent a business logic library, an Intranet, and a
public web site:
ApplicationId
|
Directory
|
ApplicationType
|
Hosted
|
String*
|
String
|
String
|
String
|
Spludlow-Service
|
C:\Program Files\SpludlowV1\Spludlow-Service
|
Service
|
Spludlow-ServiceV1:32100
|
Spludlow-WebService
|
C:\Program Files\SpludlowV1\Spludlow-WebService
|
Web
|
Spludlow-WebServiceV1
|
Spludlow-WebService-Admin
|
C:\Program Files\SpludlowV1 Admin\Spludlow-WebService-Admin
|
Web
|
Spludlow-WebService-AdminV1
|
Spludlow-Process
|
C:\Program Files\SpludlowV1\Spludlow-Process
|
Process
|
|
MyCompLib
|
C:\Program Files\SpludlowV1\MyCompLib
|
Lib
|
|
MyCompIntranet
|
C:\Program Files\SpludlowV1\MyCompIntranet
|
Web
|
MyCompIntranet
|
MyCompWeb
|
C:\Program Files\SpludlowV1\MyCompWeb
|
Web
|
MyCompWeb
|