Differences

This shows you the differences between two versions of the page.

--- monitor:ntsvcs [2010/03/16 13:00] – digitalman
+++ monitor:ntsvcs [2021/02/12 20:03] (current) – [Uninstallation] Re-apply typo fix from mlong digital man
@@ Line 4: / Line 4: @@
 If you're running Synchronet on a Microsoft Windows NT based operating system
-(e.g. Windows NT, Windows 2000, Windows XP, Windows 2003, Windows Vista, Windows 2008, or Windows 7), you can run
+(e.g. Windows NT, Windows 2000, Windows XP, Windows 2003, Windows Vista, Windows 2008, Windows 7, Windows 8, or Windows 10), you can run
 Synchronet as a set of [[wp>Windows Services]].
@@ Line 41: / Line 41: @@
 	sbbsNTsvcs install
+Example output:
+<file>
+Synchronet NT Services  Version 3.15a  Copyright 2010 Rob Swindell
+Installing Synchronet NT Services...
+Installing service: Synchronet Terminal Server          ... Startup: Automatic
+Installing service: Synchronet FTP Server               ... Startup: Automatic
+Installing service: Synchronet Web Server               ... Startup: Automatic
+Installing service: Synchronet SMTP/POP3 Mail Server    ... Startup: Automatic
+Installing service: Synchronet Services                 ... Startup: Automatic
+</file>
 ===== Configuration =====
-The configuration of the Synchronet servers and services is handled in your
+The configuration of the Synchronet [[:server:|Servers]] and [[:service:|Services]] is handled in your
-Synchronet initialization file (e.g. ''[[dir:ctrl]]/sbbs.ini''). The Synchronet Windows
+Synchronet initialization files (i.e. ''[[config:sbbs.ini]]'' and ''[[config:services.ini]]'').
+The Synchronet Windows
 services know the location of your Synchronet ''[[dir:ctrl]]'' directory from the
 ''[[:config:env#SBBSCTRL]]'' environment variable.
 Once installed, the Synchronet Windows services may be started from the Windows Services
 dialog (under the Windows Control Panel->Administrative Tools->Services),
-by running the Synchronet Control Panel, or if the system is rebooted, the
+{{:monitor:services_cpl.png|}}
+by running the [[monitor:sbbsctrl|Synchronet Control Panel]], or if the system is rebooted, the
 services will start automatically if enabled and configured for "AutoStart".
 The Windows Services control panel applet may also be started with Windows Start->Run->''services.msc''.
-===== Uninstallation =====
+{{:monitor:run_services_msc.png|}}
-To remove/un-install the Synchronet Windows Services, run:
-	sbbsNTsvcs remove
-You may also enable and disable the Synchronet Windows Services with the sbbsNTsvcs
-command-line options.
 ===== Command Line =====
@@ Line 98: / Line 107: @@
 Example:
-  sc restart SynchronetMail
+  sc stop SynchronetWeb
+Example output:
+<file>
+SERVICE_NAME: SynchronetWeb
+        TYPE               : 20  WIN32_SHARE_PROCESS
+        STATE              : 3  STOP_PENDING
+                                (STOPPABLE,NOT_PAUSABLE,ACCEPTS_SHUTDOWN)
+        WIN32_EXIT_CODE    : 0  (0x0)
+        SERVICE_EXIT_CODE  : 0  (0x0)
+        CHECKPOINT         : 0x0
+        WAIT_HINT          : 0x7530
+</file>
+To start or stop all Synchronet Windows Services at once from a command-line, use the ''sbbsNTsvcs'' commands.
+Example:
+  sbbsNTsvcs start
+Example output:
+<file>
+Synchronet NT Services  Version 3.15a  Copyright 2010 Rob Swindell
+Starting service: Synchronet Terminal Server          ... Started
+Starting service: Synchronet FTP Server               ... Started
+Starting service: Synchronet Web Server               ... Started
+Starting service: Synchronet SMTP/POP3 Mail Server    ... Started
+Starting service: Synchronet Services                 ... Started
+</file>
 ===== Synchronet Control Panel =====
@@ Line 113: / Line 148: @@
 integrate these features with the Synchronet Windows services in the future.
+NOTE: For the Synchronet Control Panel to correctly communicate with the Windows Service Control Manager, sbbsctrl.exe may need to be run "as administrator". Not doing so may cause the Synchronet Control Panel to not be able to discover that the NT services are installed or running and it won't be able to control (e.g. start/stop) or communicate with the services.
 ===== Windows Event Log =====
 Log messages (determined by the ''LogLevel'' values in your ''[[:config:sbbs.ini]]'' file) will be logged as Application event log messages (viewable in your Windows Event Viewer).
@@ Line 129: / Line 165: @@
 parameters" of one or more of the services (under the Windows Control Panel)
 to ''-debug''.
+===== Uninstallation =====
+If you do not wish to run Synchronet as Windows Services (e.g. run them in-process using ''[[monitor:sbbscon|sbbs.exe]]'' or ''[[monitor:sbbsctrl|sbbsctrl.exe]]'' instead), simply stopping and (optionally) disabling the services is all that is normally required.
+To disable the Synchronet Windows Services using ''sbbsNTsvcs'':
+  sbbsNTsvcs disable
+Example output:
+<file>
+Synchronet NT Services  Version 3.15a  Copyright 2010 Rob Swindell
+Disabling service: Synchronet Terminal Server          ... Disabled
+Disabling service: Synchronet FTP Server               ... Disabled
+Disabling service: Synchronet Web Server               ... Disabled
+Disabling service: Synchronet SMTP/POP3 Mail Server    ... Disabled
+Disabling service: Synchronet Services                 ... Disabled
+</file>
+To remove/un-install the Synchronet Windows Services, run:
+	sbbsNTsvcs remove
+Example output:
+<file>
+Synchronet NT Services  Version 3.15a  Copyright 2010 Rob Swindell
+Removing: Synchronet Terminal Server          ... Removed
+Removing: Synchronet FTP Server               ... Removed
+Removing: Synchronet Web Server               ... Removed
+Removing: Synchronet SMTP/POP3 Mail Server    ... Removed
+Removing: Synchronet Services                 ... Removed
+</file>
+:!: This operation does not uninstall Synchronet.
 ===== See Also =====
@@ Line 134: / Line 206: @@
 {{tag>}}
-{{indexmenu_n>3}}

Trace:

Differences

Navigation

Search

Toolbox