--- schema_version: "1" id: 5c8b6f72b7294e883a98b3245c2a888d0531dc62365c05389476da75eb3f3761 title: Managing Servers collection: mulesoft version: current locale: en-us portal_url: https://docs.salesforce.com/mulesoft/current/en-us/hybrid-standalone/managing-servers.md canonical_url: https://docs.mulesoft.com/hybrid-standalone/managing-servers source_site: docs.mulesoft.com content_type: documentation content_hash: 33756cb9e133a799d33abd288f70c83ee4fec58e158d084b6b291daa6747a3f2 description: MuleSoft Documentation Site latest: true --- --- product: Hybrid Standalone Runtimes --- # Managing Servers > For the full documentation index, see: https://docs.mulesoft.com/llms.txt Manage individual servers in your hybrid standalone environment through Runtime Manager’s centralized administration interface. Server management includes accessing configuration settings, controlling server lifecycle operations, managing custom and discovered properties, and maintaining security certificates to ensure optimal performance and secure communication. ## Access Server Settings The server **Settings** page provides centralized access to all configuration and management options for your hybrid standalone servers. From this page, you can configure custom properties, monitor server health, manage certificates, and perform essential server operations like restart, shutdown, or deletion. To access the **Settings** page: 1. From Anypoint Platform, select **Runtime Manager**. 2. Click **Servers**. 3. Either: - Click the **Type** column to display the details pane and click **Manage Server**, **Manage Group**, or **Manage Cluster**: ![Manage Server button](/mulesoft/current/en-us/hybrid-standalone/_images/rtm-view-server-settings.png) Figure 1. The arrow shows the **Manage Server** button in the details pane. - Click the name of the server, server group, or cluster on the **Servers** page and then click **Settings**: ![Settings page](/mulesoft/current/en-us/hybrid-standalone/_images/rtm-server-settings-page.png) Figure 2. The arrow shows the option to navigate to the **Settings** page. ## View Server Information Runtime Manager provides multiple views to monitor and manage your hybrid standalone servers. Access server information through the servers list, details pane, or comprehensive dashboard views. ### Access the Servers List View all servers, server groups, clusters, and API gateways in your environment: 1. From Anypoint Platform, select **Runtime Manager**. 2. Click the **Servers** tab. The servers list displays key information for each component: **Name** The name of the server, API gateway, server group, or cluster. **Status** Current operational status (Running, Disconnected, Created, etc.). **Type** Component type: Mule server, API gateway, server group, or cluster. **Version** Mule runtime engine or API gateway version number. ### View the Details Pane Access detailed information and quick actions for a specific server: 1. From the **Servers** list, click the **Type** column for the server you want to view. 2. The details pane displays on the right side of the screen. The details pane provides: **Overview Information** - Current status indicator - Mule runtime engine or API gateway version - Runtime Manager agent version - For clusters: cluster type (unicast or multicast) **Quick Actions** - **Manage Server**, **Manage Group**, or **Manage Cluster** button to access the Settings page - **View Dashboard** button to open the server dashboard To view the dashboard for a server in a server group or cluster, click the server name in the details pane. **Tabbed Details** Access additional information through the tabs at the bottom of the details pane: - **Servers** tab (for groups and clusters): Lists all member servers and their current statuses. - **Applications** tab: Shows all deployed applications and their operational status. - **Plugins** tab: Displays configured integrations such as Splunk and ELK. ![Applications tab, servers list, and Plugins tab](/mulesoft/current/en-us/hybrid-standalone/_images/rtm-cluster-details-pane.png) Figure 3. The screen shows the **Applications** tab, servers list, and **Plugins** tab. ### View the Server Dashboard Access comprehensive performance metrics and application information through the server dashboard: 1. From the **Servers** list, click the server name. 2. The dashboard displays detailed real-time metrics. **Performance Metrics** The dashboard provides visual graphs for: - **Heap Memory**: JVM memory usage over time - **CPU**: Processor utilization and performance trends ![Heap Memory graph, applications list, and CPU graph](/mulesoft/current/en-us/hybrid-standalone/_images/rtm-server-dashboards-page.png) Figure 4. The screen shows the **Heap Memory** graph, applications list, and **CPU** graph. **Application Information** The dashboard displays for each deployed application: - Application name and deployment status - Mule messages processed - Error messages and exceptions - Resource utilization details ## Shut Down, Restart, or Delete Servers In Runtime Manager, you can shut down, restart, or delete a server. After shutting down a server, you can’t start it from Runtime Manager. You must manually start the server on the system where Mule runtime engine is installed. If an error occurs in Runtime Manager during server shutdown or restart, manually start or stop the server on the system where Mule is installed. To shut down, restart, or delete a server: 1. From Anypoint Platform, select **Runtime Manager**. 2. Select **Servers**. 3. Click the server name. 4. Click **Settings**: ![\*Actions\* menu](/mulesoft/current/en-us/hybrid-standalone/_images/rtm-servers-actions-menu.png) Figure 5. The arrow shows the **Actions** menu on the **Settings** page. 5. From the **Actions** menu, select: - **Delete** - **Restart** - **Shutdown** - **Renew Certificate** 6. In the confirmation window, select the checkbox to confirm your choice. ## Configure Server Properties Runtime Manager enables you to view, create, and manage server properties for your hybrid standalone instances. Server properties are configuration values that control JVM behavior and application settings across your Mule runtime environments. ### Property Types - Custom Properties - Custom properties are user-defined key-value pairs that configure JVM container settings for Mule instances. For example, you can set `ENV=qa` to specify the server environment or `MAX_HEAP=2g` for memory allocation. - Custom properties are stored in the `$MULE_HOME/conf/wrapper.conf` file on the system where Mule is installed. - Application Properties - Application properties defined in Runtime Manager override application properties in `mule-app.properties` - Application properties defined in the `mule-app.properties` file override server properties specified in Runtime Manager - Discovered Properties Discovered properties are automatically detected configuration values from the remote Mule environment, including: - JVM arguments - Environment properties - System properties Runtime Manager retrieves these values through the Runtime Manager agent, which queries the `System` Java class on the remote server. By default, auto-discovery is disabled for security reasons. When enabled, Runtime Manager stores an encrypted version of these properties in its internal database. To fully disable this feature, contact your MuleSoft customer success representative. ### View and Manage Properties To view server properties: 1. From Anypoint Platform, select **Runtime Manager**. 2. Click **Servers**. 3. Click the **Type** column to display the details pane. 4. Click **Manage Server**, **Manage Group**, or **Manage Cluster**. 5. On the **Settings** page, click **Properties**: ![Properties tab](/mulesoft/current/en-us/hybrid-standalone/_images/rtm-server-properties-tab.png) Figure 6. The arrow shows the **Properties** tab on the **Settings** page. From the **Properties** tab, you can: - Search for existing properties - View custom and discovered properties - Create new custom properties - Edit existing properties ### View Discovered Properties To view discovered properties, select **Discovered Properties** and then click **Enable Auto-Discovery**: ![Discovered Properties and Enable Auto-Discovery buttons](/mulesoft/current/en-us/hybrid-standalone/_images/rtm-server-enable-autodiscovery.png) Figure 7. The screen shows the **Discovered Properties** and **Enable Auto-Discovery** buttons on the **Properties** tab. The server must be running to auto-discover server properties. ### Create Custom Properties To create new custom properties: 1. From Anypoint Platform, select **Runtime Manager**. 2. Click **Servers**. 3. Click the **Type** column to display the details pane. 4. Click **Manage Server**, **Manage Group**, or **Manage Cluster**. 5. On the **Settings** page, click **Properties**. 6. Click **Custom Properties**. 7. Enter the property name in the **Key** field. 8. Enter the property value in the **Value** field. 9. Click **Save**. After creating a custom property, restart the server to apply the new property to the Mule configuration. ## Renew Server Certificates Registering a Mule server in Anypoint Runtime Manager requires a valid certificate provisioned and signed by Runtime Manager. The certificate ensures secure communication between Runtime Manager and the Runtime Manager agent. When a server certificate expires, Runtime Manager displays `Disconnected` in the **Status** column for the server on the **Servers** page. The `mule_agent.log` file displays a message like this: com.mulesoft.agent.transport.WSConnection: Failed attempt to connect nro. 1 to the web socket client at runtime-manager.anypoint.mulesoft.com: Connection refused. For applications deployed to the server, Runtime Manager displays `Unknown` in the **Status** column on the **Applications** page. ### View a Certificate Expiration Date To view the expiration date for a server: 1. From Anypoint Platform, select **Runtime Manager**. 2. Click **Servers**. 3. Click the server name. For servers in a server group or cluster, click the server group or cluster name and then click the server name. The certificate expiration date appears on the server dashboard: ![Certificate expiration date on the Dashboard page](/mulesoft/current/en-us/hybrid-standalone/_images/rtm-server-certificate.png) Figure 8. The arrow shows the **Certificate expiration date** on the **Dashboard** page. ### Renew a Certificate from Runtime Manager Before a certificate expires, you can renew it directly from Runtime Manager. You can renew a certificate for a specific server or multiple servers within a cluster or group. The status for the server must be `Running` to update its certificate. To renew a certificate for a standalone server: 1. From Anypoint Platform, select **Runtime Manager**. 2. Click **Servers**. 3. Verify that the server status is `Running`. 4. Click the server name. ![Select Server](/mulesoft/current/en-us/hybrid-standalone/_images/rtm-server-standalone-name.png) 5. Click **Settings**. 6. From the **Actions** menu, select **Renew Certificate**. ![Settings Tab](/mulesoft/current/en-us/hybrid-standalone/_images/rtm-server-standalone-settings.png) 7. Select the checkbox to confirm your choice, and then click **Renew**. ![Confirm Renewal](/mulesoft/current/en-us/hybrid-standalone/_images/rtm-server-standalone-renew.png) 8. Check **Certificate expiration date** to verify that the certificate is renewed successfully, and restart Mule runtime to start using the new certificates. To renew a certificate for servers in a cluster or group: 1. From Anypoint Platform, select **Runtime Manager**. 2. Click **Servers**. 3. Verify that the server status is `Running`. 4. Click the group or cluster name. ![Select Group or Cluster](/mulesoft/current/en-us/hybrid-standalone/_images/rtm-server-certificate-group-name.png) 5. Check the radio button to select the server or servers you want to update. 6. From the **Actions** menu, select **Renew Certificate**. ![Select Server](/mulesoft/current/en-us/hybrid-standalone/_images/rtm-server-certificate-group-select-server.png) 7. Select the checkbox to confirm your choice, and then click **Renew**. ![Confirm Renewal](/mulesoft/current/en-us/hybrid-standalone/_images/rtm-server-certificate-group-renew.png) 8. Check **Certificate expiration date** to verify that the certificate renewed successfully. If the **Renew Certificate** option in the **Actions** pull-down menu isn’t available after performing the previous steps, [update your **Agent** version](https://docs.mulesoft.com/runtime-manager/installing-and-configuring-runtime-manager-agent#update-the-agent.adoc). The **Server certificate renewal** feature, which enables you to renew server certificates directly from Runtime Manager, was introduced by Runtime Manager 2.8.4. This feature requires Runtime Manager Agent 1.10.0 or later. Hover over the **Renew Certificate** option in the **Actions** pull-down menu, and a tooltip in the UI indicates you the minimum required Runtime Agent version. > [!NOTE] Renewing server certificates requires a manual runtime restart to start using the new > certificates. If renewing the unexpired certificate via Runtime Manager fails, follow the steps in [Renew a Certificate via the Command Line](#renew-a-certificate-via-the-command-line). ### Renew a Certificate via the Command Line Use this method to renew a certificate even after it has expired. The agent connects with Runtime Manager using mutual SSL authentication and stores the key pair in the `$MULE_HOME/conf/mule-agent.jks` file. The key pair is valid for two years, after which the certificate expires and the connection with Runtime Manager terminates. > [!NOTE] Make sure you disable MFA before implementing these steps. To renew the agent key pair: 1. Download the appropriate `agent-certificate-renewer-{version}.jar` file for your Mule version from [Applications and Servers showing as Unknown and Disconnected state in Anypoint Runtime Manager due to expired key pair](https://help.salesforce.com/s/articleView?id=001118268&type=1). 2. Move the JAR file to `$MULE_HOME/bin` and make sure that you have execute permission. For example, on Linux, enter `chmod +xx agent-certificate-renewer-{version}.jar`. 3. Stop Mule. 4. Create a backup copy of the `$MULE_HOME/conf` directory. 5. From `$MULE_HOME/bin`, run one of these commands, depending on how you authenticate with Anypoint Platform: - Nonfederated Use your Anypoint Platform credentials on the command line: `java -jar ./agent-certificate-renewer-{version}.jar -u -p ` - External identity Copy the registration token for the server from the **Runtime Manager > Servers > Add Server** popup screen and include it on the command line: ![Add Registration Token](/mulesoft/current/en-us/hybrid-standalone/_images/rtm-server-certificate-external-identity.png) And execute this command: `java -jar ./agent-certificate-renewer-{version}.jar -H ` - Proxy connection Use your Anypoint Platform and proxy server credentials on the command line: `java -jar agent-certificate-renewer-{version}.jar -u -p -P ` - US MuleSoft Government Cloud Control Plane Use this -r flag: `java -jar ./agent-certificate-renewer-{version}.jar -H -r us_gov` - EU Control Plane Use this -r flag: `java -jar ./agent-certificate-renewer-{version}.jar -u -p -r eu1` The command displays these messages: INFO: Connecting to Core Services to extract authentication token. INFO: Connecting to Runtime Manager to request a new certificate. INFO: Backing up current agent keystore. INFO: Generating and saving new keystore. ## See Also - [Creating Servers](https://docs.mulesoft.com/hybrid-standalone/creating-servers) - [Managing Server Groups](https://docs.mulesoft.com/hybrid-standalone/managing-servers-groups) - [Managing Clusters](https://docs.mulesoft.com/hybrid-standalone/managing-clusters) - [Monitoring Hybrid Standalone Instances](https://docs.mulesoft.com/hybrid-standalone/monitoring-hybrid-standalone)