webMethods Upgrade Easy Guide

Step-by-Step Guide to Installing and Upgrading webMethods

Welcome to our comprehensive guide on installing and upgrading webMethods Integration Server Instances. Whether you're a seasoned professional or new to webMethods, this step-by-step guide will provide all the necessary information to ensure a smooth transition and optimal performance.

---

Installation Steps

1. Install the Products with the Created Image.zip

• Ensure the Software AG Platform Manager (SPM) is down on the newly installed server.
• Run the command: sh SoftwareAGInstaller2025-Linux_x86_64.bin.
• Follow the prompts to use and validate the installation image.

2. Create IS Instances as Required

• The default instance is created during the initial installation.
• To create additional instances with required configurations, use:

sh is_instance.sh create -Dinstance.name=ISName -Dprimary.port=<<portNo>>

 -Ddiagnostic.port=<<DPortNo>> -Dsecure.port=<<SPortNo>>

 -Djmx.port=<<JPortNo>> -Dlicense.file=<<License File Location>>

 -Ddb.alias=<<DBAliasName>> -Ddb.type=<<DBType>> -Ddb.username=<<DBUserName>>

 -Ddb.password=<<DBPassword>> -Ddb.url=<<DB URL>>

3. Update JMX Port for Default Instance

• Navigate to the configuration directory and update the necessary properties.

4. Update Packages

• Ensure all Integration Server instances are updated to match the default instance:

sh is_instance.sh update -Dinstance.name=<<ISServerName>> -Dpackage.list=CSV List of Packages

5. Update Manager Installation (Fix Installation)

• Create the directory SUM and run the update manager installer.
• Shut down all servers before running the update manager.

6. Command Central Installation

• Create the Command Central directory and run the installer script.
• Follow the prompts to complete the installation.

---

Upgrade Steps

1. Run Database Configurator

• Migrate the product with new DB URL, schema, data, index, and port.

2. Migrate Universal Messaging

• Use the migration utility to migrate the Universal Messaging instance.

3. Migrate Integration Server Instances (Default)

• Use the migration script and update schema details for IS migrations.

4. Migrate My webMethods Server (MWS)

• Use the migration script and update schema details for MWS migrations.

5. Update tc-config Files

• Copy and update the tc-config files from the old to the new location.

6. Point Terracotta License File Location

• Update the license file path in the server configuration.

7. Verify Jar Files

• Ensure that all necessary jar files are present and updated.

8. Update .jks and cacerts Files

• Use Key Store Explorer to update certificates and place them in the correct directories.

9. Bring Up Servers

• Start the SPM, Universal Messaging, MWS, and IS instances one by one.
• Verify logs to ensure everything runs smoothly.

10. Sync Document Types from Designer

• Synchronize all out-of-sync document types.

11. Update JDBC webMethods Adapter Connections

• Update the adapter connections with new schema details.

12. Code Deployment

• Follow the attached step-by-step plan for code deployment.

---

Performance Improvements

• Increase server thread count based on load.
• Set server logging level to error.

---

Database Cloning & Preparation

• Clone the existing Product DB.
• Use a new schema, tablespace, and index.
• Ensure the new schema user has admin access.
• Ensure the archive schema has full access to IS and BPM schema.

Download & Install Required Components

• Download and place all installables in the server directory:
  • Command Central Bootstrapper
  • Software AG Installer
  • Update Manager Installer
  • Required Images from Empower SDC
  • Developer Products (Designer, Enterprise Manager)
• Define temporary ports for installation.
• Install Command Central Server using the Bootstrapper file.
• Install:
  • Integration Server
  • Trading Networks
  • MWS
  • Universal Messaging
• Install the Update Manager and apply the latest fixes.

---

Migration & Verification

• Shut down old IS, UM, MWS, SPM, and CC instances.
• Migrate databases using DCC.
• Upgrade Universal Messaging and Integration Server instances.
• Start IS, MWS, and verify configurations.
• Set up and verify archive configurations for IS and BPM.
• Verify:
  • UM servers and correct ports.
  • IS-UM connectivity.
  • UM Messaging and JMS configurations.
  • Publish-Subscribe functionality.
  • JNDI Alias functionality.
  • JDBC pools pointing to the new DB.
  • Central User Management.
  • Process models and execution.
  • TN document types, partner profiles, processing rules.
  • Service auditing, resubmission, and transactions.
• Share updated UM client jar files and verify JMS connectivity.

---

By following these steps, you can successfully install and upgrade webMethods 10.7, ensuring optimal performance and functionality. Stay tuned for more updates and expert tips on managing your webMethods environment!