IBM Support

Reducing maximo.ear deployment time using ejbdeploy

Technical Blog Post


Abstract

Using ejbdeploy to reduce maximo.ear deployment time to IBM® WebSphere® Application Server.

Body

Important notes before proceeding:

  • This process must be followed exactly.
  • Tivoli's process automation suite Configuration Tool cannot be used to deploy maximo.ear
  • When you install a new Maximo Feature Pack, Interim Fix, or Limited Availability fix is installed, they can include changes to the EJB files. You must follow the steps from the beginning to create a new maximo1.ear file.
  • Increase memory allocated to ejbdeploy following the steps in Maximo EAR deployment fails with OutOfMemory.

If  IBM® Maximo® Spatial Management is installed, also follow the steps in Changing the console session expiration.


  1. In \IBM\SMP\maximo\deployment, run buildmaximoearwas8.
  2. In the same directory, create a directory called was.
  3. Copy the maximo.ear file from your administrative server to the WebSphere server. If both are installed to the same server, skip this step.
  4. Start an Administrative Command Prompt or PowerShell session in (default location for Deployment Manager) at C:\IBM\WebSphere\AppServer\profiles\ctgDmgr01\bin\
  5. Run ejbdeploy. This process takes time to complete.
ejbdeploy.bat <source ear file> <working directory> <output ear>

Example:

Windows command prompt:

C:\IBM\WebSphere\AppServer\profiles\ctgDmgr01\bin>ejbdeploy.bat C:\IBM\SMP\maximo\deployment\default\maximo.ear C:\IBM\WebSphere\AppServer\mxtemp C:\IBM\SMP\maximo\deployment\default\was maximo1.ear

PowerShell:

.\ejbdeploy.bat C:\IBM\SMP\maximo\deployment\default\maximo.ear C:\IBM\WebSphere\AppServer\mxtemp C:\IBM\SMP\maximo\deployment\default\was\maximo1.ear

Example output (PowerShell):

PS C:\IBM\WebSphere\AppServer\bin> .\ejbdeploy.bat C:\IBM\SMP\maximo\deployment\default\maximo.ear maximo\deployment\default\was\maximo1.ear Starting workbench. EJB Deploy configuration directory: c:\IBM\WebSphere\AppServer\deploytool\itp\configuration/ framework search path: c:\IBM\WebSphere\AppServer\deploytool\itp\plugins build:
RADWEJB95-I20150829_0214
Creating the project.
Deploying jar mboejb
Validating [*Information]
ImportedClasses/psdi/iface/jms/JMSContQueueProcessor.class(Method: ejbCreate(), Class: psdi.iface.jms.JMSContQueueProcessor): CHKJ2501I: This method must not throw application exceptions (EJB 2.0: 15.7.3, 18.1.1, 18.2.1, 18.3.2). [*Information]
ImportedClasses/psdi/iface/jms/JMSContQueueProcessor.class(Method: ejbCreate(), Class: psdi.iface.jms.JMSContQueueProcessor): CHKJ2501I: This method must not throw application exceptions (EJB 2.0: 15.7.3, 18.1.1, 18.2.1, 18.3.2). [*Information]
ImportedClasses/psdi/iface/jms/JMSContQueueProcessor.class(Method: ejbCreate(), Class: psdi.iface.jms.JMSContQueueProcessor): CHKJ2501I: This method must not throw application exceptions (EJB 2.0: 15.7.3, 18.1.1, 18.2.1, 18.3.2). [*Information]
ImportedClasses/psdi/iface/jms/JMSContQueueProcessor.class(Method: ejbCreate(), Class: psdi.iface.jms.JMSContQueueProcessor): CHKJ2501I: This method must not throw application exceptions (EJB 2.0: 15.7.3, 18.1.1, 18.2.1, 18.3.2).
Generating deployment code
Invoking RMIC.
okToInvokeInJVM true
Copying files
Copying files
Installing Utility Module facet...
okToInvokeInJVM trueall the ejb references.
okToInvokeInJVM trueall the ejb references.
Invoking 'Validation' on '/WsaEJBDeployUtility'.
Writing output file
Exporting archive 'maximo1.ear'.
Writing output file Shutting down workbench.
EJBDeploy complete. 0 Errors, 0 Warnings, 4 Informational Messages

After ejbdeploy completes, locate the new ear file (in this example, maximo1.ear).

  1. Using an extraction tool such as WinZip or 7-Zip, open maximo1.ear file.
  2. From that file, copy mboejb.jar to the administrative server. If both are installed to the same server, skip this step.
  3. Extract the contents of mboejb.jar into a new directory.
  4. Copy the contents of that folder into the location \maximo\applications\maximo\mboejb\ejbmodule, replacing existing files.
  5. In \IBM\SMP\maximo\deployment, run buildmaximoearwas8. Building the maximo.ear takes longer than it did before.
  6. Log in to the WebSphere Integrated Solutions Console.
  7. On the left, expand Servers, then Server Types. Click WebSphere application servers.
  8. On the right, if MXServer is not stopped, stop it.
  9. On the left, expand Applications, then Application Types. Click WebSphere enterprise applications.
  10. On the right, tick the check box next to MAXIMO. Click Uninstall on the top bar.
  11. When prompted, save to the Master Configuration.
  12. On the top bar, click Install...
  13. Select maximo.ear from (default) the \maximo\deployment\default directory. Click Next. On the next screen (Preparing for the application installation), click Next.
  14. On the next screen (Select installation options), confirm that Deploy enterprise beans is cleared. Click Next.
Unchecked Deploy Enterprise Beans
  1. Map modules and virtual hosts for web modules as usual.
  2. On the Summary screen, click Finish.
  3. When completed, click Save to the master configuration.
  4. Start the Maximo application server.

Once completed, if no changes are made to the Maximo code, but you need to rebuild and redeploy maximo.ear, you need only to do start at step 5.


    [{"Line of Business":{"code":"LOB59","label":"Sustainability Software"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSLKT6","label":"IBM Maximo Asset Management"},"ARM Category":[{"code":"a8m50000000CbKNAA0","label":"Install"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.6.1"},{"Line of Business":{"code":"LOB59","label":"Sustainability Software"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSG2D3","label":"Maximo Spatial Asset Management"},"ARM Category":[{"code":"a8m50000000CbPaAAK","label":"Industry Solutions-\u003EMaximo for Spatial Asset Management"},{"code":"a8m50000000CbIbAAK","label":"Install-\u003EMaximo Spatial Asset Manager"}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.6.1"}]

    UID

    ibm11111611