add an RBN line to progress

[spider.git] / UPGRADE.mojo

diff --git a/UPGRADE.mojo b/UPGRADE.mojo
index c6d3d3390f658e0b6c66895bd67d7735579c54ff..5e5a402e14505a139bb6ee526e992df785a9f416 100644 (file)
--- a/UPGRADE.mojo
+++ b/UPGRADE.mojo
@@ -16,6 +16,9 @@ DXSpider node. But serious work on this won't start until we have a stable base
 on. Apart from anything else there will, almost certainly, need to be some internal data
 structure reorganisation before a decent web frontend could be constructed.
 
+*IMPORTANT* There is an action needed to go from mojo build 228 and below. See items marked
+*IMPORTANT* below. 
+
 Upgrading is not for the faint of heart. There is no installation script (but there
 will be) so, for the time being, you need to do some manual editing. Also, while there is
 a backward path, it will involve moving various files from their new home (/spider/local_data),
@@ -50,10 +53,30 @@ or
 
 You will need the following CPAN packages:
 
-       sudo cpanm EV Mojolicious Mojo::IOLoop::ForkCall JSON JSON::XS
+       If you are on a Debian based system (Devuan, Ubuntu, Mint etc) that is reasonably new (I use Ubuntu
+       18.04 and Debian 10) then you can simply do:
+
+       sudo apt-get install libev-perl libmojolicious-perl libjson-perl libjson-xs-perl libdata-structure-util-perl
+
+    or on Redhat based systems you can install the very similarly (but not the same) named
+       packages. I don't the exact names but using anything less than Centos 7 is likely to cause
+       a world of pain. Also I doubt that EV and Mojolicious are packaged for Centos at all.
+
+       If in doubt or it is taking too long to find the packages you should build from CPAN. Note: you may
+       need to install the essential packages to build some of these. At the very least you will need
+       to install 'make' (sudo apt-get install make) or just get everything you are likely to need with:
+       
+       sudo apt-get install build-essential.
+
+       sudo cpanm EV Mojolicious JSON JSON::XS Data::Structure::Util
+       
        # just in case it's missing
        sudo apt-get install top
 
+Please make sure that, if you insist on using operating system packages, that your Mojolicious is
+at least version 7.26. Mojo::IOLoop::ForkCall is NOT LONGER IN USE! The current version at time
+of writing is 8.36.
+
 Login as the sysop user.
 
 Edit your /spider/local/DXVars.pm so that the bottom of the file is changed from something like:
@@ -128,6 +151,8 @@ Now run the console program or telnet localhost and login as the sysop user.
 as the sysop user:
 
    sudo service dxspider stop
+   or
+   sudo systemctl stop dxspider
 
 having stopped the node:
 
@@ -141,6 +166,10 @@ if you have not already done this:
    sudo ln -s /spider/perl/console.pl /usr/local/bin/dx
    sudo ln -s /spider/perl/*dbg /usr/local/bin
 
+*IMPORTANT* (for any build of dxspider) regardless of branch below build 229 run:
+
+       /spider/perl/convert-users-v3-to-v4.pl
+       
 Now in another window run:
 
        watchdbg
@@ -148,9 +177,11 @@ Now in another window run:
 and finally:
 
    sudo service dxspider start
+   or
+   sudo service systemctl start dxspider
 
 You should be aware that this code base is now under active development and, if you do a 'git pull',
-what you get may be broken. But, if this does happen, the likelyhood is that I am actively working
+what you get may be broken. But, if this does happen, the likelihood is that I am actively working
 on the codebase and any brokenness may be fixed (maybe in minutes) with another 'git pull'.
 
 I try very hard not to leave it in a broken state...