Moving an ActiveMatrix Host

If you want to move an ActiveMatrix host from one machine to another, use the Edit TIBCO ActiveMatrix BPM Instance wizard on the source machine to prepare the host for moving. After the host has been moved, run the wizard on the target machine to unpack the host in the new location.

Prerequisites

The target machine must already have ActiveMatrix BPM installed, with the same TIBCO_HOME and CONFIG_HOME directory paths as the source machine.
Caution: You can use this wizard for moving only an ActiveMatrix host that meets the following requirements:
  • The host does not contain an ActiveMatrix Administrator node.
  • All nodes that are managed by the host must be running on ActiveMatrix version 3.3 hotfix 3 or later.

Procedure

  1. On the machine on which the ActiveMatrix host is running, run TIBCO Configuration Tool:

    TIBCO_HOME\bpm\n.n\bin\tct

    where TIBCO_HOME is the directory into which ActiveMatrix BPM is installed and n.n is the ActiveMatrix BPM version number.

  2. In the TIBCO Configuration Folder dialog, ensure that an appropriate folder is selected, and click OK.
  3. In the Create new configurations dialog, click Edit TIBCO ActiveMatrix BPM Instance.
    The Edit TIBCO ActiveMatrix BPM Instance wizard is started.
  4. On the Welcome page, ensure that the correct environment name and application name are displayed. In the Edit Action to be Performed list, select Move AMX Host.
  5. On the Administrator Server Configuration page, ensure that the details are correct, and click Next.
  6. On the Package / unpack AMX Host for moving page:
    1. Ensure that Package Host to be moved is selected.
    2. In the TIBCO Host Instance list, ensure that the instance that you want to move is selected.
    3. If you want to create a .zip file of the TIBCO Host instance directory, ensure that the Use zip to package host for move check box is selected and specify the machine and directory to which you want to save the .zip file.
    4. Click Next.
  7. On the Summary page, click Configure.

    The specified ActiveMatrix host and its nodes are stopped, the host is prepared for moving to another machine, and a .zip file is created if you specified this.

  8. If you did not create a .zip file, copy the relevant TIBCO Host instance directory from the CONFIG_HOME\tibcohost directory on the source machine to the corresponding directory on the target machine. Ensure that the user and group permissions are retained.
  9. On the target machine, run TIBCO Configuration Tool:

    TIBCO_HOME\bpm\n.n\bin\tct

    where TIBCO_HOME is the directory into which ActiveMatrix BPM is installed and n.n is the ActiveMatrix BPM version number.

  10. In the TIBCO Configuration Folder dialog, ensure that an appropriate folder is selected, and click OK.
  11. In the Create new configurations dialog, click Edit TIBCO ActiveMatrix BPM Instance.
    The Edit TIBCO ActiveMatrix BPM Instance wizard is started.
  12. On the Welcome page, ensure that the correct environment name and application name are displayed. In the Edit Action to be Performed list, select Move AMX Host.
  13. On the Administrator Server Configuration page, ensure that the details are correct, and click Next.
  14. On the Package / unpack AMX Host for moving page:
    1. Ensure that Unpack Host is selected.
    2. In the Packaged Host File field, specify the path and name of one of the following, as applicable:
      • The .zip file that you created using this wizard
      • The movedhost.properties file in the TIBCO Host instance directory that you copied to this machine
    3. Ensure that the JMX URL field contains the the correct URL to enable TIBCO Host to communicate with the node.
    4. Click Next.
  15. On the Summary page, click Configure.
    The specified ActiveMatrix host is unpacked to this machine using either the .zip file or the movedhost.properties file, and the host is started.
  16. Click Close.
  17. In the Create new configurations dialog, click Close.