,----------------------.
| UPGRADING MYSTIC BBS |------------------------------------------------------
`----------------------'
1. FIRST and ALWAYS create a backup of your BBS before upgrading. Generally
upgrading goes pretty smooth, but there is always the chance of something
going wrong whether it is Mystic or operator error!
2. There is no automatic upgrade process. The process is to install the full
installation to a temporary directory, so that you have access to the
latest version of the files. Then follow the upgrade instructions provided
below for your specific version. Usually this just means replacing new
binary files contained in the new alpha. DO NOT ATTEMPT TO INSTALL OVER
YOUR EXISTING SETUP!
3. REVIEW THE WHATSNEW.TXT for this alpha. The WHATSNEW is structured to show
what has been added/fixed between alphas, and also provides documentation
for new or changed features.
4. REMEMBER #1 TO BACKUP YOUR BBS DIRECTORY! :)
.-----------------------------------.
| UPGRADING FROM 1.12 A4 TO 1.12 A5 |-------------------------
`-----------------------------------'
- Replace all binary executable files
- Delete CFGROOT.AN1 from your data directory
- Copy CFGROOT1.ANS from the A5 data directory into your data directory
.-----------------------------------.
| UPGRADING FROM 1.12 A3 TO 1.12 A4 |-------------------------
`-----------------------------------'
- Just replace the old A3 .EXE files with the A4 versions to upgrade.
If you are upgrading from a version prior to A3 then you need to copy over
the A4 binaries, add all new/changed prompts, copy the new A4 protocol.dat,
recompile MPL files, and then run update.exe to upgrade data files to A3+
.-----------------------------------.
| UPGRADING FROM 1.12 A2 TO 1.12 A3 |-------------------------
`-----------------------------------'
- Make sure you do a FULL BACK UP your system because there are many data file
changes in this version, and a large amount of rewrites to things behind the
scenes. Once you upgrade there is no going back unless you restore a
backup.
- Replace all old .EXE files with new ones from A3 (do not forget MPLC and MIDE
in the scripts directory).
- Update the following changed prompts into your data\default.txt file and any
other prompt sets you're using:
; Press ENTER to start file transfer &1=selected protocol
; First word is input chars, followed by display text
065 SQ |CR|09Press |01[|15ENTER|01/|15S|01]|09tart or |01[|15ESCAPE|01/|15Q|01]|09uit your |15|&1 |09transfer: |XX
; Message from another node footer. First word contains input keys, followed by prompt
145 RC |CR|09Node Message: |01[|10R|01]|09eply, |01[|10C|01]|09hat, or |01[|10ENTER|01/|10Continue|01]|09: |15
- Copy update.exe into your root Mystic directory and run it one time. This
will perform various work on your data files for the new version. You can
delete update.exe now.
- Recompile all MPL programs that you use (mplc -all in the scripts
directory)
- The protocol format has changed, and it is recommended you copy over the
new protocol.dat from A3, especially if you do not use other external
protocols. Note that the file format has changed, so you must have
already ran upgrade.exe before you can copy the A3 protocol.dat over.
- If you use the a preset upload base in the File Base Settings make sure it
is pointing to the correct file base, as the numbering is now done by the
the unique base ID.
.--------------------------------.
| UPGRADING FROM 1.11 TO 1.12 A2 |----------------------------
`--------------------------------'
- Copy over new binaries (do not forget mide and mplc in scripts!)
- Recompile all MPL programs (mplc -all in scripts) (not sure if needed)
- Replace UNUSED prompt #315 in your default.txt (and any other themes)
with this one:
; Ask for character translation (DOS CP437 or UTF8)
; &1 = Detected terminal type (or Unknown)
315 |CR|14[|150|14] MS-DOS CP437|CR[|151|14] UTF-8|CR|CRSelect Terminal Codepage [|15Enter = CP437|14]: |XX
- The default protocol.dat has been updated to include the new internal Xmodem,
Ymodem, Zmodem so if you want to use them you can copy the protocol.dat from
the A1 installation over your old one.
- There are some minor additions to MUTIL.INI please see the whatsnew.txt
and/or look at the new MUTIL.INI for more information.
,----------------------.
| UPGRADING MYSTIC BBS |------------------------------------------------------
`----------------------'
1. FIRST and ALWAYS create a backup of your BBS before upgrading. Generally
upgrading goes pretty smooth, but there is always the chance of something
going wrong whether it is Mystic or operator error!
2. There is no automatic upgrade process. The process is to install the full
installation to a temporary directory, so that you have access to the
latest version of the files. Then follow the upgrade instructions provided
below for your specific version. Usually this just means replacing new
binary files contained in the new alpha. DO NOT ATTEMPT TO INSTALL OVER
YOUR EXISTING SETUP!
3. REVIEW THE WHATSNEW.TXT for this alpha. The WHATSNEW is structured to show
what has been added/fixed between alphas, and also provides documentation
for new or changed features.
4. REMEMBER #1 TO BACKUP YOUR BBS DIRECTORY! :)
.-----------------------------------------------.
| UPGRADING FROM 1.10 OR ANY 1.11 ALPHA TO 1.11 |----------------------------
`-----------------------------------------------'
- Copy over new binaries (do not forget mide and mplc in scripts!)
- Recompile all MPL programs (mplc -all in scripts)
Release notes and other changes:
Prompt #355 has changed to include a (D)raw Mode option. This should have
been updated in the default 1.10 installation but I forgot to do it. If you
are updating, you may want to update prompt #355 to include (D)raw mode.
Likewise, the default FSHELP.ANS file has been updated to include the CTRL+T
option in the FS editor which toggles in and out of Draw mode. This stuff
was in 1.10 but the defaults were never updated.
This version was mostly a bug fix release, with the exception of the new ANSI
embedded messages. The 1.12 version is planned to have massive changes, like
that of 1.10. Stay tuned and enjoy!
,----------------------. | UPGRADING MYSTIC BBS |------------------------------------------------------ `----------------------'
.----------------------------------. | UPGRADING FROM ALPHA 62+ TO 1.10 |------------------------------- `----------------------------------'
.-------------------------------------. | UPGRADING FROM ALPHA 61 TO ALPHA 62 |--------------------------- `-------------------------------------'
.----------------------------------------. | UPGRADING FROM ALPHA 53-54 TO ALPHA 61 |--------------------------- `----------------------------------------'
Note: When upgrading to A56/A57, note that some additional node chat commands have been added. If you are using defaults, you may want to copy telehelp.asc into your text directory or update your existing file based on the whatsnew
Note: When upgrading to A60+, MPL programs will need to be recompiled, for example execute mplc -all in your scripts directory with the A60 mplc
.-------------------------------------. | UPGRADING FROM ALPHA 52 TO ALPHA 53 |--------------------------- `-------------------------------------'
[Options]
group_list = true
exclude_groups =
.-------------------------------------.
| UPGRADING FROM ALPHA 51 TO ALPHA 52 |---------------------------
`-------------------------------------'
; Shown when the index is calculating message base stats on startup
; or when CTRL-R is used to recalculate statistics
str8 = |#I Info Calculating message statistics, please wait
; Shown before posting a message w/ CTRL-P &1 = message base name
str9 = |16||11|CLPosting a message to area |15|&1|11.|CR
.----------------------------------------.
| UPGRADING FROM ALPHA 41-50 TO ALPHA 51 |---------------------------
`----------------------------------------'
If you are running on Unix:
sudo chown -R bbs:bbs /mystic
If you haven't already done so:
Optional stuff:
- Note the new "strip_seenby" option in mutil.ini you want want to use it.
Replace all binaries
Copy nodespy.ini into the directory where you have NodeSpy.
If you are still using A22 you can follow the instructions below to upgrade directly from A22 to A24.
Install to a temp directory
Copy over all binaries (dont forget mide/mplc!)
Recompile all MPL programs
Copy ansiviewer.ans into your TEXT directories
Copy ansigalv.ans into your TEXT directories
Copy new blackjack.mps over your old one
IMPORTANT Execute "mbbsutil -fixindex" in your root mystic dir
Copy over all binaries
Copy over all binaries
Delete MYSTPACK
(mUTIL now can pack message bases)
Copy over all binaries.
Recompile MPL programs
Review new MUTIL configuration additions
Copy over all binaries.
Recompile MPL programs (you might need to fix includes see whatsnew)
Newer version of USAGE.MPS too
Copy over all binaries
Recompile your MPL programs using MPLC -all or whatever
New program called NODESPY is now included Updated some MPL (to-prompt, usage, etc)
This should be a simply binary replacement. Simply perform the installation to a temporary directory and then copy over the newer binaries (don't forget MPLC and MIDE in the scripts directory).
Also, MIDE now has a configuration file (mide.ini) that you may wish to copy from the new install.
Recompile your MPL programs just to be safe. I can't remember if that needs to happen for this version or not.
Note that this version has internal Zmodem, but it still has some problems with certain clients. It may be best to stick with SEXYZ or some other protocol driver for now.
If you are using something PRIOR to alpha 15, you need to find the correct section to get to that level.
UPGRADING FROM 1.10 ALPHA 11 - 14 TO 1.10 ALPHA 17
If you are upgrading from 1.10 ALPHA 11-14 then you need to replace all of the binaries, recompile all MPL programs (mplc -all), and add/recompile new prompts.
IN ADDITION THIS IS VERY IMPORTANT
You will need to copy CvtMenus to your menus directory and run it only once so that your menu files are converted to the format used in ALPHA 15+. Once this is done you can delete this program.
Also, there are new versions of BlackJack.mpl and Usage.mpl and also TO-PRMPT is now included in the Mystic distribution.
UPGRADING FROM 1.09 TO 1.10 ALPHA 17
The following instructions are for upgrading your current 1.09 release of Mystic BBS.
!!! THIS IS A SIGNIFICANT UPGRADE YOU WILL NEED TO MAKE A FULL BACKUP OF YOUR !!! CURRENT SYSTEM IN CASE THERE ARE PROBLEMS.
In addition, the MPL language has significantly changed in this release. If you are using a lot of MPL modules, they will need to be upgraded to new versions. The MPL syntax has been standardized to be consistant with Pascal compilers, so the syntax will not be changing every couple of releases as it has in the past. It is a bunch of work now, but it means we won't be doing this again in the future!
MYSTIC.EXE
MAKETHEME.EXE
MBBSUTIL.EXE
MUTIL.EXE
MUTIL.CFG
109TO110.EXE
MYSTPACK.EXE
MIS.EXE
3. Copy the following files from your temporary install SCRIPTS directory
into your BBS scripts directory (replacing old stuff).
MPLC.EXE
MIDE.EXE
BBSLIST.MPS
BULLETIN.MPS
MPLDEMO.MPS
MPLTEST.MPS
BLACKJACK.MPS
BLACKJACK.ANS
RUMORS.MPS
USAGE.MPS
4. Run MPLC -ALL in your BBS scripts directory to recompile all of your
MPL programs. If you use custom MPL programs some may not compile and will need to be upgraded.
5. Copy CFGROOT.ANS from your temporary install DATA directory into your
BBS data directory.
6. For each "language" you have installed (usually just default.txt) you
will need add new prompts listed at the end of this file. default.txt is found in your root BBS directory.
7. For each "language" you have installed (usually just default) you will
need to recompile the prompts using MAKETHEME. Do NOT use the old MAKELANG as it no longer is used with Mystic BBS.
MakeTheme compile default.txt
8. Copy ANSIGALH.ANS and ANSIGAL.ANS from the temporary install's TEXT
directory into your BBS TEXT directory.
9. In your main BBS directory execute 109to110.EXE MAKE SURE IF YOU ARE
RUNNING AN OPERATING SYSTEM THAT USES FILE SECURITY THAT YOU HAVE FULL ACCESS TO ALL FILES IN YOUR BBS DIRECTORIES. IF YOU DO NOT THE UPGRADE WILL FAIL AND YOU WILL HAVE TO RESTORE AND START OVER
10. Delete 109to110.exe
11. Copy CvtMenus program into your menus directory and run it ONE TIME ONLY
so that it will convert your menu files.
12. Delete CvtMenus.exe
13. Notes: The install program will attempt to delete the following unused
programs and files: wfcscrn.* from DATA, makelang.exe, mcfg.exe, .lng from DATA, node.dat from DATA. If these files still exists for some reason they should be deleted. MCFG AND MAKELANG ARE NO LONGER USED WITH MYSTIC
VERSION PRIOR TO 1.09
If you are using 1.07 you must upgrade to 1.08, and then 1.09 using those upgrade packages. And then you can follow the instructions for 1.09 to the latest alphas above.
IF you are using 1.08 ALPHAs you must FIRST upgrade to 1.08 full release, and then to 1.09 before following the instructions above.
; ==== [ REPLACED PROMPTS 1.10 ] ==========================================
; Disconnect after download?
066 |CR|12Disconnect after file transfer? |11
; Disconneting in 10 seconds, press a key to abort 067 |CR|09Disconnecting in 10 seconds: Press a key to abort.
; Editing message display
296 |16|CL|09|17 ° |15Message Editing |$X79 |16|CR|CR|09(|11A|09) |03To: |11|&1|CR|09(|11B|09) |03Subject: |11|&2|CR|09(|11C|09) |03Sent: |11|&3|CR|CR|09Edit option (|11!|09) Edit text, (|11Q|09)uit? |11
; Message base new and qwk scan toggle prompt: 095 Toggle: |09[|11#-#,#|09], Select [|11A|09]dd All, [|11R|09]emove All, [|11?|09/|11List|09]: |XX
; ==== [ NEW PROMPTS 1.10 ] ===============================================
; ansi gallery: Ansi is required to use this prompt 466 |CRSorry, this gallery requires ANSI graphics|CR|CR|PA
; ansi gallery: Deselected file in list (bar OFF)
; &1=filename &2=filesize &3=filedate &4=sauce author &5=sauce title
; &6=sauce group &7=filetime
467 |[X02|07|16 |$R49|&1 |$R12|&6 |$R12|&4 |XX
; ansi gallery: Selected file in list (bar ON)
; &1=filename &2=filesize &3=filedate &4=sauce author &5=sauce title
; &6=sauce group &7=filetime
468 |[X02|15|17 |$R49|&1 |$R12|&6 |$R12|&4 |XX
; ansi gallery: Deselected DIRECTORY in list (bar OFF)
; &1=filename &2=filesize &3=filedate &4=sauce author &5=sauce title
; &6=sauce group &7=filetime
469 |[X02|07|16 |$R49|&1 |12<DIRECTORY>|$D15 |XX
; ansi gallery: Selected DIRECTORY in list (bar ON)
; &1=filename &2=filesize &3=filedate &4=sauce author &5=sauce title
; &6=sauce group &7=filetime
470 |[X02|15|17 |$R49|&1 |12<DIRECTORY>|$D15 |XX
; ansi gallery: Current path update prompt (when switching directories) ; set to blank to not display a path (automatically excludes the root) ; &1 = current path &2 = # of files in path 471 |[X08|[Y05|15|16|$R70|&1
; ansi gallery: Percent bar update (when redrawing page) ; Set to blank to not display a bar. Bar config is in MCFG lang settings ; &1 = Percentage bar &2 = Percentage (0-100) 472 |[X52|[Y23|15|16|$L03|&2|07% |&1
; ansi gallery: Default sauce values for no sauce record. 3 words separated ; by semi-colons: Title;Author;Group IE: Unknown;Unknown;Unknown 473 Unknown;Unknown;Unknown
; ansi gallery: Command prompt for ! (only download for now) 474 |CR|12Download |&1? |XX
; Password inquiry prompt
475 |CR|12Send a password inquiry message to the SysOp? |XX
; Displayed when account expired down to a security level > 0 476 |CR|14Your account has expired. Downgrading security to |XS.
; Displayed when account expired down to level 0 (delete) 477 |CR|12Your account has expired and is now marked for deletion.
; User required password change
478 |CR|14This BBS requires a password change every |PW days.
; User2User chat page which node?
479 |CR|09Enter node to chat with |01[|10?|01/|10List|01]|09: |XX
; User2User node/user is unavailable
480 |CR|15That user is marked unavailable.|CR|CR|PA
; User2User force user into chat?
481 |CR|12Force user into chat? |XX
; User2User sending chat request &1=User &2=Node 482 |CR|15Sending chat request to |&1...|DE|DE|CR
; User2User chat mode starting
483 |CL|09|17 ° |15Chat mode engaged.|$X70 ESC/Quit |16|CR
; User2User chat mode ended
484 |CL|09|17 ° |15Chat mode end.|$X79 |16|DE|DE
; User2User accept chat page request? &1=user &2=Node 485 |CL|15|&1 is requesting private user chat. Accept? |11
; MsgBase quickscan header prompt
486 |CR|12Starting Quick Scan|CR
; MsgBase quickscan Scanning prompt
; &1=basename &2=current base &3=total bases
487 Scanning |&1 [|&2 of |&3]...
; MsgBase quickscan base list prompt
; &4=msgs in base &5=new messages &6=your messages &7=global total msg
; &8=global new msgs &9=global your msgs
488 |03Base: |14|$R40|&1 |03Total: |09|$L04|&4|03 New: |11|$L04|&5 |03Yours: |12|$L03|&6
; MsgBase quickscan footer prompt
; &7=global total msg &8=global new msgs &9=global your msgs
489 |CRQuick Scan complete. |CR|CR|PA
; Msg header flags text one word each separated by a space ; 1=Local 2=Echo 3=Private 4=Sent 5=Delete 6=Received 490 Local,Echo,Priv,Sent,Del,Rcvd
; File base filesize flags one word separated by a space ; 1=offline 2=failed 3=unvalidated 4=GB 5=MB 6=KB 7=B 491 OFFLINE FAILED UNVALID GB MB KB B
; Forward msg: which base
492 |CR|09Forward message to which base (?/List): |XX
; Sysop password prompt
493 |CR|09Sysop Password: |XX
; Normal msg reader: Remove from newscan? (after I command) 494 |CR|12Remove |15|MB |12from message newscan? |XX
; Lightbar msg reader: Remove from newscan (after I command) 495 |CR|12Remove |15|MB |12from message newscan? |XX
; Netmail send address prompt with active nodelist searching 496 |CR|09Enter netmail address or search criteria (|10?|09/|10Help|09): |11
; Nodelist browser prompt
497 |CR|09Enter nodelist search criteria (|10?|09/|10Help|09): |11
; Nodelist search results header
498 |CR|15Node System Name Location SysOp |CR|09============ ========================== ================== ====================
; Node list search results
; &1=addr &2=bbsname &3=location &4=sysop &5=phone &6=internet
499 |10|$R12|&1 |15|$R26|&2 |11|$R18|&3 |09|$R20|&4
; Node list single result
500 |CR|03 Address: |14|&1|CR|03System Name: |11|&2|CR|03 Location: |11|&3|CR|03 Operator: |11|&4|CR|03 Phone: |11|&5|CR|03 Internet: |11|&6
; Node list search "found X matches" &1=# of matches 501 |CR|03Found |11|&1 |03matches.
; Netmail send confirmation
; &1=addr &2=bbsname &3=location &4=sysop &5=phone &6=internet &7=to
502 |CR|12Send netmail to |15|&7|07 at |15|&1|12? |11
; QWK .REP complete/results prompt
; &1=msgs imported &2=msgs failed &3=bases added to scan &4=bases removed
503 |10SUCCESS|01.|CR|CR|11- |03Posted |11|&1 |03new messages (|11|&2 |03failed)|CR|11- |03Added |11|&3 |03bases to new scan (|11|&4 |03removed).|CR|CR|PA
; Standard message reader: Lastread pointer set &1 = msg number 504 |CR|11Last read pointer has been set to message number |&1.|CR|CR|PA
; Lightbar reader: Lastread pointer set &1 = msg number 505 |CR|11Last read pointer has been set to message number |&1.|CR|CR|PA
; QuickScan message list header &2=basename 506 |15From Base Subject|CR|09=============== ==================== ==========================================
; QuickScan message list middle
; &1=msg# &2=basename &3=from &4=to &5=subject &6=date
507 |10|$R15|&3 |09|$R20|&2 |11|$R42|&5
; QuickScan message list footer
508 |09|$D79=|CR
; Message reply options (standard)
; &1=base name &2=reply to name &3=msg subject
509 |16|CL|09|17 ° |15Message Reply |$X79 |16|CR|CR|03 Area: |11|&1|CR |03To: |11|&2|CR|03 Subject: |11|$R65|&3|CR|CR|09Reply area (|11ENTER|09) Current, |09(|11B|09)ase, |09(|11E|09)mail, |09(|11Q|09)uit? |14
; Message reply options (lightbar)
; &1=base name &2=reply to name &3=msg subject
510 |16|CL|09|17 ° |15Message Reply |$X79 |16|CR|CR|03 Area: |11|&1|CR |03To: |11|&2|CR|03 Subject: |11|$R65|&3|CR|CR|09Reply area (|11ENTER|09) Current, |09(|11B|09)ase, |09(|11E|09)mail, |09(|11Q|09)uit? |14
; Message reply select base prompt
511 |CR|09Select message base for reply [|10?|09/|10List|09]: |11
; Message "replying to X base" prompt &1=base name 512 |CR|03Posting reply message to base |11|&1|03.
; Message post: "post msg as private" in pub/priv type base 513 |CR|12Post this as a private message? |11
; Message reply: "post msg as private" in pub/priv type base 514 |CR|12Post this as a private message? |11
; Msg Editor: No permission to upload message text 515 |CR|12You do not have access to upload message text.|CR|CR|PA
; Terminal emulation for TE mci code
; word1=ASCII word2=ANSI
516 ASCII ANSI
; UB results (File list type)
; word1=Normal word2=Lightbar
517 Normal Lightbar
; UE results (message editor type)
; word1=line, word2=full word3=ask
518 Line Full Ask
; UG results (gender/sex)
; word1=female word2=male word3=unknown
519 Female Male Unknown
; UJ results (message reader type)
; word1=Normal word2=Lightbar
520 Normal Lightbar
; UQ results (lightbar quote style)
; word1=standard word2=windowed
521 Standard Windowed
; Yes and No text used in various places
; Word1=no word2=Yes
522 No Yes
; Off and On text used in various places
; Word1=Off word2=On
523 Off On
; New scan toggle yes/no (on/off) toggle text
; Word1=no word2=Yes
524 No Yes
; Editing auto signature message subject 525 Signature Editor
; Months of the year (short name) one word per, Jan-Dec separated by a space 526 Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec
; Months of the year (long name) one word per, Jan-Dec separated by a space 527 January February March April May June July August September October November December