48f16f3763904759916c68a2f8d525c0f810d7d3
[spider.git] / UPGRADE.mojo
1 There are the notes for upgrading to the mojo branch.
2
3 Prerequisites:
4
5 perl 5.10.1, preferably 5.14.1 or greater. This basically means running ubuntu 12.04 or later (or one of the other linux distros of similar age). The install instructions are for debian based systems.
6
7 cpamminus:
8
9         sudo apt-get install cpanminus
10 or
11         curl -L https://cpanmin.us | perl - --sudo App::cpanminus
12
13 You will need the following CPAN packages:
14
15         sudo cpanm EV Mojolicious Mojo::IOLoop::ForkCall JSON JSON::XS
16
17 login as the sysop user.
18
19 Edit your /spider/local/DXVars.pm so that the bottom of the looks something like:
20
21 ----  old ----
22
23           # the port number of the cluster (just leave this, unless it REALLY matters to you)
24           $clusterport = 27754;
25
26           # your favorite way to say 'Yes'
27           $yes = 'Yes';
28
29           # your favorite way to say 'No'
30           $no = 'No';
31
32           # the interval between unsolicited prompts if not traffic
33           $user_interval = 11*60;
34
35           # data files live in 
36           $data = "$root/data";
37
38           # system files live in
39           $system = "$root/sys";
40
41           # command files live in
42           $cmd = "$root/cmd";
43
44           # local command files live in (and overide $cmd)
45           $localcmd = "$root/local_cmd";
46
47           # where the user data lives
48           $userfn = "$data/users";
49
50           # the "message of the day" file
51           $motd = "$data/motd";
52
53           # are we debugging ?
54           @debug = qw(chan state msg cron );
55
56 ---- to new ---
57
58          # the port number of the cluster (just leave this, unless it REALLY matters to you)
59          $clusterport = 27754;
60
61          # your favorite way to say 'Yes'
62          $yes = 'Yes';
63
64          # your favorite way to say 'No'
65          $no = 'No';
66
67          # this is where the paths used to be
68          
69          # are we debugging ?
70          @debug = qw(chan state msg cron );
71
72 ----      ------
73
74 There may be other stuff after this in DXVars.pm, that doesn't matter. The point is to remove all the paths in DXVars.pm.
75
76 Now run the console program or telnet localhost and login as the sysop user.
77
78         export_users
79         bye
80
81 as the sysop user:
82
83    sudo service dxspider stop
84    mkdir /spider/local_data
85    git reset --hard
86    git pull
87    git checkout --track -b mojo origin/mojo
88
89 if you have not already done this:
90
91    sudo ln -s /spider/perl/console.pl /usr/local/bin/dx
92    sudo ln -s /spider/perl/*dbg /usr/local/bin
93
94 Now in another window run:
95
96         watchdbg
97
98 and finally:
99
100    service dxspider start
101
102
103
104
105
106