Publishing a Personalization project

Before attempting to publish a resource, initiate a Personalization User/Resource wizard at least once.

To publish a Personalization project:

1. Open the Server perspective.

2. In the Server Configuration view, select the remote server for the Application Server to which you want to publish. If no server exists, refer to the Rational Application Developer help system information on creating a new server. Note the following:
   • The server type should be WebSphere V5.0 Remote Server.

   • The WebSphere deployment directory should be the same as the WebSphere installation directory. (If using FTP, the remote target directory should be the WebSphere installation path relative to the ftp alias).

3. In the Server Configuration view, select or create a server configuration. The HTTP port must match the port on which the remote server is running. One method of determining the port is to look in the standard output log once the application server has started for a line similar to the following:

   HttpTransport ASRVE0171I: Transport http is listening on port 9,080.
         

   If you have problems determining which port to use, try using port 80.

4. Add the projects that you want to publish to the server configuration (right-click the server configuration and click Add Project).

5. For the server instance, set the server configuration to be the configuration with your project (right-click the server instance and click Set Configuration).

6. In the Servers view, publish the server instance (right-click the server instance and click Publish).

When publishing, note the following:

• The wizards.properties file must contain the proper context root for publishing. This file is located in the WebSphere Studio plug-in folder com.ibm.wcm.resource.wizards. If the context for the PersAdmin Web Module in the Personalization run-time enterprise application is different than the default, update the servlet locations in the lines below. (Do not modify or remove the XML_ENCODING line.)

  # ------- Publish URL entries ------- 
   
  RULE_PUBLISHER=wps/PersAdmin/publishtarget
  HRF_PUBLISHER=wps/PersAdmin/servlet/com.ibm.servlet.personalization.ImportExport.ImportServlet
  XML_ENCODING=UTF-8

• The HTTP transport port and IP address must be set correctly in the server and server configuration files that are used for publishing. If these values are not set, the file transfer may succeed but Personalization rules and resources will not be configured.

• The application server hosting the Personalization run-time enterprise application must be running for publishing to succeed.

• After the files have been copied or transferred to the server, any rules (.act, .clf, or .rul files) or resources (.hrf files) will be imported into the Personalization run-time environment on the server port defined in the server. Rules and resources are also copied to the publishedRules and publishedResources folders under <was_root>/wpcp/config/<node>/WebSphere_Portal/runtime.

• The preferred publishing method when working with Personalization resources is either "Publish all" or "Prompt user." The default method, "Smart publish," will only publish modified resources. Therefore, if the resources were not configured the first time they were published, they will not be republished unless they have been modified.

 

Back