Modifying WebSphere Server Configuration

  • Last update:April 27, 2026
  • Overview

    Version

    WebSphere Server Version

    WebSphere 8.5

    Application Scenario

    1. For convenience, you want to change the server port instead of using the default port.

    2. When running, a Java application consumes the memory of the web application server. If the server runs out of memory, Out of Memory (OOM) errors may occur. To address this, you need to adjust the server's memory settings.

    3. After the application file is changed, you need to update the FanRuan application deployed on the WebSphere server.

    Function Description

    This document describes how to modify the port number, memory settings, and other JVM configurations for the WebSphere server, and how to restart the FanRuan application deployed on WebSphere.

    Modifying the Port Number

    1. Log in to the WebSphere administration console as the admin.

    2. On the navigation panel, choose Servers > Server Types > WebSphere Application Server.

    3. Click the application server to be modified, and choose Communications > Ports.

    2-1.png

    4. Click WC_defaulthost, and modify the value of Port to change the project port.

    5. Click Apply to save the change.

    6. Restart the WebSphere server for the change to take effect.

    2-2.png

    Modifying Memory Settings and JVM Parameters

    1. Log in to the WebSphere administration console as the admin.

    2. On the navigation panel, choose Servers > Server Types > WebSphere Application Server.

    3. Click the application server to be modified, and choose Server Infrastructure > Java and Process Management > Process definition.

    3-1.png

    4. Click Java Virtual Machine, and modify the initial heap size and maximum heap size.

    5. You can add and modify JVM parameters in Generic JVM arguments.

    -Xss1024k

    -Xgc:parallel

    -XX:MaxPermSize=4096m

    -XX:MaxDirectMemorySize=2048m

    5. Click Apply to save the server configuration changes.

    7. Restart the WebSphere server for the change to take effect.

    3-2.png

    Updating the Application File

    This section describes how to update the FanRuan application deployed on the WebSphere server after the application file is changed.

    Example scenario: manually updating the JAR package for a minor version update.

    1. Locate the file under the deployment directory of the report application on the WebSphere server.

    For example, C:\Program Files (x86)\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\WIN-O9584D1PVIINode01Cell\webroot_war.ear\webroot.war

    2. Replace the JAR file in the path webroot.war\WEB-INF\lib with the new one.

    3. If you access the FanRuan application at this point, a 404 error will be returned. You need to restart the application for the new JAR file to take effect.

    4. Log in to the WebSphere administration console as the admin.

    5. On the navigation panel, choose Applications > Application Types > WebSphere enterprise applications.

    6. Tick the resource to be updated, click Stop, and then click Start. The report application will be successfully updated in this way.

    7. When you access the FanRuan application again, the new JAR file has already taken effect.

    4.png

    Attachment List


    Theme: Deployment and Integration
    • Helpful
    • Not helpful
    • Only read

    滑鼠選中內容,快速回饋問題

    滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

    不再提示

    10s後關閉

    Get
    Help
    Online Support
    Professional technical support is provided to quickly help you solve problems.
    Online support is available from 9:00-12:00 and 13:30-17:30 on weekdays.
    Page Feedback
    You can provide suggestions and feedback for the current web page.
    Pre-Sales Consultation
    Business Consultation
    Business: international@fanruan.com
    Support: support@fanruan.com
    Page Feedback
    *Problem Type
    Cannot be empty
    Problem Description
    0/1000
    Cannot be empty

    Submitted successfully

    Network busy