Upgrading LinHES R7X to R8

Version 4 (brfransen, 04/28/2013 10:53 am)

1 4 brfransen
h1.  Upgrading LinHES R7.X to R8
2 1
3 1
LinHES R8 contains some fairly significant underlying changes.  
4 1
One of these is the partition layout change which makes a direct in place upgrade from previous versions impossible.   
5 1
However with a little bit of data moving it's possible to update to an R8 install with minimal effort. 
6 1
7 1
h2. *Please read through all the steps before proceeding.*
8 1
9 1
Before starting the update, a decision must be made on where to install R8. Either a new hard drive may be used or the existing hard drive for R7.
10 1
If the drive for R7 is used, then all of /myth, the database and anything else you need should be backed up.   
11 1
*Because it is a destructive process using a new hard drive is recommended.*
12 1
13 1
h3. Backup R7 system
14 1
15 1
 On the R7 system create a system  backup and copy it to another machine. 
16 4 brfransen
   To create the backup run: sudo lh_system_backup_job
17 1
   This will create a file in  /myth/system_backups/  named backup.$todays_date. 
18 1
   Next copy the most recent backup file to another machine, preferably one with a web browser that can be used later. 
19 1
   If you are reusing a R7 hard drive then all of /myth will need to be copied to another machine.
20 1
21 1
h3.  Install R8
22 1
23 1
  Perform a new install of R8, using the same hostname that R7 used.  
24 1
  Only the hostname needs to match, the ip address may be different if needed. 
25 1
  *Before doing the install it's recommended to disconnect any additional data drives that may be in the system.*
26 1
27 1
h3. First setup for R8.
28 1
29 1
 First setup can be skipped, because the data for this step will be restored in the next step.
30 1
31 1
h3.  Restore R7 database into R8 system
32 1
33 1
 Using a web browser open HTTP://$ip_of_r8_machine.
34 1
   Navigate to system->system health
35 1
   On this page you should see “primary server” centered in the screen.
36 1
   Two lines below that will be the hostname of the system just installed. 
37 1
   The name of the system should be underlined indicating it's a link.
38 1
 *If this page doesn't exist  wait up to 10 minutes for the link to be created.* 
39 1
40 1
   Once the link is created, click on hostname to open the operations page for the master backend.
41 1
42 1
 Upload the system backup file from the R7 machine using the “upload file to restore” option on the web page.
43 1
 
44 1
 After upload is complete, go back to the main operations page and select “Restore database”
45 1
 Check partial restore, and finally select the file to restore from the drop down list.
46 1
 Press the GO button to start the restore.  
47 1
  This is using very basic HTML, so the page may appear to stall while it's working. 
48 1
  Just wait it out and it will eventually come back in a few minutes.
49 1
50 1
*After it's done, reboot the machine and validate that the data was restored and the list of videos and recordings was uploaded properly.*
51 2 brfransen
*If the master backend is not available, open mythtv-setup (ctrl+s) and check the value of master_backend_ip *
52 2 brfransen
*Also the backend will not complete startup if certain tuners are defined but not available.  For instance the Ceton InfinitTV tuners*
53 1
54 1
h3. Copy Media files onto the R8 system
55 1
56 1
   With R8 the location for data has changed to /data/storage/$drive_serial_number. 
57 1
   For convenience a symlink of /myth → /data/storage/$drive_serial_number/media has been provided.
58 1
59 1
h3. Add additional drives
60 1
61 1
  The last step is to add back any additional media drives that were part of the R7 system.  
62 1
   Adding them can be done two different ways.
63 3 brfransen
    a)  add them with the command:  add_storage.py --no_destruction
64 1
      This will add the drives in an automated fashion and follow the R8 layout. 
65 1
     *The drives will NOT be formatted or partitioned.* 
66 1
     *The drives will be available for auto-sharing and added to storage groups.*
67 1
68 1
    b) The drives may also be added manually without using add_storage.
69 1
       The steps for doing this are the same as they were in R7. 
70 1
       As long as the drive is mounted at start up  add_storage will ignore any drive that is added manually.
71 1
72 1
73 1
74 1
At this point all the media and settings should be migrated over.
75 1