Both sides previous revisionPrevious revisionNext revision | Previous revision |
install:win [2016/09/25 14:03] – Added existing system upgrade for 3.16c to 3.17 Buckaroo | install:win [2024/04/06 19:04] (current) – [Windows Services] Remove (outdated) list of example NT-based OSes digital man |
---|
| |
===== Prerequisites ===== | ===== Prerequisites ===== |
If installing or upgrading-to Synchronet v3.16 (in development as of October 20, 2011), you will need to download and install the [[http://www.microsoft.com/download/en/details.aspx?id=5555|Microsoft Visual C++ 2010 Redistributable Package (x86)]] which contains the required file: ''MSVCR100.DLL'' (Microsoft Visual C++ Run-time Library v10.0). | Synchronet requires the following Microsoft Visual++ Run-time libraries installed (**for x86**, not x64): |
| * [[https://www.microsoft.com/en-us/download/details.aspx?id=26999|Microsoft Visual C++ 2010 SP1 Redistributable Package (x86)]] |
| * [[https://www.microsoft.com/en-us/download/details.aspx?id=53840|Microsoft Visual C++ 2015 Redistributable Update 3 (x86)]] |
| |
===== Installation ===== | ===== Installation ===== |
| |
===Install from official releases=== | === Install from official releases === |
| |
After downloading the Synchronet distribution file (e.g. ''[[ftp://synchro.net/Synchronet/sbbs316c.zip]]''), you will | After downloading the Synchronet distribution file (e.g. ''[[http://synchro.net/Synchronet/sbbs319b.zip]]''), you will need to extract the archive file that you downloaded into a temporary directory on your hard drive. You may need WinZip or an equivalent archive program to uncompress and extract the installation files. |
need to extract the archive file that you downloaded into a temporary directory | |
on your hard drive. You may need WinZip or an equivalent archive program to | |
uncompress and extract the installation files. | |
| |
Once you've extracted the installation files, go to the directory you extracted | 09/20/2020 07:58 PM 531 FILE_ID.DIZ |
the compressed files to and run ''SETUP'' to start the installation. | 09/15/2020 12:27 AM 64,761 install.rtf |
| 09/20/2020 08:54 PM 12,150,851 setup.exe |
| |
The default installation directory is recommended for most users. If you choose | Once you've extracted the installation files, go to the directory you extracted the compressed files to and run ''SETUP'' to start the installation. |
to change the installation directory, it is critical that you DO NOT use a path | |
with long filenames or spaces or some 16-bit DOS utilities which require DOS-compatible 8.3 file and directory names will not function. It is recommended you use a directory named "SBBS" off of the root directory on one of your hard drives (e.g. ''C:\SBBS''). | |
| |
After completing your selection and the installation is completed you will | {{:install:sbbs_install_error_already_running.png?400|Synchronet for Windows install error}} |
find a new Icon on your Desktop and in your StartUp Folder in your Start | |
Menu. If you do not want Synchronet to start automatically during boot, you | |
may safely delete the Synchronet shortcut from your StartUp Folder. | |
| |
====== Control Panel ====== | If you receive the above error dialog, that indicates that you are currently running an instance of Synchronet BBS software and need to stop that process before the installation can continue. |
| |
The Synchronet Control Panel and [[:monitor:sbbsctrl#wizard|Configuration Wizard]] will automatically launch after installation. | {{:install:sbbs_win-install_welcome.png?400|Synchronet for Windows install welcome}} |
| |
{{:monitor:scfgwizard.png?300|Synchronet Configuration Wizard}} | When the installer starts successfully, you will see the above welcome message. |
| |
See the [[:monitor:sbbsctrl|Synchronet Control Panel]] page for more details and further steps, including [[:config:|configuration]]. | {{:install:sbbs_win-install_readme.png?400|Synchronet for Windows install instructions}} |
| |
====== Windows Services ====== | Clicking the "Next >" button will display the included ''install.rtf'' file. |
| |
On NT-based operating systems (e.g. Windows 2000, XP, 2003, Vista, 2008, and Windows 7), you can alternatively run Synchronet in the background as a set of Windows Services (a.k.a. NT services). See the [[:monitor:ntsvcs|Synchronet Windows Services]] page for details. | {{:install:sbbs_win-install_dest.png?400|Synchronet for Windows install destination}} |
| |
====== Upgrade Existing 3.16c ====== | Clicking the "Next >" button will display a dialog which prompts you to choose an installation directory. |
Note: This process worked for me on the Split Infinity BBS. PLEASE make sure you backup your existing system and keep it safe as the same process may not work for you. | |
If you have an existing 3.16c system running on Windows, you can do the following to do an in-place upgrade to the latest dev build (Currently V3.17). __**Remember, 3.17 is still in development, at this writing, and should not be used on a production system.**__ This is a manual procedure that results in an upgraded system without overwriting existing configurations. | |
| |
* Shut down both your mailer and BBS and make sure that they are both offline and shutdown. | The default installation directory is recommended for most users. If you choose to change the installation directory, it is critical that you DO NOT use a path with long filenames or spaces or some 16-bit DOS utilities which require DOS-compatible 8.3 file and directory names will not function. It is recommended you use a directory named "SBBS" off of the root directory on one of your hard drives (e.g. ''C:\SBBS''). |
* Backup the contents of your sbbs directory and all sub-directories and store it in a safe place. | |
* Download the most recent successful [[ftp://vert.synchro.net/Synchronet/sbbs_dev.zip|nightly build]] of Synchronet. | |
* Unzip the archive into a temp directory. | |
* Move the files from the temp directory into the [Drive Letter]:\sbbs\exec directory, and overwrite existing files. | |
* Download the [[http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/exec/sbbsecho_upgrade.js|sbbsecho_upgrade.js]] file and copy to the exec directory. Open a command prompt and navigate to the exec directory. Run the upgrade script using the following command: jsexec sbbsecho_upgrade.js | |
* To update the remaining javascript files, got to the [[http://cvs.synchro.net/cgi-bin/viewcvs.cgi/exec/?sortby=date#dirlist|CVS repository, Sorted by date]] | |
* Open the corresponding files in a text editor on your system and look at the version number and compare to the version number of the file in CVS. If they are out of sync, manually make the changes shown in CVS or download the file and drop it in your exec directory, overwriting the existing file. | |
* Start up Synchronet and then log into your BBS and verify everything is operational. | |
* Start up your mailer and watch for mail packets to come in and verify that packets are tossed and that they show up in your message areas. | |
| |
====== Upgrade ====== | {{:install:sbbs_win-install_additional_tasks.png?400|Synchronet for Windows install additional tasks}} |
| {{:install:sbbs_win-install_additional_tasks2.png?400|Synchronet for Windows install additional tasks}} |
| |
| After completing your selections... |
| |
| {{:install:sbbs_win-install_ready.png?400|Synchronet for Windows install ready}} |
| |
| Clicking the "Install" button will start the installation process. |
| |
| {{:install:sbbs_win-install_installing.png?400|Synchronet for Windows install in process}} |
| |
| {{:install:sbbs_win-install_complete.png?400|Synchronet for Windows install completed}} |
| |
| When the installation process is completed you may find a new Icon on your //Desktop// and/or your //Startup Folder// in your Start Menu. If you do not want Synchronet to start automatically during boot, you may safely delete the Synchronet shortcut from your Windows //Startup Folder//. |
| |
| Clicking the "Finish" button will exit the setup/installation program and if the //"Launch Synchronet..."// checkbox was checked, the Synchronet Control Panel will be executed automatically. |
| |
| {{:install:sbbsctrl_splash.png?400|Synchronet for Windows Control Panel Splash screen}} |
| |
| ====== Control Panel ====== |
| |
| The Synchronet Control Panel and [[:monitor:sbbsctrl#wizard|Configuration Wizard]] may automatically launch after installation. |
| |
| {{:monitor:scfgwizard.png?300|Synchronet Configuration Wizard}} |
| |
| See the [[:monitor:sbbsctrl|Synchronet Control Panel]] page for more details and further steps, including [[:config:|configuration]]. |
| |
| ====== Windows Services ====== |
| |
You may also download and extract the [[ftp://synchro.net/Synchronet/sbbs_run.tgz|run-time files]] snapshot to get all the required files to use in combination with the development build files to run the "latest and greatest" stock configuration from [[dev:CVS]]. :!: Warning: careful not to overwrite any customized or configured files that you care about when extracting. | On NT-based operating systems, you can alternatively run Synchronet in the background as a set of Windows Services (a.k.a. NT services). See the [[:monitor:ntsvcs|Synchronet Windows Services]] page for details. |
| |
Run ''jsexec update.js'' from a command prompt after updating the files in your ''[[dir:exec]]'' directory. | ===== Setup ===== |
| Now that you've completed the installation, move on to the [[setup|initial setup]] instructions. |
| |
===== See Also ===== | ===== See Also ===== |
* [[:install:|Installation]] | * [[:install:|Installation]] |
| |
| {{tag>install setup windows}} |