Rediger

Quickstart: Deploy JBoss EAP Server on an Azure virtual machine using the Azure portal

  • Artikel

This article shows you how to quickly deploy JBoss EAP Server on an Azure virtual machine (VM) using the Azure portal.

Prerequisites

  • If you don't have an Azure subscription, create an Azure free account before you begin.
  • Ensure the Azure identity you use to sign in has either the Contributor role or the Owner role in the current subscription. For an overview of Azure roles, see What is Azure role-based access control (Azure RBAC)?
  • Ensure you have the necessary Red Hat licenses. You need to have a Red Hat Account with Red Hat Subscription Management (RHSM) entitlement for JBoss EAP. This entitlement lets the Azure portal install the Red Hat tested and certified JBoss EAP version.

    Note

    If you don't have an EAP entitlement, you can sign up for a free developer subscription through the Red Hat Developer Subscription for Individuals. Write down the account details, which you use as the RHSM username and RHSM password in the next section.

  • After you're registered, you can find the necessary credentials (Pool IDs) by using the following steps. You also use the Pool IDs as the RHSM Pool ID with EAP entitlement later in this article.

    1. Sign in to your Red Hat account.

    2. The first time you sign in, you're asked to complete your profile. Make sure you select Personal for Account Type, as shown in the following screenshot.

      Screenshot of selecting 'Personal' for the 'Account Type'.

    3. In the tab where you're signed in, open Red Hat Developer Subscription for Individuals. This link takes you to all of the subscriptions in your account for the appropriate SKU.

    4. Select the first subscription from the All purchased Subscriptions table.

    5. Copy and write down the value following Master Pools from Pool IDs.

Note

The Azure Marketplace offer you're going to use in this article includes support for Red Hat Satellite for license management. Using Red Hat Satellite is beyond the scope of this quick start. For an overview on Red Hat Satellite, see Red Hat Satellite. To learn more about moving your Red Hat JBoss EAP and Red Hat Enterprise Linux subscriptions to Azure, see Red Hat Cloud Access program.

Deploy JBoss EAP Server on Azure VM

The steps in this section direct you to deploy JBoss EAP Server on Azure VMs.

Screenshot of Azure portal showing JBoss EAP Server on Azure VM.

The following steps show you how to find the JBoss EAP Server on Azure VM offer and fill out the Basics pane.

  1. In the search bar at the top of the Azure portal, enter JBoss EAP. In the search results, in the Marketplace section, select JBoss EAP standalone on RHEL VM.

    Screenshot of Azure portal showing JBoss EAP Server on Azure VM in search results.

    In the drop-down menu, ensure PAYG is selected.

    Alternatively, you can also go directly to the JBoss EAP standalone on RHEL VM offer. In this case, the correct plan is already selected for you.

    In either case, this offer deploys JBoss EAP by providing your Red Hat subscription at deployment time, and runs it on Red Hat Enterprise Linux using a pay-as-you-go payment configuration for the base VM.

  2. On the offer page, select Create.

  3. On the Basics pane, ensure the value shown in the Subscription field is the same one that has the roles listed in the prerequisites section.

  4. You must deploy the offer in an empty resource group. In the Resource group field, select Create new and fill in a value for the resource group. Because resource groups must be unique within a subscription, pick a unique name. An easy way to have unique names is to use a combination of your initials, today's date, and some identifier. For example, ejb0823jbosseapvm.

  5. Under Instance details, select the region for the deployment.

  6. Leave the default VM size for Virtual machine size.

  7. Leave the default option OpenJDK 17 for JDK version.

  8. Leave the default value jbossuser for Username.

  9. Leave the default option Password for Authentication type.

  10. Fill in password for Password. Use the same value for Confirm password.

  11. Under Optional Basic Configuration, leave the default option Yes for Accept defaults for optional configuration.

  12. Scroll to the bottom of the Basics pane and notice the helpful links for Report issues, get help, and share feedback.

  13. Select Next: JBoss EAP Settings.

