FreeBSD Manual Pages
bk service(7.3.3) BitKeeper User's Manual bk service(7.3.3) NAME bk service - manage a bkd as a Windows service SYNOPSIS bk service install [name] [bkdargs] bk service uninstall [-a] [name] bk service status [-a] name bk service list DESCRIPTION The BitKeeper daemon, bkd, is used to synchronize and query reposito- ries. See bk help bkd for information on the BitKeeper daemon. bk service is used to install (and start), uninstall (after stopping), query the status of a named BitKeeper daemon (bkd), or list all installed daemons. The main reason for using this interface is to get a service that will be restarted on each boot. MULTIPLE DAEMONS It is possible to install more than one BitKeeper daemon, which is use- ful if you want different permissions on different repositories. All daemons must have a name, and the name must be unique across the set of BitKeeper daemons. The default name is "BKD". The names are stored in the registry and we suggest a single word, using mixed case if you want to a name like "MyBitkeeperDaemon". Some commands take an optional -a instead of a name which means operate on all installed BitKeeper daemons. PERMISSIONS By default, an installed service is run as LocalSystem which is a sys- tem user, not the user who installed the service. This can lead to problems if the BKD is used to serve up repositories created by the user with permissions restrictive enough that the LocalSystem user can- not access some or all the files in the repository. There are two ways around this problem, either create all the reposito- ries through the BKD so they are all owned by LocalSystem, or change the service to be run as the user who owns the repositories, described below. RUNNING AS A SPECIFIC USER => The user account must have a password. If not, go to Control Panel->User Accounts, select the user, and create a password. Close that window. => The user account must be allowed to log on as a service. This is not on by default, so go to Control Panel->Administrative Tools->Local Security Policy->Local Policies and double click on User Rights Assignments. Find Log on as a service and double click that. Click Add User or Group and add the user. Close that win- dow. => The service needs to be modified to run as the user. Go to Control Panel->Administrative Tools->Services, find the BitKeeper daemon, double-click it. Click Stop to stop the service, then click the Log On tab, change from Local System account to the user, entering the password as well. Click Apply. Click the General tab and then click Start. The daemon will restart as the selected user. After installing a service it is a good idea to test that it works by trying a clone, pull, and/or changes from a client. NOTES This interface works only on Windows. Environment variables must be explicitly passed on the bkd options list, i.e., bk service DOCS -EBK_USER=docs -p8000 The bkd service does not work when started from a network drive. The bkd service does not work when started from a subst'ed drive. bk uninstall may require a reboot in order to completely remove the service. SEE ALSO bk-bkd, bk-Howto-bkd CATEGORY Repository Admin BitKeeper Inc 1E1 bk service(7.3.3)
NAME | SYNOPSIS | DESCRIPTION | MULTIPLE DAEMONS | PERMISSIONS | RUNNING AS A SPECIFIC USER | NOTES | SEE ALSO | CATEGORY
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=service&manpath=FreeBSD+15.1-RELEASE+and+Ports.quarterly>