Installing the MAP software

You can install the MAP software on a WebSphere® Application Server that is separate from the WebSphere Portal application server.

1. Create the application server using the WebSphere Application Server Integrated Solutions Console.
2. On the server where the MAP is installed, log in as the user who installed WebSphere Application Server.
3. Start the application server (for example, server1 or other_map_server) on which you plan to install the MAP.
4. Run the following command to ensure that the WebSphere environment is set up correctly:
   

   . was_root/bin/setupCmdLine.sh

   Note: There is a space between the period (.) and the rest of the command.
   

   was_root\bin\setupCmdLine

5. Change your working directory to was_profile_root/map/install.
6. Run the following command to install MAP:
   

   ./mapInstaller.sh -DServerName=server_name
   -DWasUserid=WAS_admin_userid_value
   -DWasPassword=WAS_admin_password_value
   -DHostName=imgHost
   -DHostPort=imgPort
   -DProxyName=proxyHost
   -DProxyPort=proxyPort
   -DManagedNode=state
   -DMapDbHost=fully_qualified_MAPDB_Host_name
   -DMapDbPort=MAP_database_port
   -DMapDbName=MAP_database_name
   -DMapDbUser=MAP_database_userid
   -DMapDbPass=MAP_database_password
   -DMapDbDrivers=JDBC_driver_path
   -DMapDbVendor=Database_vendor_name

   

   mapInstaller.bat -DServerName=server_name
   -DWasUserid=WAS_admin_userid_value
   -DWasPassword=WAS_admin_password_value
   -DHostName=imgHost
   -DHostPort=imgPort
   -DProxyName=proxyHost
   -DProxyPort=proxyPort
   -DManagedNode=state
   -DMapDbHost=fully_qualified_MAPDB_Host_name
   -DMapDbPort=MAP_database_port
   -DMapDbName=MAP_database_name
   -DMapDbUser=MAP_database_userid
   -DMapDbPass=MAP_database_password
   -DMapDbDrivers=JDBC_driver_path
   -DMapDbVendor=Database_vendor_name

   where

   • server_name specifies the name of the WebSphere Application Server to which the MAP enterprise application is mapped (for example, server1 or the application server you created in step 1)
   • WAS_admin_userid_value is the WebSphere Application Server administrative user ID (required only when WebSphere Application Server security is enabled)
   • WAS_admin_password_value is the WebSphere Application Server administrative password (required only when WebSphere Application Server security is enabled)
   • imgHost is the fully qualified host name of the image host used by the MAP. If you are using MAP with WebSphere Portal, specify the WebSphere Portal host name unless you plan to put the images on a separate web server. If you are using the MAP with a messaging web application, specify the fully qualified host name of the messaging web application unless you plan to put the images on a separate web server. This parameter defaults to localhost if it is not specified.
   • imgPort is the port on which the image host is listening. If you are using the MAP with WebSphere Portal, specify theWebSphere Portal port number (for example, 10040) unless you plan to put the images on a separate web server. If you are using the MAP with a messaging web application, specify the port number used by the messaging web application unless you plan to put the images on a separate web server. This parameter defaults to 80 if it is not specified.
   • proxyHost is optional and should be set to the fully qualified hostname of the HTTP proxy server (if you plan to use one). This parameter appears in the installed ics-config.xml only if a value is specified.
   • proxyPort is optional and should be set to the port that the proxy host is listening on (if you plan to use a proxy server). This parameter appears in the installed ics-config.xml only if a value is specified.
   • state indicates whether the node on which the MAP is being installed is managed by the WebSphere Application Server deployment manager. If the node is a federated node managed by deployment manager, set state to true. Otherwise, you can set state to false or omit the -DManageNode parameter altogether.
   • fully_qualified_MAPDB_Host_name is the fully qualified host name of the server where the MAP database is located.
   • MAP_database_port is the port to which the MAP database is listening (for example, in DB29.x, the default is 5000).
   • MAP_database_name is the MAP database name, created before installing MAP.
   • MAP_database_userid and MAP_database_password is the MAP database user ID and password.
   • JDBC_driver_path is the CLASSPATH of the database drivers. For DB2, use the absolute directory of the database driver location; for Oracle, direct path to the driver.
   • Database_vendor_name is the name of the supported database (DB2, MSSQL, Oracle).
