« Zurück zu Liferay IDE

Liferay IDE Remote Server Adapter

Requirements For Tutorial #

Introduction #

The Remote Server Adapter is a feature of Liferay IDE where you can deploy your Liferay projects to a remote Liferay Portal instead of using a locally launched and managed Portal server. The remote instance of Liferay Portal must have the Remote IDE Connector application installed from Liferay marketplace. This application installs the server-manager-web plugin for Liferay that provides an API for Liferay IDE's Remote Server Adapter to use for all its remote operations.

Configure the Remote Server Adapter #

You can configure both the remote server adapter and optionally installing the Remote IDE Connector into the remote Liferay Portal instance all through the Remote Server Wizard in Liferay IDE. Below are the steps to follow:

  1. Ensure that the remote Liferay Portal instance is running and you can login using OmniAdmin username/password
  2. In Eclipse with Liferay IDE plugins installed, go to new Server wizard File > New > Other > Server > Liferay > Remote Liferay Server
  3. Select Next
  4. The next page of remote server configuration remote server is to define the Liferay Portal Runtime Stub. This will allow projects created for this server to use this runtime stub for statisfying jar dependencies needed to compile various Liferay projects. Select bundle type based on your local Liferay Portal Tomcat bundle, then browse to the bundle installation directory.
  5. Select Next
  6. The next page is for configuring the connection to the remote Liferay Portal instance. Enter in the host, port and OmniAdmin username/password. The next two fields can be left as the defaults unless you have made changes to your remote Portal environment.
  7. In order for this connection to the remote Liferay Portal to work, the Remote IDE Connector application must be installed in the remote Portal. If you have not installed that application, you can click the link at the bottom of the page to jump to the marketplace control panel to install the Remote IDE connector.
  8. Click the Free button to purchase the Remote IDE Connector application and follow the onscreen prompts.
  9. Once it is purchase select the Purchased page in the control panel.
  10. Download and install the Remote IDE Connector, once it is installed return to Eclipse and the Remote Server config wizard
  11. Select Validate connection and no warnings or errors should be displayed if you have supplied the correct OmniAdmin username/password. 
  12. Select Finish
  13. Once you select Finish, the new Remote Server will be available in the Servers view and if the connection settings were correct, Eclipse will connect to the remote server. Then the remote liferay logs will be displayed in Eclipse's console. If your remote server is in debug mode, the Eclipse java debugger will be attached to the remote process automatically.
  14. If the settings are invalid and the connection can't be established, you can modify the Remote Server settings at any time by double-clicking the server instance in the Servers view and modify the settings in the configuration editor.

Using the Remote Server Adapter #

Once you have the Remote Server correctly configured and connected in Eclipse, you can begin using it as you would a local Liferay Portal Tomcat server, publishing projects to the server.

  1. Right-click the server and choose Add and Remove modules...
  2. Select Liferay projects you wish to publish to the remote server, select Finish
  3. The deployment process should start and after it is published to remote server you should see a message saying plugin is deployed
  4. After you have made the initial remote deployment, if you make any changes to your project, you will need to publish these changes (or have them published automatically in the settings). To invoke a publish operation (after having modified some project files) right click on the server in the Servers view and select Publish
  5. If you want to modify the publish operation behavior, you can do that in the server configuration editor (double-click server in Servers view)
    #If you receive errors, visit the Liferay IDE forums and post the warning/error to try to get help.

Untergeordnete Seiten

13 Anhänge
36551 Angesehen
Durchschnitt (0 Stimmen)
Die durchschnittliche Bewertung ist 0.0 von max. 5 Sternen.
Antworten im Thread Autor Datum
I've been unable to connect over SSL. Is this... Kirk Stork 5. April 2013 16:28
At the moment, we don't have SSL support. We... Gregory Amerson 7. April 2013 20:58
Hi Gregory, I just want to clarify... the... Qiqo J 11. Mai 2013 11:24
You are correct. The runtime stub is just to... Gregory Amerson 14. Mai 2013 00:14
I set this up on my local workstation to... Nathan Harrell 8. August 2013 12:45
Hey Nathan, Can you go ahead and post this... Gregory Amerson 19. August 2013 00:59
After switching workstation from Windows XP to... Nathan Harrell 28. August 2013 08:02
Hey Lee, Can you open a ticket with the steps... Gregory Amerson 25. Oktober 2013 01:59
Hi, I am new to Liferay and tried you're... Martin Dames 21. Oktober 2013 04:50
Hey Martin, Can you post the steps to... Gregory Amerson 25. Oktober 2013 02:00

