| Compatibility : | 3.0.0 |
| Editions : |    |
| Platforms : |          |
|
WARNING
|  |
DO NOT modify the value of this property
while an application using the configuration file
has been installed as a Windows Service.
Please uninstall the existing service BEFORE modifying this property.
The service with the new value can then be safely reinstalled later.
|
This property is only used on Windows platforms.
Account:
The account to use when running the service.
Use an account name in the form: {DomainName}\{UserName}.
If the account belongs to the built-in domain,
then you may specify the name in the form: .\{UserName}.
The default, blank value, will use the LocalSystem account.
| Example: |
wrapper.ntservice.account=.\leif
|
Password:
Most accounts will require a password to be set. See the
wrapper.ntservice.password
property for the various options specifying a password.
Error on Service Install:
When attempting to install the service, you will encounter the following message
if the account name is invalid, does not exist, or the password for the account is incorrect.
A common mistake is setting the account name to leif
rather than .\leif.
| Example of Error messasge on Service Install: |
CreateService failed - The account name is invalid or does not exist,
or the password is invalid for the account name specified. (0x421)
|
Error on Service Start:
Only accounts which have their "Logon as Service" right set can be used to run a service.
Failure to set this right will result in the following error message
when you attempt to actually start the service:
Example of Error messasge on Service Start:
System error 1069 has occurred.
The service did not start due to a logon failure.
|
Setting Access Right:
To set the "Logon as Service" right,
Go to the "Administrative Tools" folder in your control panel.
Open the "Local Security Policy" applet.
Expand "Local Policy" and then click on "User Rights Assignment".
On the right side, you will find a "logon as service policy".
Right click or double click to access its properties dialog,
and then add the user that you wish to allow to run the service.
Note that the "Local Security Policy" applet does not appear to be available
on Home Editions of Windows 2000 and XP.
It is thus not possible to run a service as a specific account
under those versions of Windows.
|
NOTE
| |
The wrapper.ntservice.interactive
property must be set to FALSE if the service is configured to run using a specific account in this property.
|
|
NOTE
| |
Changes on this property will not take effect until the Windows Service is reinstalled.
|
It is possible to set account to alternative system accounts using one of the following values:
| Example: |
wrapper.ntservice.account=NT AUTHORITY\NetworkService
wrapper.ntservice.account=NT AUTHORITY\LocalService
|
Please see the Microsoft MSDN page for more information on the
"Network Service Account".
|
