Configuring remote servers for testing portals

When defining a remote (server attach) server for testing, debugging or profiling a portal project, create and configure the server.

Follow the instructions below to create and configure a remote server. You may also need to do further configuration on the remote server. Follow the instructions in Preparing WebSphere Portal for remote testing and debugging.

  1. Open the New server wizard. See Defining servers for testing portals for instructions.

  2. Provide the host name of the remote WebSphere Portal.

  3. Select a WebSphere Portal Server Attach server from the server type list.

  4. Select Next.

  5. On the Server Ports page,

    1. Set the JVM debug port , which defaults to 7777.

    2. Set the HTTP port, which defaults to 9081.

    3. Optionally, select Enable JavaScript debugging and set the BSF debug port, which defaults to 4444.

    4. Select Automatically switch to Debug perspective if you want to switch to that perspective when using this server.

  6. On the WebSphere Portal Settings page, define the following options:

    1. Define the WebSphere Portal Base URI, which defaults to /wps.

    2. Define the WebSphere Portal Default page, which defaults to /portal .

    3. Define the WebSphere Portal Personalized homepage, which defaults to /myportal.

    4. Define the WebSphere Portal Install location, which is the WebSphere Portal installation root, such as C:\Program Files\WebSphere\PortalServer.

    5. Select Enable WebSphere security if security is enabled on the remote server.

    6. Provide an administrator ID and password for a WebSphere Portal administrator.

    7. If Enable automatic login is selected, provide a user ID and password for a WebSphere Portal user. The user must be created manually in the Portal Administration on the remote server before testing or debugging. The permission will be automatically assigned to the user in the edit level. The user id will also be used as part of the label. To use a single WebSphere Portal for multiple users, you should use a different userid for each person.

  7. On the Publishing Settings page, set the following options:

    1. Select the Local Copy or FTP file transfer option.

    2. Provide the Remote target directory, which maps to the wps.ear directory under the installedApps/nodename directory of the WebSphere Application Server on the remote system, where nodename is usually the host name of the remote server. For example, the wps.ear directory on the target server might be C:\WebSphere\AppServer\installedApps\node\wps.ear. However, if the wps.ear directory on the target server has been mapped as a network drive, the path to wps.ear may be something like E:\wpsShare. Or, if you are using FTP access, and the FTP root for the user you specify is the wps.ear directory, the path could be something like /. Consult your systems administrator for the exact path.

    3. If you select the FTP option, you will need to provide the following information:

      1. A user ID and password that has FTP access to the target system.

      2. The connection timeout value if the default of 10000 milliseconds is not adequate.

      3. If the target server is beyond a firewall, choose Use PASV mode or Use firewall. Additional firewall settings can be set by clicking the Firewall settings button.

  8. On the Add and Remove Projects page, highlight a project and select the Add or Remove button to associate or disassociate the project with the server. During publishing all projects associated with the publishing server will be deployed.

  9. Click Finish. Additional options for remote servers can be viewed and changed by double-clicking on the server in the Servers view. This opens the server configuration editor. You can change any of the settings that were defined previously. In addition, the Portal tab has additional settings for Portal and Portlet Publishing, which are listed below:

    1. Select Deploy portal projects when running or debugging to automatically deploy when using Run on Server or Debug on Server.

    2. Select Deploy portlet projects when running or debugging to automatically deploy when using Run on Server or Debug on Server.

    3. Provide a Label title if you want to override the default value, PortletPreview. The label will be created automatically during test or debug if the specified label does not exist. Testing or debugging will set the user permission level to access the label even if the label was already created and the current permission level is not adequate. The original permission level will be restored with the reset portlet preview action.

    4. Change the Label ordinal if you want to override the default value of 20. The ordinal attribute specifies the sorting order of portal resources. For information on the ordinal attributes, refer to "Special configuration data entries" in the Information Center of WebSphere Portal.

    5. Select Enable multiple pages when deploying portlet projects to allow different portlet projects to use different pages in the portal during testing. By default, multiple pages are enabled. Each portlet project that is associated with a single server will be deployed to a different page. If you want to deploy them all into a single page on the server, you can disable multiple pages when deploying portlet projects.

    6. In addition, under Basic Options, there is a check box to Enable anonymous user access. This option is to test portlet(s) in the not logged in state.

    7. Save the changes to your server configuration by pressing Ctrl + S.

 

Related tasks

Defining servers for testing portals
Preparing WebSphere Portal for remote testing and debugging
Associating servers with projects
Configuring local servers for testing portals