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.
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.- 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.
- 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.
- 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
- Hover the mouse on the Web Applications button, and click Discover from Server as shown below.
Enter the required details as shown below.
The parameters of the above screen are described below.Parameter Description 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.
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.
Click Create Proxy App to trigger an application import procedure. Upon successful creation of the application you view a pop-up notification as follows.
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.