7. Restart the portal server using the following commands:
   

   was_root/bin/stopServer.sh server_name -username WAS_admin -password WAS_admin_password_value

   was_root/bin/startServer.sh server_name

   

   was_root\bin\stopServer server_name -username WAS_admin -password WAS_admin_password_value

   was_root\bin\startServer server_name

   where server_name is the name of the WebSphere Application Server to which MAP was mapped (for example, server1 or other_map_server).

8. Log in to the WebSphere Application Server Integrated Solutions Console where MAP is installed.
9. Click Resources > JDBC > DataSources.
10. In the List of Scopes drop-down list, click Node Scope.(server1/other map server) of the MAP server.
11. Select the following data source: (data source for MAP)
    • Data source name: descriptorstore
    • JNDI name: jdbc/descriptorstore
    Note: The descriptorstore data source is created automatically during the installation of MAP.
12. Click Next.
13. Select the MAP data source (descriptorstore) and click JAAS-J2C Authentication data Alias.
    1. Enter an alias name (for example, MAPAlias).
    2. Enter credentials (database user ID and password).
    3. Click Finish.
14. Click DataSources > Security settings.
    1. Select the newly created component-management authentication alias (for example, MAPAlias).
    2. Click Save.
    3. Select the descriptorstore check box and click Test Connection.
       Note: If the test connection fails and you modify the configuration, you must restart the application server (for example, server1) before testing the connection again.
15. Confirm the saved settings to the Master configuration on WebSphere Application Server.
    1. Select the descriptorstore check box and click Test Connection.
       Note: If the test connection fails and you modify the configuration, you must restart the application server (for example, server1) before testing the connection again.
16. Configure the data source for MAP by using the following steps from the WebSphere Application Server Integrated Solutions Console:
    Note: Installing MAP on the server automatically creates the data source on WebSphere Application Server.
    1. Click Resources > JDBC > Data Sources.
    2. Edit the descriptorstore configuration. Click the JAAS - J2C Authentication data link. Create an identity with database credentials.
    3. Click Application servers > server1 /WebSphere_Portal > Installed applications > map.
    4. Click Mapping Resource references to resources.
    5. Locate the map data source and click OK.
    6. Specify the authentication method by applying previously created credentials to the MAP database.
    7. Save the configuration.
17. On the MAP server, edit ics-config.xml located in the map_installLocation/installedApps/yournode/map.ear/map.war/WEB-INF/ directory. Update imgHost='image-host-name' with the image host name and imgPort='map-port' with the MAP database port. The map-port is the same port number you defined with DMapDBPort during the installation of MAP, for example, 9080.

    If you leave the imgHost parameter blank using single quotation marks, for example '', it indicates that the MAP server hosts itself is an image server.

    imgPort parameter represents the port number through which the image is served. If you leave the imgPort parameter blank using single quotation marks, for example '', it indicates that the imgPort is same as MAP Server Port

    To verify the successful MAP installation, make sure both imgHost and imgPort are blank, for example imgHost='' and imgPort=''.

18. Restart the portal server using the following commands:
    

    was_root/bin/stopServer.sh server_name -username WAS_admin -password WAS_admin_password_value

    was_root/bin/startServer.sh server_name

    

    was_root\bin\stopServer server_name -username WAS_admin -password WAS_admin_password_value

    was_root\bin\startServer server_name

    where server_name is the name of the WebSphere Application Server to which MAP was mapped (for example, server1 or other_map_server).

19. Start the installed MAP application from WebSphere Application Server Integrated Solutions Console. Go to Enterprise Applications and select map from the list of installed applications. Then, click Start.
20. Verify that the MAP installation is successful by rendering the default image located on the MAP server. Enter the following URL in a browser: http://map_server:map_port/map/ics/images/cj24/volantis.gif
    Note: Verify that the imgHost and imgPort parameters are blank, for example imgHost='' and imgPort='', in the ics-config.xml file located in the map_installLocation/installedApps/yournode/map.ear/map.war/WEB-INF/ directory.

    The image renders in the browser.

21. If you are using a web server, regenerate the web server plug-in using the WebSphere Application Server Integrated Solutions Console.
    1. Navigate to Environment > Update Web Server Plug-in and click OK.
    2. If the web server is external, you must also copy the updated plug-in configuration file (/WebSphere/DeploymentManager/config/cell_name/plugin-cfg.xml) to the plug-in configuration directory of the external web server.
       Note: In a production environment, it is recommended that you use a proxy server with the MAP. See the topic Configuring a proxy server with the MAP for more details.