Deploy the IBM Sterling Warehouse Management System Business Intelligence Reports

About this task

To deploy the IBM® Sterling Warehouse Management System Business Intelligence Reports follow these steps to Import the WMS-Analytics.zip into the Cognos® Content Repository.

Procedure

  1. Set the YNW_ANALYTICS_HOME environment variable as the IBM Sterling Warehouse Management System Business Intelligence Installation directory.
  2. Set the COGNOS_HOME environment variable as the parent of the Cognos 10.1.1 Installation directory, for example, If Cognos 10.1.1 is installed in the /usr/local/cognos/c10 directory, COGNOS_HOME should point to the /usr/local/cognos/c10 directory.
  3. Set the Display environment variable as appropriate to an X-Windows terminal, while installing on Unix system.
  4. The ynwinstallanalytics.xml file assumes that you have installed Cognos 10.1.1 and IBM Sterling Warehouse Management System Business Intelligence on the same machine. If, however, you have installed Cognos 10.1.1 and IBM Sterling Warehouse Management System Business Intelligence on two separate machines, modify the following line of the XML by replacing localhost with the IP address of the machine where Cognos 10.1.1 has been installed:
    <property name="cognosurl" value="http://<localhost>:<9300>/p2pd/servlet/dispatch"/>
    Note: Ensure that you copy the following third-party jar files from <COGNOS_HOME>/webapps/p2pd/WEB-INF/lib to <YNW_ANALYTICS_HOME>/lib:
    • axis.jar
    • axisCrnpClient.jar
    • CAM_AAA_CustomIF.jar
    • commons-discovery.jar
    • commons-logging.jar
    • dom4j.jar
    • jaxrpc.jar
    • saaj.jar
    • wsdl4j.jar
    • xalan.jar
    • xercesImpl.jar
    • xml-apis.jar
  5. If IBM Sterling Warehouse Management System Business Intelligence and Cognos 10.1.1 are installed on the same machine, you must additionally run the target copylib in ynwinstallanalytics.xml.

    Run the following command from <YNW_ANALYTICS_HOME>/bin: ant -f ynwinstallanalytics.xml copylib

    This command copies:

    • <YNW_ANALYTICS_HOME>/lib/sscap-auth.jar to <COGNOS_HOME>/webapps/p2pd/WEB-INF/lib directory
    • <YNW_ANALYTICS_HOME>/bin/analytics.properties.sample to <COGNOS_HOME>/webapps/p2pd/WEB-INF/classes directory
    • <YNW_ANALYTICS_HOME>/deployment/WMS-Analytics.zip to <COGNOS_HOME>/deployment directory

      If IBM Sterling Warehouse Management System Business Intelligence and Cognos 10.1.1 are installed on different machines:

    • Copy <YNW_ANALYTICS_HOME>/lib/sscap-auth.jar to <COGNOS_HOME>/webapps/p2pd/WEB-INF/lib directory on the machine.
    • Copy the <YNW_ANALYTICS_HOME>/bin/analytics.properties.sample file to the <COGNOS_HOME>/webapps/p2pd/WEB-INF/classes directory.
    • Copy the <YNW_ANALYTICS_HOME>/deployment/WMS-Analytics.zip file to the <COGNOS_HOME> deployment directory.
  6. Ensure that the Cognos service has been started with Allow anonymous access set to True. After successful import of the content repository, set Allow anonymous access to False.
  7. Run the following command from <YNW_ANALYTICS_HOME>/bin:
    ant -f ynwinstallanalytics.xml

    This publishes the IBM Sterling Warehouse Management System Business Intelligence package with reports on the Cognos Content Repository.

  8. Save the <COGNOS_HOME>/webapps/p2pd/WEB-INF/classes/analytics.properties.sample file as analytics.properties in the same directory.
  9. Change the value of the sscap.app.url property in the analytics.properties file to point to the IBM Sterling Selling and Fulfillment Foundation Application URL as follows:
    sscap.app.url=http://<hostname>:<portnumber>/smcfs

    In this instance,

    • hostname is the computer name or IP address of the computer where the IBM Sterling Selling and Fulfillment Foundation is installed.
    • portnumber is the listening port of the computer where the IBM Sterling Selling and Fulfillment Foundation is installed.