Author: Elliot Bonilla
CATEGORY: Tutorials
September 9, 2019

Users Getting Lost? How to Change the URL Context of the Application in IBM Maximo

Author: Elliot Bonilla
CATEGORY: Tutorials
September 9, 2019

Users Getting Lost? How to Change the URL Context of the Application in IBM Maximo

Awhile back, I ran into a client who had three environments co-located. It was a classic “all eggs in one basket” scenario – but in this case they had all the virtual machines in one server.  

The three environments served development, testing, and production, respectively. Their names were Maximo in all three cases. But, the last character of the port number varied between zero, one and two.

At this customer’s site, a typical server name has nine to 12 characters, four characters for the port, and five or six for the application name. So, out of those 18-22 characters, just one character made the distinction between their development, testing, and production environments.

Put yourself in the shoes of a user who has less configuration knowledge; they just use what you point them to. It’s hard to figure out where you are or where you’re going to when one seemingly random character makes all the difference! Needless to say, all too often, I’d received phone calls with people asking, “Where’s my newly submitted work order?” only to realize the user was trying to find a new work order in the development environment, which had two-month old data.

Confused Disney Animation GIF

via GIPHY

To clear up the confusion, they wanted a simple way to individualize the content of the URL without jumping through hoops.

What does the end user see in a URL?

Let’s start with a simple explanation of URLs:

A universal resource locator (URL) is made up of several components:

  • The Protocol (Http, Https, ftp)
  • The server address or Domain Name Server (DNS) look-up
  • The port number
  • The context

The context is the web shared location on the server where the web files are located. In the case of this Maximo implementation, the URLs looked like this:

  • http://Server_Name:9080/Maximo
  • http://Server_Name:9081/Maximo
  • http://Server_Name:9082/Maximo

As you can see, the context is always “Maximo”.

Sometimes, it’s desirable to change the context of the application to something end users are more likely to recognize. For example, systems that have multiple instances of an application on the same server – like development, testing, and production. It may be helpful to name the contexts “maxdev”, “maxtest”, and “maxprod”.

What this customer wanted was to have URLs that looked like this:

  • http://Server_Name:9080/Maximo_Prod
  • http://Server_Name:9081/Maximo_Test
  • http://Server_Name:9082/Maximo_Dev

They wanted to perform this with as little disruption and the shortest amount of downtime possible. So, by following the steps below, we achieved that goal.

How to make your URLs user-friendly in IBM Maximo

The context is configured in the “deployment-application.xml” file of the Maximo application.

In a “standard” deployment, you can find the XML file in the following path:

<maximo_home>/applications/maximo/META-INF

To change the context, first locate the web tags section as shown below:

<web>

<web-uri>maximouiweb.war</web-uri>

<context-root>/maximo</context-root>

</web>

Then, change the word “maximo” to the new_context required for your application.

Save the file, rebuild the EAR file and re-deploy the application.

The new URL will be “protocol//servername:port/new_context”.

We succeeded in individualizing the client's URLs. Now, their users can clearly see “where” they’re going – no more looking for new WOs in the development environment, and no more phone calls (on this issue) for me!

Latest Resources

Similar Posts

Offices
Headquarters - Raleigh, NC
4601 Six Forks Rd Ste 220
Raleigh, NC 27609
Phone: +1 (888) 317-2397
San Antonio, TX
18880 Stone Oak Pkwy
San Antonio, TX 78258
Phone: (210)-201-8189
Gateshead, UK
Baltic Place, S Shore Rd. Gateshead
NE8 3AE, United Kingdom
Phone: +44 191 201 7777
Leeds, UK
1 York Pl, Leeds
LS1 2DR, United Kingdom
Phone: +44 113 827 0080
Melbourne, AU
16 Kirk St, Moe VIC
3825, Australia
Phone: +61 3 5132 2600
Brisbane, AU
8A/36 Agnes St, Fortitude Valley
QLD 4006, Australia
Phone: +61 7 3188 5264
Hamilton, CA
50 Dundas St E, Dundas, ON
L9H 7K6, Canada
Phone: +1 905-544-4144
Dordrecht, NL
Burgemeester de Raadtsingel 67, 3311 JG
Dordrecht, Netherlands
Phone: +31 78 614 6288
Kerkrade, NL
Eurode-Park 1, Kerkrade, Limburg 6461
KB, Netherlands
Phone: +31 78 614 6288
São Paulo, BZ
R. Olimpíadas, 205, 4. Andar
Vila Olimpia, São Paulo, SP, CEP 04551-000
Phone: +55 11 3728-9372
Pretoria, SA
1 Pegasus Building 210 Amarand Ave
Waterkloof Glen, Pretoria, 0181
South Africa
Phone: +27 12 003 2916