====== MDE Service ======

<note>**Outdated**\\ \\
This chapter was only valid for the beta releases 0.0.8 and 0.0.9. In current versions the service is installed and uninstalled automatically by the MSI installer.
</note>

The MDE Server can be run either as standalone executable, by using the Icon in the start menu, or as a Windows Service. The advantage of running as a service is that the server will be started up automatically at boot even is nobody logs in, and it is still available after logging out.

The server is implemented in the executable mdeserver.exe in the bin directory of the BPS installation folder. This executable also contains the code to install itself as a service and do some administrative service tasks.


===== Special Requirements of Windows 7 =====

In Windows 7 with UAC enabled, any program that installs/uninstalls or starts/stops a service needs special privileges. The simplest way to achieve this is to open a command window with Administrator privilege:

{{ :bps2:mdeserver:img-1011.png }}

Change into the bin directory of the BPS installation folder:

{{ :bps2:mdeserver:img-1012.png }}

Now Windows 7 also has a firewall that needs to know about the application. The easiest way to open the firewall is to start the the server first as normal application:

    C:\Program Files\IBK Software AG\BPS V2\bin>mdeserver -e

The firewall will now ask for permission:

{{ :bps2:mdeserver:img-1013.png }}


===== Online Help =====

Start the program with the switch -h to get a list of options:

    C:\Program Files\IBK Software AG\BPS V2\bin>mdeserver -h
    
    mdeserver -[i|u|e|s|v|h]
            -i(nstall) [account] [password] : Install the service, optionally using
    given account and password
            -u(ninstall)    : Uninstall the service.
            -e(xec)         : Run as a regular application. Useful for debugging.
            -t(erminate)    : Stop the service.
            -c(ommand) num  : Send command code num to the service.
            -v(ersion)      : Print version and status information.
            -h(elp)         : Show this help
            No arguments    : Start the service.
    
    C:\Program Files\IBK Software AG\BPS V2\bin>


===== Check Status =====

    C:\Program Files\IBK Software AG\BPS V2\bin>mdeserver -v
    The service
            IBK BPS2 MDE Server
            mdeserver
    
    is not installed and not running
    
    C:\Program Files\IBK Software AG\BPS V2\bin>


===== Installing and Starting up the service =====

To install and start the server you need to enter both, the install command and the start command one after the other:

    C:\Program Files\IBK Software AG\BPS V2\bin>mdeserver -i
    The service IBK BPS2 MDE Server has been installed under: C:\Program Files\IBK S
    oftware AG\BPS V2\bin\mdeserver.exe
    
    C:\Program Files\IBK Software AG\BPS V2\bin>mdeserver -s
    
    C:\Program Files\IBK Software AG\BPS V2\bin>

===== Terminating and Stopping the service =====

Terminate and stop the service in case before uninstalling the BPS software.

    c:\Program Files\IBK Software AG\BPS V2\bin>mdeserver.exe -t
    
    c:\Program Files\IBK Software AG\BPS V2\bin>mdeserver.exe -u
    The service IBK BPS2 MDE Server has been uninstalled.
    
    c:\Program Files\IBK Software AG\BPS V2\bin>