Installing IBM Maximo (Control Desk)
This goes out to all the people who are trying to install IBM Control Desk for the first time. This is not an easy task. It requires significant planning and perhaps practice before any change is attempted to the production installation.
This example was carried out on a bare Metal ESXi version 6.7. with no VCentre attached.
We also installed version 184.108.40.206, which was later upgraded to 220.127.116.11. Attempts to go straight to 18.104.22.168 repeatedly failed, although the documentation says it should be possible. Because this is a development build and not expecting any high workloads, IBM WebSphere, IBM Maximo and an IBM DB2 database were built onto the same VM running Centos 7.
In a high workload or production environment, Responsiv recommend that you separate the Database from the Application and build them on a separate VM’s.
This document assumes that you have already built a Control Desk instance with a minimum of 4 VCPU, 32Gb Memory, and 150GB of disk space. We will also assume you have an IBM ID to be able to download the required images from passport advantage.
There are a couple of preparation steps that need to be carried out first, to allow the installation to run successfully. This should be done on each Virtual Server.
- Change the permissions on /tmp and /home to 777. This will be change back to original settings once installation has completed.
- Set SELinux to permissive and now to really make your skin crawl, stop the firewall 😐. This is all temporary and will be reversed at the end.
- Check your shared memory size is not less than 268435456 bytes, if it is, increase it with the Linux command
- sysctl -w kernel.shmmax=18446744073692774399.
- Change hard and soft ulimits to 8192 permanently for root, by
- editing your /etc/security/limits.cong file.
- Increase your port numbers to be ipv4.ip_local_port_range = 1024 65535 by
- editing your /etc/sysctl.conf file.
- Install the following libraries:
- yum install nss-softokn-freebl.i686
- yum install libgcc.i686
- yum install glibc.i686
- yum install libXtst.i686
- yum install compat-libstdc++-33-3.2.3-72.el7.i686cd
- yum install compat-libstdc++-33.x86_64
Maximo on Centos
In this example we are installing Maximo onto a Centos operating system, however, Maximo is only supported on IBM Red Hat Enterprise Linux. To allow this example installation to work, you will have to modify Centos to report as a Red Hat release. Otherwise use Red Hat
- Check what is in /etc/centos-release-upstream, copy the portion “Red Hat Enterprise Linux 7.6 (Source)” and replace content of /etc/centos-release. Suggest you make a copy of original file /etc/centos-release just for safe keeping.
That should now cover all the OS pre-requirements to get IBM control desk and Maximo installed.
To perform the installation you need your IBM ID. Log onto passport advantage and download the following files:
Copy the files to your server, this example they were copied to /Downloads. We found it best to merge these contents to get the installation to work. We created a merged folder /Downloads/merge and extracted all of the above, except for icd_4_maximo_7.6.1_spm.zip.zip into this merged folder. This file icd_4_maximo_7.6.1_spm.zip.zip does not need to be extracted.
You will also require the IBM Installation Manager to be installed. For installation on Linux use this link to get the details for the file and installation instructions.
Using the IBM Installation Manger
Now that IBM Installation Manger is installed, we can carry on with what we set out to do.
Launch the Installation Manager /opt/IBM/InstallationManager/eclipse/IBMIM, select File, preferences in the top right corner, Add repository. Use the browse button to navigate to your file location, this example /Downloads/merge.
Once you have added all the above repo, exit from the menu, back to the main page. Here you will now select the Installation Icon. Tick all the options that come up, in this example 13 packages were selected. A package validation should start, accept the license when requested. Follow the wizard by inputting your data and selecting next on each screen, until you get the install button. Once the installation of WebSphere and DB2 finishes, you will be presented with a screen to open “IBM Tivoli process automation engine configuration utility” or None.
Select None at this stage and click finish.
Increase the heap
I strongly recommend increasing your heap size at this point.
By default, the heap is set to 256m, but the IBM Maximo installation keeps failing with an out of memory error.
Edit “/opt/IBM/WebSphere/AppServer/deploytool/itp/ejbdeploy.sh” to change the heap, changing the 256 to 2048 for both Xms and Xmx.
- if “%EJBDEPLOY_JVM_HEAP%”==”” ( set EJBDEPLOY_JVM_HEAP=-Xms2048m -Xmx2048m
) else ( echo “using JVM heap %EJBDEPLOY_JVM_HEAP%” )
IBM Tivoli process automation engine
Start the IBM Tivoli process automation engine configuration utility with the following command, ./opt/IBM/SMP/ConfigTool/ConfigUI. Select the first option “Prepare WebSphere Application Server for Configuration” Again this will open a wizard that you need to follow and enter all your own details.
These will vary on each installation, but most of the defaults can be kept. Once you have entered your wasadmin password, Select the first option “Use the default authentication mechanism for administrative security” an click the finish button. This can take some time depending on your Virtual Machine setup. This example took approximatley 20 minutes. Once complete and you select OK, you will be taken back to the main page of the IBM Tivoli automation suite.
You will now have to Configure a New Deployment. Again a wizard will be opened where you can input the correct details regarding your DB and WebSphere servers. Under the DB instance section enter your installation directory, default is /opt/ibm/db2/V11.1 (version may differ). Supply the instance name port and password e.g ctginst1, 50005, ********
On the next screen we will fill in the maximo details: database name, Schema, database user and password.
The wizard at this point will now continue with the application server details. Enter your SOAP port, user and a password. For the application security, select a password for each of the users listed, you can use the same one, but this is not very secure.
Select your base language followed by any additional languges that you would like maximo to make use of.
In the Apply Deployment Operations screen, we deselected the last 2 option “Build the application EAR file” and “Deploy the application EAR file to the application server”. We will run these manually later manually to save some time. In this example, the apply deployment ran for 3 hours.
Keep an eye out on the messages that appear. As this was my first time with the maximo product, it took me several attempt to get past this stage. Hence the decision to write this document.
Some messages that you will be happy to see are:
CTGIN2213I:unDeployMaximoApplication completed successfully
CTGIN2109I: The database instance was created succesfully
Running validation and configuration
When it finally finishes Select No and close the Tivoli Application.
IBM Control Desk is not deployed at this point.
Remember we did not tick the last 2 option regarding the EAR file creation and deployment.
Manually check the installation
This is a good time to do some manual checks.
Confirm you do not have any file systems that are close to full by running a df -h command and confirm the 2 below error logs have nothing to be concerned about in them:
Build the maximo ear file from command line ./opt/IBM/SMP/maximo/deployment/buildmaximoearwas8.sh
This will take anywhere from 30 minutes to 1 hour.
Do the upgrade!
Upgrade Maximo to latest Version 22.214.171.124 (latest at the time of writing)
Go back to passport advantage or fix central and download the follow packages.
Once again extract the files icd_126.96.36.199_part1_spm.zip and icd_188.8.131.52_part1_spm.zip into the same folder e.g merged12. Once again kick off the IBM installation Manager with ./opt/IBM/InstallationManager/eclipse/IBMIM
Go back to file -> preferences. Untick the previously used repositories and assign new ones for the upgrade. Below screen grab explains best.
This time, from the main menu select Update. Make sure to select all Maximo versions listed when the update packages screen is presented. Accept the license once more and select update. Again, when the Installation manager is finished and present the option to select “IBM Tivoli process automation engine configuration utility” select None.
Extract the contents of the file TPAE_7611_IFIX_184.108.40.20691121-0609.zip to /opt/IBM/SMP/maximo folder.
Manually start the Tivoli automation Suite with /opt/IBM/SMP/ConfigTool/ConfigUI, under Deployment Operations select “Update Database and Build and Deploy Application EAR Files”, walk through the wizard but only select the first option “Apply the changes to the Database” on the Apply Deployment Operations page. Leave the two options regarding the EAR file unticked once more. Click finish and let it run. Accept the warning message that you must build and deploy the EAR file. The EAR file takes quite some time, and we only want to do it at the end. Therefore, we keep unselecting these options.
From the command line run the ./opt/IBM/SMP/maximo/tools/maximo/updatedb.sh script.
Now for the ifix installation
Back to IBM InstallationManager ./opt/IBM/InstallationManager/eclipse/IBMIM, file -> preferences untick previously selected repositories, browse to file TPAE_7611_IFIX_20200824-1011.im.zip
Go back to main screen selecting update option once again, go through the wizard screens and select update at the end. Once complete select Finish.
Now we can manually start the Tivoli automation Suite again /opt/IBM/SMP/ConfigTool/ConfigUI. Select “Update Database and Build and Deploy Application EAR file” you should get a screen like below where you can see there are 3 versions waiting to be deployed.
We still do not want to select the last two option but rather just get the ifix changes into the mix. We will run the same process as we have done twice already and Select “Apply the changes to the database” let it run and accept the warning at the end regarding building and deploying an application EAR file.
Exit back to a command prompt, just before we run the deployment, we need to add an additional configuration, that is to create a cleanup.sh script and add the line running as part of the buildmaximoear.
Found the below hint on the big wide world of the internet, but forgot to make mention of the URL ☹. Thanks to who ever found this out, it worked for me.
- Create filesh in the Maximo deployment folder (typically /opt/IBM/SMP/maximo/deployment) with the following content:
# Permanent Fix for Heap Out of Memory Error When Deploying Maximo on WebSphere
# Author: Kilian Cirera Sant
# See http://www.aktive.cat/blog/2015/01/permanent-fix-for-heap-out-of-memory-error-when-deploying-maximo-on-websphere
# Copyright 2015 Aktive Software & Consulting, S.L.
find $WAS_PATH/profiles/$WAS_APPSRV/temp/$WAS_NODE -type d -name ‘*’ -delete
find $WAS_PATH/profiles/$WAS_APPSRV/wstemp -type d -name ‘*’ -delete
find $WAS_PATH/profiles/$WAS_APPSRV/logs -type d -name ‘max*’ -delete
rm -rf $WAS_PATH/profiles/$WAS_APPSRV/logs/MXServer
rm -rf $WAS_PATH/profiles/$WAS_APPSRV/logs/RMIRegistry
rm -rf $WAS_PATH/profiles/$WAS_APPSRV/logs/ffdc
- Modify the lines that define WAS_PATH, WAS_APPSRV and WAS_NODE with the correct values for your installation.
- Modify the build scriptscmd and buildmaximoearwas8.sh by doing the same in both files:
- Add the following line:
- Right after the line:
- Add the following line:
Double check your heap sizing is still correct and has not been written over by the upgrade and patches we have installed, cat /opt/IBM/WebSphere/AppServer/deploytool/itp/ejbdeploy.sh and confirm the Xms and Xmx are still set to 2048. This is worth checking, if it has changed you could waste the next 3 hours before it fails with an out of memory error.
Time to kick of the deploy and upgrade. Change directory to /opt/IBM/SMP/ConfigTool/scripts and run the command: reconfigurePae.sh -action updateApplication -deploymaximoear
Once this completes log onto your WebSphere console and check that your applications are all good. You can also now log into your maximo UI and check what version you are running by using the ? icon in the top right hand corner, System Information.
From a System Administration point you have now installed IBM Control Desk on Centos. There will still be a lot of Maximo configuration to be carried out before this becomes a fully functional application.
Remember to set your enforce policy and restart the firewall daemon. Also, you can now change the permissions of /home and /tmp back to what you had them before.
If for example, you had a Development environment and you were now creating a Test environment, you can simply copy the offline database back up and latest log file over to the new Database server. Run a rollforward command on the DB2 to get this DB up to date, “db2 rollforward db db_name to end of logs and stop” This would then include all your maximo configurations from your Development space.
I hope that this quick overview helps you through the mountain ahead and smooths the path for you. If you want any further help please use the contact us in the footer of the Responsiv.co.uk website.
Responsiv connects people to data, and businesses to markets.
Simple. Effective. Distinctive.