ServiceShell User's Manual  
Last update: Feb. 2011

  1. System Requirements, Installation
    1-1. Install
    1-2. Uninstall
    1-3. Update

  2. Creating, Installing, Starting Service
    2-1. Create
    2-2. Install
    2-3. Start

  3. Stopping, Uninstalling, Deleting Service
    3-1. Stop
    3-2. Uninstall
    3-3. Delete

  4. Editing Service

  5. Log & Status
    5-1. Log
    5-2. Status

 


  1. System Requirements, Installation

ServiceShell is compatible with Windows Server 2008/R2, 7, Vista, XP, 2003, 2000, NT4. (It is not possible to use in Windows 95, 98, Me because there is no service features on that OS at all.)

For Windows Vista and 7, you need to turn off the UAC (User Access Control).

1-1. Install

Log on as an administrator, run setup to install.

1-2. Uninstall

Stop and uninstall all registered services created by the ServiceShell. (Expired services are all stopped and uninstalled automatically.)

Go to the Start > Programs > ServiceShell and select Uninstall ServiceShell. (You can also uninstall it via Control Panel > Add/Remove Programs.)

1-3. Update

To update current ServiceShell with a new version (e.g. registered version),

  1. Stop all registered services created by the ServiceShell.
  2. Run new setup and install to the existing ServiceShell folder.
  3. Run ServiceShell and start services. (For expired services, you have to install again before start.)

Manual Index


  1. Creating, Installing, Starting Service

2-1. Create

Create Service

Enter your service name, application program's path, working directory, command line parameters.

The status will be changed to 'Ready'.

Terminate application and revive automatically option:

The application program will be terminated automatically at the time of system shut down process. If the system is not turned off (log-off only), the application program will be revived in 10 seconds.

Some application program handles system's end session signal and closes itself. To prevent this, you should check this option the application program to be revived automatically.

Some application program has a problem when it changed to the service - e.g. it does not allow the system shut down properly. If you encounter this problem, please check this option.

2-2. Install

Install Service

Select created service in the main window, click + toolbar button and the application program will be installed as a service.

Service will be installed as auto type with interact with desktop option by default. Please do not change this in the Service Control Manager directly.

The status will be changed to 'Stopped'.

2-3. Start

Start Service

Once the service installed as a service, you can start it.

Now your application will act as a service and will be started at boot time automatically.

In the process list, you will find the following programs are running.

ServiceShell.exe
AppShell.exe
your-application-program.exe

The status will be changed to 'Started'.

Manual Index


  1. Stopping, Uninstalling, Deleting Service

3-1. Stop

Stop Service

Select started service and click the above button.

The application will be terminated and the status will be changed to 'Stopped'.

3-2. Uninstall

Uninstall Service

Select stopped service and click - toolbar button.

Service will be removed from the system and the program data remains on the ServiceShell's database only. The status will be changed to 'Ready'.

3-3. Delete

Delete Service

Select uninstalled service and right-click on the data, select 'Delete'.

The application program data will be removed from the ServiceShell completely.

Manual Index


  1. Editing Service

Edit Service

Select service and click the above button.

Change properties and click 'Apply' button.

ServiceShell will perform several processes automatically to apply changes.

1. Stop
2. Uninstall
3. Install
4. Start

Service Execution Count

You can find the execution count at the Edit window. In the trial version, execution count is limited up to 10 times. After this, the application will not be executed as a service and will be stopped/uninstalled automatically.

Manual Index


  1. Log & Status

5-1. Log

Service Log

ServiceShell logs process results for each services. Select service data in the main window, right-click and select 'Log' to see details.

Date/Time type:

YYYY/MM/DD [HH24:MI:SS]

Log type:

EVENT : Succeeded process
ERROR : Failed process

5-2. Status

Ready: The service data is saved in the ServiceShell database. Not installed as a service to the system.

Stopped: The service is installed as a service to the system but not started.

Started: The service is installed to the system and started.

Expired (Trial version only): The service is expired and will be stopped/ uninstalled. In this status, you can't perform any action to this service. If you install the registered version, it will be changed to 'Ready' status.

Manual Index

 

Copyright 2011UInterface