Changing the Endpoint of a Deployed Proxy Service
- Former user (Deleted)
The below sections describe how you can change the endpoint reference of a deployed proxy service without changing its own configuration. For example, in this scenario, you have two endpoints to manage two environments (i.e., Dev and QA). The endpoint URLs for the services hosted in the Dev and QA environments respectively are as follows:
- Dev environment: http://localhost:8280/services/echo
- QA environment: http://localhost:8281/services/echo
See the topics given below for instructions.
Creating the endpoint reference projects
Follow the steps below to create two ESB Config Projects containing the two endpoint values for the Dev and QA environments.
Open WSO2 Integration Studio and click Miscelleneous → Create New Config Project in the Getting Started tab.
In the New ESB Project dialog that opens, select New ESB Config Project and click Next.
Enter HelloWorldDevResources as the project name and click Finish.
- Right-click the HelloWorldResources project in the Project Explorer and go toNew -> Endpoint.
Select Create a New Endpoint and click Next.
Fill in the information as in the table below and click Finish.
Field Value Endpoint Name HelloWorldEP Endpoint Type Address Endpoint Address http://localhost:8280/services/echo - Similarly, to create resources for the QA environment, create another ESB Config project named HelloWorldQAResources and create an endpoint named HelloWorldEP. Provide the following endpoint address:
http://localhost:8280/services/echo
Creating the proxy service
In this section, you will create an ESB Solutions Project containing the Proxy Service configuration.
Open WSO2 Integration Studio and click ESB Project → Create New in the Getting Started tab as shown below.
In the New ESB Solution Project dialog that opens, enter HelloWorldServices as the project name and click Finish.
Right-click the HelloWorldServices project in the Project Explorer and go to New -> Proxy Service.
In the New Proxy Service dialog that opens, select Create a New Proxy Service and click Next. Fill in the details as specified in the table below:
Field Value Proxy Service Name HelloWorldProxy Proxy Service Type Select Pass Through Proxy Endpoint Select HelloWorldEP (You need to select Predefined Endpoint from the endpoint options listed.)
The projects setup is now complete. You now need to create CApp projects for each of the Composite Applications you want to generate. The ESB proxy service and the Dev endpoint must go in its own CApp, and you create a separate CApp for the ESB proxy service and the QA endpoint.
Creating the composite application project
- Right-click the Project Exporer and go to File -> New -> Composite Application Project.
- Name the project HelloWorldDevCApp.
- Select the HelloWorldServices and HelloWorldDevResources projects from the list of dependancies, and click Finish.
- Similarly, create HelloWorldQACApp containing the projects HelloWorldServices and HelloWorldQAResources.
Your CApp projects are now ready to be deployed to your ESB servers.
Deploying the Dev composite application
See Running the ESB profile via WSO2 Integration Studio for instructions on deploying the applications and starting the server.
Testing the Dev environment
- Log in to the management console using admin as the username and password.
- Click Services > List, and click on the Try This Service link for the HelloWorldProxy, which you just deployed using the CApp.
Use the following request to invoke the service:
<body> <p:echoInt xmlns:p="http://echo.services.core.carbon.wso2.org"> <!--0 to 1 occurrence--> <in>50</in> </p:echoInt> </body>
Click Send. You view the response from the HelloWorldProxy hosted in WSO2 EI as seen in the image below.
Changing the endpoint reference
Follow the steps below to change the endpoint reference of the HelloWorldProxy you deployed, to point it to the QA environment, without changing its configuration.
Set a port offset by changing the following configuration in the
<EI_HOME>/conf/carbon.xmlfile.<Ports> <Offset>1</Offset> ........ </Ports>- Undeploy the HelloWorldDevCApp, deploy the HelloWorldQACApp and re-start the ESB Profile of WSO2 EI. For instructions, see Running the ESB profile via WSO2 Integration Studio.
Testing the QA environment
- Log in to the Management Console using admin as the username and password.
Click Services > List, and click on the Try This Service link for the HelloWorldProxy, which you just deployed using the CApp.
If you click on the HelloWorldProxy in the Deployed Services list, you view that the port offset has been applied and the endpoint URL has been changed to point to the QA environment.
Use the following request to invoke the service:
<body> <p:echoInt xmlns:p="http://echo.services.core.carbon.wso2.org"> <!--0 to 1 occurrence--> <in>100</in> </p:echoInt> </body>
Click Send. You view the response from the HelloWorldProxy hosted in WSO2 EI as seen in the image below.
