BMC Atrium Core - How to Configure Atrium Web Services

Version 6
    Share This:

    This document contains official content from the BMC Software Knowledge Base. It is automatically updated when the knowledge article is modified.


    PRODUCT:

    BMC Atrium Core - CMDB


    APPLIES TO:

    BMC Atrium Web Services - On Premise & Helix versions



    PROBLEM:

     

    The initialization of Atrium Web Services on Helix (RaaS) does not set the AR server host names and endpoint URLs correctly, though this steps apply to On Premise product line. The systems must be configured as follows.

    *Note that the some references point to 19.02 version, thought this applies to any version as of 7.6.

     


    SOLUTION:

     

    Steps to configure or update Atrium Web Services and CMDB Web Services

      

    Ensure the F5 Router mappings have entries matching your host name with port numbers

      

    For example, make sure there are entries that match:

      

    ·         http://[YOUR HOST NAME].onbmc.com/

      

    ·         http://[YOUR HOST NAME].onbmc.com:80/

      

    ·         https://[YOUR HOST NAME].onbmc.com/

      

    ·         https://[YOUR HOST NAME].onbmc.com:443/

      

    Ensure the environment variables are set correctly

      

    ·         ATRIUMCORE_HOME=D:\BMCSoftware\BMCAtrium

      

    ·         JAVA_HOME=D:\BMCPrereqs\Java-64\jre

      

    ·         Add %JAVA_HOME%\bin to the PATH environment variable if it is not already there.

      

    To update the WSDL and EPR links in the UDDI Registry

      

    1.       On the system where Web Services Registry is installed, open a command prompt window.

      

    2.       Type the following command:
    cd %ATRIUMCORE_HOME%\wsc\wsregistryapi

      

    3.       Type the following command to set the CLASSPATH variable with all jar files available under wsregistryapi

      

    19.02 example: SET CLASSPATH=WSRegistryAPI9.1;WSRegistryAPI91;axis2-1.5.1-merged-client-set.jar;activation-1.1;

      

    4.       To delete the current WSDL and EPR links from the UDDI Registry, enter a command similar to the following: 

      

    5.       java -cp %CLASSPATH% com.bmc.webservices.uddiapi.test.UDDIRegistryInstallUtil deleteaccesspts localhost <UDDI_PORT> <UDDI_USER> <UDDI_PASSWD> .\webservices_list_template.xml

      

    6.       Open the webservices_list_template.xml file and replace the hostname, protocol, etc in the URLs of the <accesspointurl> and <wsdlurl> elements for all web services.

      

    7.       To add the correct WSDL and EPR links in the UDDI Registry, enter a command similar to the following:

      

    8.       java -cp %CLASSPATH% com.bmc.webservices.uddiapi.test.UDDIRegistryInstallUtil publish <HOST NAME> <UDDI_PORT> <UDDI_USER> <UDDI_PASSWD> .\webservices_list_template.xml

      
    Before performing the steps below this point, stop the Atrium Web Services web server.
      

    To change the WSDL files to point to the correct host, do this:

      

    1.       Go to %ATRIUMCORE_HOME%\wsc\atriumws91\conf

      

    2.       Edit the file main.xml;

      

    3.       Find the bmc.atrium.services.hostname property and replace the hostname with the host alias for that server;

      

    4.       Find the bmc.atrium.services.port.https property and replace it with the port number for the installation. For example, 443.

      

    5.       Find the bmc.atrium.services.port.http property and replace it with the port number for the installation. For example, 80.

      

    6.       Save the file and close it;

      

    7.       In a command prompt go to %ATRIUMCORE_HOME%\wsc\atriumws91;

      

    8.       Type atriumwsutil -t HTTPS_PRIMARY -rt HTTPS_PRIMARY -p -d and press enter. Wait for the script to finish.

      

    9.       Edit the file D:\BMCPrereqs\Apache\Tomcat\webapps\cmdbws\WEB-INF\services\cmdbws\META-INF\cmdbws.wsdl

      

    10.   Set the location attribute of soap:address element so the host name is set correctly (below wsdl portion shall be there and just requires an entry update), for example:
    <wsdl:service name="cmdbws">
      <wsdl:port name="CMDB_WebService" binding="tns:CMDB_SOAPBinding">
        <soap:address location="http://[YOUR HOST NAME].onbmc.com/cmdbws/server/cmdbws"/>
      </wsdl:port>
    </wsdl:service>

      

    To set the correct AR server host name and port number, do this:

      

    1.       Go to %ATRIUMCORE_HOME%\wsc\atriumws91\conf;

      

    2.       Edit the file AtriumProperties.xml;

      

    3.       Find the bmc.atrium.arserver.hostname property and replace the hostname with the RoD host alias for the AR server. For example: onbmc-s;

      

    4.       Find the bmc.atrium.arserver.port property and replace it with the port number for the installation. For example, 46262.

      

    5.       Go to %ATRIUMCORE_HOME%\wsc\cmdbws;

      

    6.       Edit the file cmdbws.properties;

      

    7.       Find the bmc.cmdbws.arserver.hostname property and replace the hostname with the RoD host alias for the AR server. For example: onbmc-s;

      

    8.       Find the bmc.cmdbws.arserver.port property and replace it with the port number for the installation. For example, 46262.

      

    Start the Atrium Web Service web server and test.

       Related Products:  
       
    1. BMC Atrium CMDB Suite
    2.  
    3. BMC Atrium CMDB Suite
    4.  
    5. BMC Atrium Core - CMDB

     


    Article Number:

    000097092


    Article Type:

    Solutions to a Product Problem



      Looking for additional information?    Search BMC Support  or  Browse Knowledge Articles