I've been unable to connect over SSL. Is this not supported or is there some special configuration?
Gepostet am 05.04.13 16:28.
At the moment, we don't have SSL support. We will be adding this in the future. http://issues.liferay.com/browse/IDE-891
Gepostet am 07.04.13 20:58 als Antwort auf Kirk Stork.
Hi Gregory,

I just want to clarify... the window "Liferay lifetime stub" where you can only select Tomcat bundles, is just used to satisfy jar dependencies of projects and has nothing to do with the remote server management am I right?

I'm currently running Liferay in a pre-production Glassfish 3.1 enviroment that was installed by a war file and not from a glassfish bundle.

I hope you can clarify. thanks

I'm currently running Liferat 6.1 on glassfish (installed from war not a bundle)
Gepostet am 11.05.13 11:24.
You are correct. The runtime stub is just to satisfy jar dependencies of liferay projects and doesn't interact with remote server at all. Its just so classes like "MVCPortlet" will resolve for your projects that are deployed remotely.
Gepostet am 14.05.13 00:14 als Antwort auf Qiqo Javier.
I set this up on my local workstation to connect with our Production server on the network, which runs Tomcat 7 as an automatic Windows service, and I could never get a display of any information in the console of the workstation's LDS. Does this setup only pertain to launching the Tomcat server from LDS? The Production Tomcat server is configured to run on port 80 and the workstation Tomcat server still uses the default port 8080 configuration. Could that be causing a problem? Any further information about this would be very appreciated.


Gepostet am 08.08.13 12:45.
Hey Nathan,
Can you go ahead and post this issue on the Liferay IDE forums as well? We can try to follow up with you over there to try to solve your issues. Thanks

Gepostet am 19.08.13 00:59 als Antwort auf Nathan Harrell.
After switching workstation from Windows XP to Windows 7 I finally got a good connection and now I have console readout on my workstation. However, a couple of issues remain. 1) In order to connect to the remote server, I had to change the authentication of the Portal from screenname (our preferred authentication) to email address; then I could connect using the omniadmin login (test@liferay.com, test). At least I suppose that is the omniadmin login. Every time I switch back to screenname authentication, the local LDS shows the remote server is stopped. 2) I can only deploy a portlet via remote IDE connector once. After that I get "not updating xxx portlet because version 6.1.20.x is newer than 6.1.20. So I have to dump out a .WAR file on my local workstation, then copy and paste it into the deploy folder of the remote server. These issues could be due to an error in setup on my part or different Portal authentication preferences were not considered when creating the Remote IDE Connector plugin, and a patch needs to be issued to enable remote connection for all authentications available for a Liferay Portal. If anybody knows what I can do, I would certainly appreciate the input!

Gepostet am 28.08.13 08:02.

I am new to Liferay and tried you're suggestion with Glassfish 3.1.x (from the Liferaybundle). When I create a new project through Liferay IDE the only state in the server view for Remore Liferay Server is "Republish" and not synchronised. When I choose "Publish" from the context menu, as you described above, the ant script runs and it copies the my portlet war to liferay-plugins-sdk-6.1.1\dist folder. Should it instead copy this to the glassfish deploy folder? Glassfish will not generate some logs like "Portlet XY installed". It just sais nothing. Therefore, my portlet is not shown under Categories in my running Liferay instance. When I try this with the Tomcat bundle it will deploy and shows up.

Thank you for help.
Gepostet am 21.10.13 04:50.
Hey Lee,

Can you open a ticket with the steps to reproduce this error on the IDE project in JIRA? https://issues.liferay.com/browse/IDE

Gepostet am 25.10.13 01:59 als Antwort auf Nathan Harrell.
Hey Martin,

Can you post the steps to reproduce this issue into a new JIRA ticket for the IDE project?

Gepostet am 25.10.13 02:00 als Antwort auf Martin Dames.