This is for those of you, that have a working installation of HylaFAX
and want to move on to HylaFAX+.

You CAN NOT install the Hylafax+ packages over HylaFAX, because the
internal "house keeping structures" have changed a lot.

This means, YOU WILL LOOSE everything, which is contained within the
various queues. You could, in theory, copy over the faxes themselves,
but there is no way to make the housekeeping aware of them.

1.
So the first thing, you need to do, is make a backup of the 2
directories "/etc/hylafax" and "/var/spool/hylafax" with all their
sub directories and content.

2.
Purge all of the HylaFAX packages from your system.

  "aptitude purge hylafax-server hylafax-client".

3.
Remove the "/etc/hylafax" and "/var/spool/hylafax" directories along
with their content by hand.

  "rm -rf /etc/hylafax"
  "rm -rf /var/spool/hylafax".

4.
Install the HylaFax+ packages.

  "aptitude install hylafaxplus-server".

This will also pull in the "hylafaxplus-client" and "libfaxutil"
packages (and a lot of dependencies).

The installation will tell you, that HylaFAX+ is not configured yet and
to run "faxsetup" and possibly "faxaddmodem".

5.
Before you do that, you have the chance, to reuse some of your
configuration files. You simply copy them over from your backup into
"/etc/hylafax".

You can reuse these list of configuration files:

config.ttyS*
hosts.hfaxd
FaxDispatch
sendfax.conf.

Depending on your old configuration, you may not have all of these.

6.
Now run, as root, "faxsetup" and answer the questions. This gives you a
working configuration, which likely will need some fine tuning.

7.
Stop the service.

  "/etc/init.d/hylafax stop".

It does not hurt, to do this more than once. ;-)

8.
Start the service.

  "/etc/init.d/hylafax start"

9.
If you have customized some configuration files, (likely) you need to
compare these with your backup and edit them, so they contain your
additions and changes. Keep in mind, that some configuration files are
different between HylaFAX and HylaFAX+.

10.
After every change restart the service so it takes effect.


A word of caution: HylaFAX+ and also HylaFAX "bind mount" the
"/etc/hylafax" and "/var/spool/hylafax/etc" directories. While playing
with the configuration, it is possible, that they get, by accident,
mounted more than once. This can be corrected by stopping the service
more than once. Then restart it, like we did above.

If you have faxes within your backup, which you need to keep. Some
people have suggested to install the HylaFax+ packages onto another
machine, and fax them over between the machines, to get them into the
house keeping.

You can move an existing installation of HylaFax+ to another machine, by
simply copying the "/etc/hylafax" and "/var/spool/hylafax" directories
over before you install the packages.

Good Luck
Friedhelm

