LinHES

1

h1.  Upgrading LinHES R7X 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

1

   To create the backup run: 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

1

52

1

h3. Copy Media files onto the R8 system

53

1

54

1

   With R8 the location for data has changed to /data/storage/$drive_serial_number.

55

1

   For convenience a symlink of /myth → /data/storage/$drive_serial_number/media has been provided.

56

1

57

1

h3. Add additional drives

58

1

59

1

  The last step is to add back any additional media drives that were part of the R7 system.

60

1

   Adding them can be done two different ways.

61

1

    a)  add them with the command:  add_storage.py –no_destruction

62

1

      This will add the drives in an automated fashion and follow the R8 layout.

63

1

     *The drives will NOT be formatted or partitioned.*

64

1

     *The drives will be available for auto-sharing and added to storage groups.*

65

1

66

1

    b) The drives may also be added manually without using add_storage.

67

1

       The steps for doing this are the same as they were in R7.

68

1

       As long as the drive is mounted at start up  add_storage will ignore any drive that is added manually.

69

70

71

72

At this point all the media and settings should be migrated over.

73

1