If you have a Virtual Machine (VM) where Fiorano software is installed and now you need another Virtual Machine or machines with the entire file system, configuration and settings (such as Fiorano installation folder and java version) that are exactly the same as the existing VM, it can be accomplished by the process called Cloning.
Cloning is the process of creating an independent copy of an existing VM which in turn becomes the parent of the clone, whereas this clone will not share anything with the parent and vice versa.
Cloning helps in making as many copies of a virtual machine as you want from an already configured machine. Virtual machines with identical configuration can be assigned to a group which requires machines with same configuration and installation files.
There are basically two types of cloning which are:
Full Clone—An independent copy of a virtual machine that shares nothing with the parent virtual machine after the cloning operation. Ongoing operation of a full clone is entirely separate from the parent virtual machine.
Linked Clone—A copy of a virtual machine that shares virtual disks with the parent virtual machine in an ongoing manner. This conserves disk space, and allows multiple virtual machines to use the same software installation.
Prerequisites
- Install VMware Workstation 5.0 (or higher version) in your system or upgrade to Version 5 (VM > Upgrade from your VMware application) in case you have an older version installed.
- If you are upgrading a virtual machine that runs from a physical disk and not from a virtual disk, ignore the following message and click OK to continue:"Unable to upgrade <drivename>. One of the supplied parameters is invalid."
- Before starting with cloning (also before upgrading, in case you are upgrading to Workstation 5.0), power off the virtual machine that needs to be cloned.
- Take a snapshot (VM > Snapshot > Take Snapshot) to save the present state (at the moment of taking snapshot) of the virtual machine, so that you can revert to this particular state in case you make any mistake during cloning.
Procedure
The Clone Virtual Machine Wizard guides you through the process of making a clone and you do not require manually locating and copying the parent virtual machine files. The wizard automatically creates a new MAC address and other unique identifiers for the clone.
Below sections explain how to do a Full Clone and Linked Clone as well.
Full Clone
To create a clone of a Virtual Machine, perform the following actions:
- Select the Virtual Machine from the VMWare application using one of the two ways below:
- From the Favorites list at the left side of the Workstation window).
- Open (File > Open) and browse for the VM configuration (.vmx) file.
- Open the Clone Virtual Machine Wizard (VM > Clone). In the Welcome page of the wizard, click Next.
Figure 1: Clone Virtual Machine Wizard
In the Clone Source panel, select From current state option and click Next.
Figure 2: Choosing the state from which clone has to be created
- In the Clone Type panel, select Create a full clone and click Next.
Figure 3: Choosing to create a Full Clone
- In the Name of the New Virtual Machine panel, change the name of the clone and change the location if required by clicking Browse button, and then click Finish.
Figure 4: Choosing Name and Location of the cloned VM
In the Cloning Virtual Machine panel where it displays the final status of cloning, click Done to complete the cloning process and exit from the wizard.
Figure 5: Panel showing the status of completion of cloning
Linked Clone
A linked clone is made from a snapshot of the parent where all the files available on the parent at the moment of taking the snapshot will be available to the linked clone. But, unlike Full Cloned VM, Linked Clone VM has to be connected to the Parent VM.
To create a Linked Clone, select Create a linked clone option present in the Clone Type panel of the Clone Virtual Machine Wizard. Rest of the steps are the same as in Full Clone; refer Procedure section below.
Figure 6: Choosing to create a Linked Clone
Linked clones are created swiftly, so you can easily create a unique virtual machine for each task you have. You can also easily share a virtual machine with other users by storing it on your local network where other users can quickly make a linked clone.
Linked Cloning facilitates collaboration, for example, after a support team reproduces a bug in a virtual machine, an engineer can quickly make a linked clone of that virtual machine to work on the bug. For such short-term but timely requirements, linked cloning can be used instead of the Full Clone.
Peer Server Profile Setup
Fiorano Peer Servers are generally installed as HA (High Availability) Pairs. Replicated HA is used where the Active Server (the server which is in the Active State) replicates its data store and state to the Passive Server, thus keeping both servers in sync.
An HA pair involves two servers - a primary server and a secondary server. After cloning, as both the servers will have the same configuration, a few changes are required in the configuration so that the servers can communicate to each other and work flawlessly.
The following sections outline how to setup an HA for the new VM after cloning.
Changing the Profiles
Fiorano server profiles are present at the location FIORANO_HOME/esb/server/profiles.
The changes that are to be made are mentioned in the below sections.
Primary Server changes
Login to the server designated as the primary server. In the cloned VM, the folder with the name {profile_name}/primary represents the Primary server and this folder needs to be modified as explained in the below section.
Profile Folder Changes
Rename the {profile_name} folder to the new profile name, that is, the new path becomes FioranoHome/esb/server/profiles/{new_profile_name }/primary. This folder is referred as PROFILE_FOLDER in rest of this section.
Profile Pair ID Changes
Both the profiles share an ID which is used to establish connection with Enterprise Server.To define this, open profile.xml file present inside the PROFILE_FOLDER.
Change value of the attribute 'name' to <NewServer ID>
Figure 7: Changing the Profile ID
Profile Configuration Changes
The Profile configuration XML file (Configs.xml) is present in the PROFILE_FOLDER/conf directory.
Change the following attributes and set to the IP address of the secondary server:
- The attribute BackupHAIPAddress of the element HA_KRPCPROVIDER
- The attribute BackupServerIP of the element DEFAULT_OBJS_CONFIG
Figure 8: Changing Backup HA IP Address and Backup Server IP Address
The attribute 'ServerAddress' of the element CONNECTION_MANAGER must be changed and set to the IP address of the primary server.
Figure 9: Changing Server Address
The LockFile attribute of element RPL_HA_MANAGER must be updated with the Lock File name for the corresponding HA Pair.
Figure 10: Updating the LockFile name
FES Connection Configuration
FES Connection configuration is present as the element MESSAGE_BUS_CONFIG as shown in the figure . This will be already present in the cloned VM and need not be changed.
Figure 11: Changing Primary URL and Backup URL
Secondary Server changes
Make the corresponding changes in the Secondary Server as well following the steps as mentioned above.
Changes to enable Auto Start
In case of Windows setup, please uninstall the old service and reinstall the service with the profile option changed to the new profile setting.
In case of Linux servers, please follow the steps below:-
Fiorano Peer Server can be started as a service by adding it to init.d services. The executable to run server as a service, server-service.sh will be present in the Cloned VM at the location /etc/init.d. This file needs to be modified and the directory to which the profile is renamed to must be specified against the property 'PROFILE', that is, PROFILE = {new_profile_name}/primary
Figure 12: Specifying profile name
Edit the file and change the value of variable PROFILE by executing the following command:
Add the file to system startup by executing the following command:
Starting and Stopping Servers
In case of windows, this can be done from the windows services manager, by starting and stopping the installed Fiorano windows service.
In case of Linux, the following commands need to be used:
Log on to the primary and secondary servers and navigate to /etc/init.d
Start command
Stop command
License Provisioning
The necessary license files must be copied to the folder FIORANO_HOME/licenses.