||
Skip to end of metadata
Go to start of metadata

The application discovery feature enables you to discover (retrieve the list of applications) from an application server, and import them as proxy applications in a few steps. All the necessary default settings are pre-populated by the discovery system so that you do not need to manually enter the information.

WSO2 AppM 1.0.0 release only supports discovering Web applications from WSO2 Application server, and is fully tested with WSO2 AS 5.2.1.

Configuring WSO2 Application Server permissions

Follow the steps below to provide a set of minimal permissions to query WSO2 AS and retrieve the applications hosted in it.

  1. Download WSO2 AS, and start the server. For instructions on starting WSO2 AS server, see Getting Started.

    Change the value of the <Offset> element in the <AS_HOME>/repository/conf/carbon.xml file, to set a port offset to the default WSO2 AS port. This prevents port conflicts that occur when you start more than one WSO2 products on the same server. 

  2. Create a user role in WSO2 AS with the following permissions as follows. For instructions on creating a user role in WSO2 AS, see Configuring Users and Roles.
    set permissions to the user role in WSO2 AS
  3. Create a user by assigning the role created in the above step.

Discovering Web applications

Follow the steps below to discover applications hosted in WSO2 AS from WSO2 AppM.

  1. Log in to the App Publisher of WSO2 AppM as a user with the internal/publisher role using the following URL: https://<AppM_HOST>:<AppM_PORT>/publisher
  2. Hover the mouse on the Web Applications button, and click Discover from Server as shown below. 
    discover from server option in the App Publisher
  3. Enter the required details as shown below. 
    required details for Web app discoveryThe parameters of the above screen are described below.

    ParameterDescription
    Application Server URL

    The URL of WSO2 AS (i.e. https://<AS_HOST>:<AS_PORT>/services/).

    User Name

    Username of the user with permission to list the applications in WSO2 AS. For information on setting the permissions, see Configuring WSO2 Application Server permissions. 

    Password Password of the user with permission to list the applications in WSO2 AS. For information on setting the permissions, see   Configuring WSO2 Application Server permissions .  
    Context (Starts With)

    Context of the remote application. You can enter any part of the context, or keep the field empty to search all contexts. (This is optional.)

    Status Status of the application. (This is optional.) Following are the available options.
    • ALL: All applications in the NEW or CREATED status.
    • NEW: The proxy is not created for the application for the current user.
    • CREATED: The proxy is created for the application for the current user.
  4. If the given details are correct, the available applications will be listed as shown below. You can change the created context path if required by changing the value in the Proxy Context column.

    list of Web apps hosted in WSO2 AS 

  5. Click Create Proxy App to trigger an application import procedure. Upon successful creation of the application you view a pop-up notification as follows.

    notification message on successful creation of the app

  6. Hover the mouse on the Web Applications button, and click All Web Applications. You view the created application in the Web Applications list. Now, authorized users can review, approve, and publish the Web application. 

  • No labels