The following steps show you how to fill out JBoss EAP Settings pane and start the deployment.

  1. Leave the default value jbossadmin for JBoss EAP Admin username.
  2. Fill in JBoss EAP password for JBoss EAP password. Use the same value for Confirm password. Write down the value for later use.
  3. Leave the default option No for Connect to an existing Red Hat Satellite Server?.
  4. Fill in your RHSM username for RHSM username. The value is the same one that has been prepared in the prerequisites section.
  5. Fill in your RHSM password for RHSM password. Use the same value for Confirm password. The value is the same one that has been prepared in the prerequisites section.
  6. Fill in your RHSM pool ID for RHSM Pool ID with EAP entitlement. The value is the same one that has been prepared in the prerequisites section.
  7. Select Next: Networking.
  8. Select Next: Database.
  9. Select Review + create. Ensure the green Validation Passed message appears at the top. If the message doesn't appear, fix any validation problems, then select Review + create again.
  10. Select Create.
  11. Track the progress of the deployment on the Deployment is in progress page.

Depending on network conditions and other activity in your selected region, the deployment may take up to 6 minutes to complete. After that, you should see text Your deployment is complete displayed on the deployment page.

Optional: Verify the functionality of the deployment

By default, the JBoss EAP Server is deployed on an Azure VM in a dedicated virtual network without public access. If you want to verify the functionality of the deployment by viewing the Red Hat JBoss Enterprise Application Platform management console, use the following steps to assign the VM a public IP address for access.

  1. On the deployment page, select Deployment details to expand the list of Azure resource deployed. Select network security group jbosseap-nsg to open its details page.

  2. Under Settings, select Inbound security rules. Select + Add to open Add inbound security rule panel for adding a new inbound security rule.

  3. Fill in 9990 for Destination port ranges. Fill in Port_jbosseap for Name. Select Add. Wait until the security rule created.

  4. Select X icon to close the network security group jbosseap-nsg details page. You're switched back to the deployment page.

  5. Select the resource ending with -nic (with type Microsoft.Network/networkInterfaces) to open its details page.

  6. Under Settings, select IP configurations. Select ipconfig1 from the list of IP configurations to open its configuration details panel.

  7. Under Public IP address, select Associate. Select Create new to open the Add a public IP address popup. Fill in jbosseapvm-ip for Name. Select Static for Assignment. Select OK.

  8. Select Save. Wait until the public IP address created and the update completes. Select the X icon to close the IP configuration page.

  9. Copy the value of the public IP address from the Public IP address column for ipconfig1. For example, 20.232.155.59.

    Screenshot of public IP address assigned to the network interface.

  10. Paste the public IP address in an Internet-connected web browser, append :9990, and press Enter. You should see the familiar Red Hat JBoss Enterprise Application Platform management console sign-in screen, as shown in the following screenshot.

    Screenshot of JBoss EAP management console sign-in screen.

  11. Fill in the value of JBoss EAP Admin username which is jbossadmin. Fill in the value of JBoss EAP password you specified before for Password. Select Sign in.

  12. You should see the familiar Red Hat JBoss Enterprise Application Platform management console welcome page as shown in the following screenshot.

    Screenshot of JBoss EAP management console welcome page.

Note

You can also follow the guide Connect to environments privately using Azure Bastion host and jumpboxes and visit the Red Hat JBoss Enterprise Application Platform management console with the URL http://<private-ip-address-of-vm>:9990.

Clean up resources

To avoid Azure charges, you should clean up unnecessary resources. When you no longer need the JBoss EAP Server deployed on Azure VM, unregister the JBoss EAP server and remove Azure resources.

Run the following command to unregister the JBoss EAP server and VM from Red Hat subscription management.

az vm run-command invoke\
    --resource-group <resource-group-name> \
    --name <vm-name> \
    --command-id RunShellScript \
    --scripts "sudo subscription-manager unregister"

Run the following command to remove the resource group, VM, network interface, virtual network, and all related resources.

az group delete --name <resource-group-name> --yes --no-wait

Next steps

Learn more about migrating JBoss EAP applications to JBoss EAP on Azure VMs by following these links:

Migrate JBoss EAP applications to JBoss EAP on Azure VMs