| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| install:dev [2021/05/15 18:05] – [Run-time files] Mentino the 'use defaults' text.dat option digital man | install:dev [2026/01/01 22:35] (current) – [Run-time files] Note that a second run of 'jsexec update' is in order when upgrading from v3.19 or earlier digital man |
|---|
| - Continue with [[#step 4]] section of this page | - Continue with [[#step 4]] section of this page |
| |
| ==== Pre-built executables ==== | ==== Pre-built Executables ==== |
| |
| If you are using pre-built executables (from Windows-installer or archive): | If you are using pre-built executables (from Windows-installer or archive): |
| - Continue with [[#step 4]] section of this page | - Continue with [[#step 4]] section of this page |
| |
| ^ Platform ^ Archive ^ | ^ Platform ^ Nightly Build ^ Continuous Build ^ |
| | Windows-i386 | [[ftp://ftp.synchro.net/sbbs_dev.zip|Nightly-build (sbbs_dev.zip)]] [[https://gitlab.synchro.net/sbbs/sbbs/-/jobs/artifacts/master/download?job=sbbs-windows|Continuous-build]] | | | Windows-i386 | [[https://vert.synchro.net/Synchronet/sbbs_dev.zip|https]] [[http://vert.synchro.net/Synchronet/sbbs_dev.zip|http]] [[ftp://ftp.synchro.net/sbbs_dev.zip|ftp]] | [[https://gitlab.synchro.net/sbbs/sbbs/-/jobs/artifacts/master/download?job=windows-x86 [sbbs]|https]] | |
| | Linux-x64 | [[ftp://ftp.synchro.net/sbbs_dev.tgz|Nightly-build (sbbs_dev.tgz)]] [[https://gitlab.synchro.net/sbbs/sbbs/-/jobs/artifacts/master/download?job=sbbs-linux|Continuous-build]] | | | Linux-x64 | [[https://vert.synchro.net/Synchronet/sbbs_dev.tgz|https]] [[http://vert.synchro.net/Synchronet/sbbs_dev.tgz|http]] [[ftp://ftp.synchro.net/sbbs_dev.tgz|ftp]] | [[https://gitlab.synchro.net/sbbs/sbbs/-/jobs/artifacts/master/download?job=linux-x64 [sbbs]|https]] | |
| | FreeBSD-amd64 | [[https://gitlab.synchro.net/sbbs/sbbs/-/jobs/artifacts/master/download?job=sbbs-freebsd|Continuous-build]] | | | macOS-armv8 | [[https://vert.synchro.net/Synchronet/sbbs_dev-macos-armv8.tgz|https]] [[http://vert.synchro.net/Synchronet/sbbs_dev-macos-armv8.tgz|http]] [[ftp://ftp.synchro.net/sbbs_dev-macos-armv8.tgz|ftp]] | [[https://gitlab.synchro.net/sbbs/sbbs/-/jobs/artifacts/master/download?job=darwin-aarch64-aarch64 [sbbs]|https]] | |
| | | macOS-x86 | | [[https://gitlab.synchro.net/sbbs/sbbs/-/jobs/artifacts/master/download?job=darwin-x86-x86 [sbbs]|https]] | |
| | | FreeBSD-amd64 | N/A | [[https://gitlab.synchro.net/sbbs/sbbs/-/jobs/artifacts/master/download?job=freebsd-amd64 [sbbs]|https]] | |
| |
| |
| ==== Run-time files ==== | ==== Run-time files ==== |
| |
| **Note**:\\ | === Git Method === |
| The ''sbbs_run'' archive file (''[[ftp://ftp.synchro.net/sbbs_run.tgz|sbbs_run.tgz]]'' for *nix, ''[[ftp://ftp.synchro.net/sbbs_run.zip|sbbs_run.zip]]'' for Windows) contains a super-set of the files contained within the archive files referenced below. If you've already downloaded the ''sbbs_run'' archive, then you already have all the necessary files (plus a lot more) and do not need to download the smaller archives referenced below. | |
| |
| - If you performed a [[dev:CVS]] install (e.g. on *nix), see [[howto:Git]] for instructions on updating to the Git repo((The Synchronet CVS Repository is no longer updated)). | - If you performed a [[dev:CVS]] install (e.g. on *nix), see [[howto:Git]] for instructions on updating to the Git repo((The Synchronet CVS Repository is no longer updated)). |
| - If you performed a [[dev:Git]] install (e.g. on *nix) and you opted for symbolic links to the ''[[dir:exec]]'' and ''[[dir:text]]'' directories, the only file you might need to manually update or merge would be the ''[[dir:ctrl]]/[[custom:text.dat]]'' file. All the other files should be automatically updated with your ''git pull'' command; you should be able to skip to the final step (''jsexec update''). | - If you performed a [[dev:Git]] install (e.g. on *nix) and you opted for symbolic links to the ''[[dir:exec]]'' and ''[[dir:text]]'' //directories//((this is reference to the SYMLINK=1 installation option, not the symlinks build target)), the only file you might need to manually update or merge would be the ''[[dir:ctrl]]/[[custom:text.dat]]'' file. |
| - If you performed a [[dev:Git]] install (e.g. on *nix) and you did **not** opt for symbolic links, you will need to copy the ''repo/exec'' and ''repo/text'' directories to your ''sbbs/[[dir:exec]]'' and ''sbbs/[[dir:text]]'' directories. | - If you performed a [[dev:Git]] install (e.g. on *nix) and you did **not** opt for symbolic links, you will need to recursively copy the ''repo/exec'' and ''repo/text'' directories to your ''sbbs/[[dir:exec]]'' and ''sbbs/[[dir:text]]'' directories. |
| - If you did **not** perform a CVS or Git install, download the daily archive of the ''[[dir:exec]]'' directory and extract into your Synchronet ''exec'' directory, over-writing existing files: [[ftp://ftp.synchro.net/sbbsexec.zip|Windows]] or [[ftp://ftp.synchro.net/sbbsexec.tgz|*nix]] format. | - Over-write or merge-with your modified ''[[dir:ctrl]]/[[custom:text.dat]]'' file from [[https://gitlab.com/synchronet/sbbs/-/raw/master/ctrl/text.dat|here]]. If you see some corrupted text output from the terminal server or some features don't work as expected, skipping this step could be the cause. If you don't have have or expect to make any edits to your ''text.dat'' file, consider just using a 0-length ''text.dat'' file to always [[custom:text.dat#use defaults]]. |
| | |
| | |
| | === Non-Git Method === |
| | |
| | **Note**:\\ |
| | The ''sbbs_run'' archive file (''[[https://vert.synchro.net/Synchronet/sbbs_run.tgz|sbbs_run.tgz]]'' for *nix, ''[[https://vert.synchro.net/Synchronet/sbbs_run.zip|sbbs_run.zip]]'' for Windows) contains a super-set of the files contained within the archive files referenced below. If you've already downloaded the ''sbbs_run'' archive, then you already have all the necessary files (plus a lot more) and do not need to download the smaller archives referenced below. |
| | |
| | - If you did **not** perform a CVS or Git install, download the daily archive of the ''[[dir:exec]]'' directory and extract into your Synchronet ''exec'' directory, over-writing existing files: [[https://vert.synchro.net/Synchronet/sbbsexec.zip|Windows]] or [[https://vert.synchro.net/Synchronet/sbbsexec.tgz|*nix]] format. |
| | - Download the daily archive of the ''[[dir:text]]'' directory: [[https://vert.synchro.net/Synchronet/sbbstext.zip|Windows]] or [[https://vert.synchro.net/Synchronet/sbbstext.tgz|*nix]] format |
| - Over-write or merge-with your modified ''[[dir:ctrl]]/[[custom:text.dat]]'' file from [[https://gitlab.com/synchronet/sbbs/-/raw/master/ctrl/text.dat|here]]. If you see some corrupted text output from the terminal server or some features don't work as expected, skipping this step could be the cause. If you don't have have or expect to make any edits to your ''text.dat'' file, consider just using a 0-byte ''text.dat'' file to always [[custom:text.dat#use defaults]]. | - Over-write or merge-with your modified ''[[dir:ctrl]]/[[custom:text.dat]]'' file from [[https://gitlab.com/synchronet/sbbs/-/raw/master/ctrl/text.dat|here]]. If you see some corrupted text output from the terminal server or some features don't work as expected, skipping this step could be the cause. If you don't have have or expect to make any edits to your ''text.dat'' file, consider just using a 0-byte ''text.dat'' file to always [[custom:text.dat#use defaults]]. |
| - Download the daily archive of the ''[[dir:text]]'' directory: [[ftp://ftp.synchro.net/sbbstext.zip|Windows]] or [[ftp://ftp.synchro.net/sbbstext.tgz|*nix]] format | |
| - If you have **no** customized files in your ''[[dir:text]]'' directory, extract the ''sbbstext'' archive into your Synchronet ''text'' directory, over-writing existing files | - If you have **no** customized files in your ''[[dir:text]]'' directory, extract the ''sbbstext'' archive into your Synchronet ''text'' directory, over-writing existing files |
| - If you **do** have customized files in your ''[[dir:text]]'' directory, extract the ''sbbstext'' archive into a temporary location and compare files and merge or replace as you see fit. Of particular interest should be the new ''[[module:avatars]]'' sub-directory. Definitely copy that one! | - If you **do** have customized files in your ''[[dir:text]]'' directory, extract the ''sbbstext'' archive into a temporary location and compare files and merge or replace as you see fit. Of particular interest should be the new ''[[module:avatars]]'' sub-directory. Definitely copy that one! |
| - From a command prompt (e.g. in your Synchronet ''exec'' directory), run: ''jsexec update'' | |
| | === Final Step (Git or non-git) === |
| | |
| | - From a command prompt (e.g. in your Synchronet ''exec'' directory), run: ''jsexec -U update''((the JSexec ''-U'' option is important when upgrading from Synchronet v3.19 or earlier to v3.20 or later)). |
| | - If upgrading from Synchronet v3.19 or earlier, a second run of ''jsexec update'' may be necessary to get all the updated configuration changes since the first run would just upgrade the configuration files and not reload them. |
| |
| Now you are ready to re-run the BBS and enjoy the "latest and greatest"! | Now you are ready to re-run the BBS and enjoy the "latest and greatest"! |
