Configuring an Imported Virtual Machine (RHEL)

You can configure values for an imported virtual machine (VM) in AWS and Azure for it to function correctly.

Prerequisites

Before you can configure a VM, you must perform the following steps:

1. Import a VM. For more information, see VM Import/Export for AWS or Import/Export Services for Azure.
2. Start the instance to which you imported the VM for iProcess Engine and the database server. See Launch Your Instance on the AWS or Virtual Machines Documentation for Azure.

Procedure

  1. Turn off the firewall for all created instances.

  2. In the database server files, update the private IP of your domain on the instance where you imported iProcess Engine. For example, for an Oracle Database Server, update tnsnames.ora and listener.ora files.

  3. When you import a virtual machine in AWS or Azure, it is assigned a dynamic machine name. However, iProcess Engine still has the old machine name entry because of which it cannot be recognized by the connected peripherals or applications.

    To fix this, correct the machine name for node entry in swpro.node_cluster table. You can use one of the following options to change the machine name:

    — Run the following command:
    UPDATE swpro.node_cluster SET physical_machine_name='ip-192-0-2-0' where master=1;
    where "ip-192-0-2-0" is the hostname of the machine.
    — Run the hostname command to get the string to set the correct name here.

  4. To avoid machine name mismatch errors, remove old machine entries from /etc/hosts.

  5. To restrict iProcess Engine processes from accepting incoming RPC requests from within a port range, add a fixed port range by running the following commands. Run the following commands to add a fixed port range:

    6. swadm ADD_RANGE -p <port_number> -s <port_range>
    Example: swadm ADD_RANGE -p 46000 -s 20
    swadm SET_RANGE 1 <port_range_ID> 
    Example: swadm SET_RANGE 1 1
    Note: You must perform this step if your iProcess Engine is in a firewalled environment.

    For more information, see “Administering Firewall Port Ranges” in the TIBCO iProcess Engine Administrator’s Guide.

  6. (Only for Oracle Database Server) Add an AQ port range by running the following command:

    swadm ADD_AQ_PORT_RANGE 1 <port_number> <port_range>
    Example: swadm ADD_AQ_PORT_RANGE 1 48000 50

What to do next

After configuring the imported VMs, you must configure security groups for each VM to control inbound and outbound connections. For more information, see Configuring Security Groups.