[PVFS-users] guide for upgrading of pvfs

[Rob Ross]

Hi,

There's no document per-se.

If you have a backup of the data from the old volume, or you don't need
the data, then the easiest thing to do is to (a) copy your old .iodtab,
/etc/iod.conf, and /etc/pvfstab (if you have one), (b) delete everything,
and (c) follow the installation instructions again, using the old .iodtab 
and iod.conf as examples.

If you do need to keep the data that is on the volume, then you need to be 
a little more careful:
- build the new pvfs and pvfs-kernel versions
- unmount the file system on all clients, stop all the servers (mgr and iods)
- copy the new binaries into place, saving the old ones if you want
  - clients get pvfsd and pvfs.o
  - manager gets mgr
  - I/O servers get iod
- optionally test everything with a new file system, so you know it works
  - create new .pvfsdir, .iodtab with mkmgrconf
  - save old /etc/iod.conf, copy new one into place
- assuming that worked, upgrade old file system
  - keep original .iodtab, .pvfsdir, iod.conf files
  - run migration program (in your case migrate-1.5.6-to-1.5.8, which is 
    latest released metadata version as of today)

    This is run on the metadata server (where the mgr runs) with:

      find /path/to/metadata/dir -type f -not -name .iodtab \
        -not -name .pvfsdir -exec migrate-1.5.6-to-1.5.8 \{\} \;

    with your root metadata directory (where you created the .iodtab 
    file) is substituted for "/path/to/metadata/dir".
- restart servers, remount

The only thing to keep in mind is that the migration program needs to be 
run or the mgr won't be able to interpret the old metadata.  Also, there 
is no migrate-1.5.8-to-1.5.6, so you can't go *back* after you've run that 
program, at least not without some C coding.

Regards,

Rob

On Mon, 26 Jul 2004, kenix y wrote:

> May I know if there is a guide somewhere for upgrading of pvfs?
> I've tried to use the one for installation of pvfs but there was always 
> errors.
> I'm currently using ver 1.5.6 and wish to upgrade to 1.6.3.
> >From what I know I just need to kill mgr, iod and pvfsd before starting the 
> upgrade by following the quick start, is that right?
> Is there anything else that I am supposed to do?