19-Feb-2021

Ubuntu FCM Installation and Configuration

Go to https://itsfoss.com/install-linux-in-virtualbox/ and follow the steps for VirtualBox and
Ubuntu (Linux IOS) installation.
 Download and install VirtualBox 6.1.xx version – Refer link in Step 1 from the above link
 Download the latest version of Ubuntu Linux ISO and place the file anywhere in C drive
– Refer Step 2 from the above link.

How install and setup Ubuntu Linux ISO

 Launch Oracle Virtual Box and select NEW
 In Create Virtual Machine window, provide the Name and folder where you would like to
configure the VM. Then, click on Next.
 In Create Virtual Machine – memory size window, provide the RAM size as more than
50% of your windows RAM (here mine is 16GB, hence I have provided 9GB of RAM) and
make sure that the allocated RAM doesn’t cross the RAM scale marker visible below the
slider. Then, click on Next.
 In Create Virtual Machine – Hard disk window, make sure that Create a virtual hard disk
now is selected. Then, click on Next.
 In Create Virtual Hard Disk – Hard disk file type window, make sure that VDI is selected.
Then, click on Next.
 In Create Virtual Hard Disk – Storage on physical hard disk window, make sure that
Dynamically Allocated is selected. Then, click on Next.
 In Create Virtual Hard Disk – File location and size window, Provide the size between
30GB to 50GB. Then, click Create.
 VM will be created and displayed in the left side of the Oracle VM VirtualBox Manager

 Go to Settings
 Click on Shared Folders in Settings window and click on add icon available on the
right of the window
 Provide Folder Path (any folder from your system – the purpose of this shared folder is
to access files / folders between windows and VM. Any files / folders needs to be copy or
moved to VM machine can be placed here and the same can be access within the VM
and vice-versa), Folder Name (this will be reflected in the VM machine), select Auto-
Mount and click on ok.

 Make sure that the Shared Folder that you created is added under the Machine Folders
and click ok.
 Click on Start
 Select the Start-up disk placed in your system i.e., the Ubuntu Linux ISO file which we
have downloaded as part of initial steps and click Start.
 Click on Install Ubuntu
 Click on Continue. No changes required in languages as by default it is set as English.
 Make sure that Normal Installation is selected (uncheck the other options if selected)
and click on Continue
 Make sure that Erase disk (this will not delete any items from your windows. It will clear
the storage in the VM. This will not impact anything in your windows system) and install
Ubuntu is selected and click on Install.
 On pop-up, click on Continue
 In the next window, click on continue
 In the next window, provide the following and click on Continue
o Your Name – Provide any text
o Pick a username – default value will be populated based on Your Name, if
required change it)
o Choose a password – Provide any password
o Confirm your password – Confirm the password
 Once the installation is completed, click on Restart Now

 In the next screen, Press Enter

 Once the system is restarted, login with your password set for the Linux.
 For online accounts - click on Skip
 In case of any software update popups, click on Remind Me Later,
 In the next screen Livepatch, click on Next – don’t select any other button
 In the next window Help improve Ubuntu, select No, don’t send system info and click
Next
 In the next screen, click on next.
 In the final Ready to go Screen, click on Done
 Linux will be loaded as below,
 Right Click on the Desktop and select Open in Terminal or use shortcut Ctrl + Alt + T,
 Terminal will be open as below,
 Execute the below commands one by one,
o sudo apt-get update
Provide the Linux password,
Press Enter. Command will be completed as below,
o Provide next command sudo apt-get install build-essential gcc
make perl dkms and press enter. Command will be executed and provide Y
when asked to continue as below and press enter.
o Once the previous command is executed successfully, execute this command
reboot and press enter
 Once the system is rebooted, go to Devices  Insert Guest Additions CD image… in
Menu Bar
 In the popup, click on Run
 Enter the Linux system password in the popup and press Authenticate
 Press enter to close the terminal
 In the desktop, click on Files
 Once the Files is loaded, click on unmount button for the media
 Go to terminal Ctrl + Alt + T and provide this command sudo adduser <username>
vboxsf in place of <username> provide the Linux system username which you have
provided during Linux creation.
 Reboot / Restart the VM and go to Files - verify that the shared folder added during VM
creation is visible here

 Download the FCM environment and place the zip files (financial-crime-mitigation-cli-
xyz.zip, financial-crime-mitigation-configuration-xyz.zip, financial-crime-mitigation-form-
ear-xyz.ear) and zip the jboss (jBoss_W_Hibernate.zip) and place the same in the
shared folder in the Windows
 Go to VM and check the shared folder, where all the files placed in windows will be
available
 Create a folder in Home available in Files and move / copy all the files from shared
folders
 Files will be moved / copied to the destination folder,

 Create the DB, insert license as usual in your Windows System using the corresponding
FCM environment.
 Unzip all the zip files and create the folder structure as you required.
 Go to the root or the main folder where you have unzipped the fcm environment and
jboss and launch the terminal

 Execute the below commands,

o chmod 777 * -R (This command is used to provide complete access read, wite,
execute, user, group, owner etc for all the files and folders within the specific
folder)
o sudo apt install dos2unix (This will install the dos2unix in Linux)
o find . -type f -name "*.sh" -exec dos2unix {} \+; (Command to
perform dos2unix recursively for all the .sh files available in a folder and its sub-
folder)
o sudo apt install default-jre (This command installs jre into linux) and
provide Y when it prompts.
 Reboot the VM once the installation is completed.
 After reboot, Go to fcm cli  engines  shared-config, open the terminal and execute
initial-setup.sh file with the below command ./initial-setup.sh
Note: In jdbc.properties we should give our IP address and not localhost. The reason is DB
setup is performed in your local windows system and corresponding DB software’s are also
installed and configured only in windows system.

 Make sure that you update the DB name in all required files.
 Go to jboss  Bin  standalone.config and replace the line set
"JAVA_OPTS=-
Xms1303m -Xmx1303m -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m"
to set "JAVA_OPTS=-Xms1G -Xmx4G -XX:MetaspaceSize=1G -
XX:MaxMetaspaceSize=2G"
 To run jboss, provide the below command in jboss  bin – ./standalone.sh
 Below are some of the linux commands related to windows command for executing
Watch Import, Cif Import, Account Loader, Statement Loader. As usual, navigate to the
corresponding bin folders and execute these commands.
o ./watch-private-import.sh --configuration PEP_Mapping.xml --
configname PEP --file /Sanctions_Lists/PEP.csv
o ./cif-import-only.sh -f $PWD/T24.csv --from 2 --target
GB0010001
o ./accountLoader.sh -f T24_ACC.csv -company GB0010001 -
configuration ../config/T24_config_acc.xml
o ./statementLoader.sh -f T24_OP.csv -company GB0010001 -
configuration ../config/T24_config_operation.xml