The previous versions of Maximo all came with an installation guide that helped you install a Maximo application server for production purposes and also for testing or development purposes. In most cases, this is how most of our applications are setup. Unfortunately, Maximo 7 does not come with any demo data or even an installation guide for installing a MaxTest instance. The Maximo install guide does show you how to install one instance on one server, but some of you may want to install a MaxTest application server as well as your MaxProd application server. This guide will show you just how to add a MaxTest Maximo application using WebSphere. It also assumes that you have successfully completed the installation for your Maximo 7 production application.
Create a backup copy of your Maximo production database. I will assume most of you know how to do that, but if you don’t, you can find a guide for backing up a SQL Server database here or an Oracle database here. After you have created a backup, restore the database and name it MaxTest.
Moving on to WebSphere, log into the admin console. The default username is now ‘wasadmin’. Expand ‘Servers’ and click on ‘Application Servers’. There you should find one instance called ‘MXServer’ which is the one you already installed. Click on ‘New’ to create a new app server. Enter ‘MXTest’ as your server name and hit ‘Next’. Accept the default template and check the box for ‘Generate Unique Ports’. Finish and confirm your new app server. Finally save directly to your master configuration.
Click on the ‘MXTest’ app server. Under ‘Server Infrastructure’, expand ‘Java and Process Management’ and click on ‘Process Definition’. Click on ‘Java Virtual Machine’ under the Additional Properties. Here you need to set the Initial Heap Size to 512 and the Maximum Heap Size to 1024. Don’t forget to save to master.
Now we need to know what our new application server is using for ports. Go back to your Application Server list and click on ‘MXTest’, expand ‘Ports’ and make note of the ports numbers for the four port names that begin with ‘WC’. The port numbers should look like this:
These port number were auto generated for you in step 2.
Now we need to create a new virtual host. Expand ‘Environment’ in the left pane and click on ‘Virtual Hosts’. Here you will see a list of hosts such as maximo_host, admin_host, etc. Click on ‘New’ and name it ‘maxtest_host’ and click on Apply. Now click on ‘Host Aliases’. This list should be empty, and we will be creating 5 new aliases. Click on ‘New’ and accept the default port 80 and click ‘Apply’. Next, create four more ports that look like the following:
These port numbers are from step 4.
Go to your maximo installation directory, the default is “C:/ibm/SMP”. In there, you will find a maximo directory. Copy that entire directory and rename it ‘maxtest’. Once you’ve done that, go to “C:/ibm/SMP/maxtest/applications/maximo/META-INF” folder and open the ‘application.xml’ file. Do a search for
and change it to
This will be use in the url for connecting to your new instance. For example, the url for connecting to your maximo test application server will be
Next, edit the same property in the ‘deployment-application.xml’ as well. Save both files.
Open your maximo.properties file found at ‘C:/ibm/SMP/maxtest/applications/maximo/properties’. Change the ‘database’ to the name of your newly created SQL Server database. The database property should look something like this:
Next change the ‘mxe.registry.port’ property. Just to make it simple, just add one to the existing value. Finally, the last property to modify is ‘mxe.int.webappurl’. Change it so look like so:
The last step is to rebuild and deploy your maximo ear files for the newly created maxtest application server. After you are done that, you can access your maximo test environment at ‘http://servername/maxtest’
When you are deploying a new enterprise application for your second instance, make sure you name your application ‘MAXTEST’.