7.4.8 Registering the server runtime environment and the server in Eclipse (When using a debugging environment in a remote machine)

Perform this procedure when connecting a local host on which Eclipse is set up to a remote host on which a debugging environment has been built.

Procedure

1. To enable the password of an administrative user, run the change-admin-password subcommand of the asadmin utility in the remote host.

   asadmin change-admin-password

   When this command is run, the result is displayed as follows:

   Command change-admin-password executed successfully.

2. To enable the SSL communication settings, run the enable-secure-admin subcommand of the asadmin utility in the remote host.

   asadmin enable-secure-admin

   When this command is run, the result is displayed as follows:

   Command enable-secure-admin executed successfully.

3. To restart the domain, run the restart-domain subcommand of the asadmin utility in the remote host.

   asadmin restart-domain

   When this command is run, the result is displayed as follows:

   Command restart-domain executed successfully.

4. Start Eclipse in the local host.

   Reference note

   Observe the following precautions when operating Eclipse:

   • A path to Eclipse's work space must not contain multibyte characters.

   • Do not use Explorer or other similar tools to directly operate the resources (folders and files) located under Eclipse's work space or data used by these resources. Failure to observe this might cause Eclipse and plug-ins to malfunction.

5. From the Eclipse menu, select Window > Preferences.

   The Preferences dialog box is displayed.

6. In the left pane of Eclipse's Preferences dialog box, select Server > Runtime Environments.

   The Server Runtime Environments page appears.

7. Click the Add button.

   The New Server Runtime Environment dialog box appears.

8. In the New Server Runtime Environment dialog box, select Hitachi > Hitachi Application Server, and then click the Next button.

   The Application Server runtime environment page appears.

9. In the Application Server runtime environment page, specify the following settings:

   • Server runtime environment name:

     Specify the server runtime environment name.

   • Application server directory:

     Specify the installation directory for Application Server for Developers.

10. Click the Finish button.

    In the Server Runtime Environments page, confirm that the specified Application Server runtime environment is registered under Server Runtime Environments.

11. Click the OK button.

12. From the Eclipse menu, select File > New > Others.

    The New dialog box is displayed.

13. In Eclipse's New dialog box, select Server > Server, and then click the Next button.

    In the New Server dialog box, the Define a New Server page appears.

14. In the Define a New Server page, specify the following settings:

    • Select the server type:

      Select the type of server to be created. Select Hitachi > Hitachi Java EE Server.

    • Server's host name:

      Specify the host name of the domain administration server (the host name of the remote host).

    • Server name:

      Although server name is customizable, changes you make here will not be applied to the setting. The server name, Java_EE_server_name (DAS:host_name), is always applied to the setting.

    • Server runtime environment:

      Specify the Application Server runtime environment.

    • DAS administration port number:

      Specify the administration port number of the domain administration server. Normally, you do not have to edit this setting. The default port number is 4848. Change this setting as appropriate to the server environment.

    Important note

    After changing Server name, change Server's host name.

15. Click the Next button.

    The DAS authentication setting page appears.

16. In the DAS authentication setting page, specify the following settings:

    • Use anonymous authentication

      Specify whether to access the domain administration server by using anonymous authentication. This is not selected because anonymous authentication is not used for connections.

    • User name:

      If you do not select the Use anonymous authentication check box, specify the user name.

    • Password file:

      If you do not select the Use anonymous authentication check box, specify the password file storing the password information.

17. Click the Next button.

    The Java EE Server page appears.

18. Select the Java EE server, and then click the Finish button.

    In the Servers view, the Application Server that you have just created shows up.

To Page Top