NAME

pmx-location - Change the configured IP address and hostname of a PureMessage server.


SYNOPSIS

 pmx-location [options]


DESCRIPTION

This tool allows you to set up PureMessage with a temporary IP address/hostname.

For example you may want set up PureMessage in one location, and then change the location when you are ready to implement PureMessage in a live production environment.

To change the IP address and hostname of a PureMessage server, run:

  pmx-location --prev-hostname OldHostname.example.com
    --new-hostname NewHostname.example.com --prev-ip 192.0.2.10
    --new-ip 192.0.2.25

If no options are specifed, the pmx-location command returns the current hostname and IP address.


OPTIONS

The following options are recognized by pmx-location:

--prev-hostname
Use in conjunction with --new-hostname to switch to a new hostname.

--new-hostname
Use in conjunction with --prev-hostname to switch to a new hostname.

--prev-ip
Use in conjunction with --new-ip to switch from an old to new IP address.

--new-ip
Use in conjunction with --prev-ip to switch from an old to new IP address.

--get-hostname
Displays the current hostname.

--get-ip
Displays the current IP address.

Changing the IP Address/Hostname in a Multi-Server Installation.

If you want to use pmx-location in a multi-server installation of PureMessage, additional steps are required (this procedure assumes that you are changing the IP addressess/hostnames of the edge servers as well as the database server):

  1. Assign a new IP/hostname to the database server.

  2. On the PureMessage database server, run pmx-location.

  3. Publish the pmdb.conf file to the edge servers. This file is included in the PureMesssage-Database-Config publication. See the 'Server Groups' documentation for more information.

  4. Assign a new IP address/hostname to each of the edge servers.

  5. Update /opt/pmx6/postgres/var/data with IP address/hostname changes.

  6. On each edge server, run pmx-location.


COPYRIGHT

Copyright (C) 2000-2008 Sophos Group. All rights reserved. Sophos and PureMessage are trademarks of Sophos Plc and Sophos Group.