This is an old revision of the document!


Development Update

So you want to live on the edge and run the latest Synchronet development code? Cool, we do too!

The instructions on this page will perform an incremental update from a Synchronet v3.16 or later install to the latest development build of Synchronet.

:!: Note: Some of the archive files referenced on this page include sub-directories with important files. When unzipping (e.g. on Windows), be sure to include the sub-directories and recreate the same sub-directory hierarchy in the target directories (e.g. do not extract files from exec/load/ into your exec directory - this is a common mistake).

Step 1

Shutdown the BBS

Stop all instances of sbbs, scfg, sbbsctrl, sbbsntsvcs, jsexec, umonitor, echocfg, etc. from running.

We want to avoid problems with copying or over-writing files that may be in-use when BBS processes are running.

Step 2

Backup everything

Seriously, you never know what could go wrong. Make a backup of your entire Synchronet directory tree before you begin.

Mods

If you have any customized modules/scripts in the exec directory, move them to your mods directory to protect them from over-write during update (and leave them there). You may want to manually merge in any “upstream” changes to benefit from fixes or new features added to those same files. You can use the CVS web interface to perform comparisons (diff's) between revisions and find out what was added that you might have missed in your modified version of the file(s) from exec.

Step 3

Executables from Source

If you are building Synchronet from source code:

  1. Perform the steps detailed here
  2. Continue with step 4 section of this page

Pre-built executables

If you are using pre-built executables (from Windows-installer or archive):

  1. Download the daily built and archived executable files for Win32 or Linux-x64 1)
  2. Extract the sbbs_dev archive into your Synchronet exec directory, over-writing existing files
  3. Continue with step 4 section of this page

Now your “program files” (executable binaries) are updated, you need to update the run-time files next.

Step 4

Run-time files

Note: The sbbs_run archive file (.tgz for *nix, .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.

  1. If you performed a CVS install (e.g. on *nix), you can perform a cvs update -d in the exec directory, or:
  2. Download the daily archive of the exec directory and extract into your Synchronet exec directory, over-writing existing files: Windows or *nix format
  3. Over-write or merge-with your modified ctrl/text.dat file from 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)
  4. Download the daily archive of the text directory: Windows or *nix format (again, a “cvs update -d” here is an option if that's how you got the files initially)
  5. If you have no customized files in your text directory, extract the sbbstext archive into your Synchronet text directory, over-writing existing files
  6. If you do have customized files in your 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 avatars sub-directory. Definitely copy that one!
  7. From a command prompt (e.g. in your Synchronet exec directory), run: jsexec update

Now you are ready to re-run the BBS and enjoy the “latest and greatest”!

See Also

1)
sorry, pre-built archives for other platforms are not currently available
install/dev.1517774807.txt · Last modified: 2018/02/04 12:06 by digital man
Back to top
CC Attribution 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0