All-in-one Installation

This installation has a pre-configuration of the H2 database and Tomcat as web server.

Before you begin
    • Confirm if you have Java 17 and TIBCO EMS (to publish records on JMS topics) installed on your computer.

    • Make sure that TIBCO EBX Software 6.0.16 is deployed, the initial configurations (for repository) are done, and TIBCO EBX is starting successfully.

    • Note the details of the repository.id and repository.label, which are required later on.

    • Create a backup of the ebx.properties present in the $EBX_HOME folder.



    1. Procedure
    2. Download the product TIB_pscebx_2.0.0.zip and unzip the archive file. For example, if you unzip the product at /home, then the directory structure is /home/pscebx/2.0.0 and is called as PSC_BASE.

      Note: The user must have the full access rights to the PSC_BASE folder.

      The following components are present in the TIB_pscebx_2.0.0.zip file.

      • db - Contains Oracle and PostgreSQL database scripts.
      • ems - Contains files related to the creation or deletion of topics.
      • common - Contains the artifacts, which is required for the Product and Service Catalog.
      • config - Contains the artifacts, which is required for the Product and Service Catalog.
      • data - Contains the artifacts, which is required for the Product and Service Catalog.
      • doc - Contains the document about how to customize the rules in the Product and Service Catalog.
      • tomcat - Contains server start up and shutdown scripts and the tomcatConfiguration.sh script to configure apache-tomcat related changes.

      • bin - Contains the copyArtifacts.sh script to copy the necessary libraries and wars.

      • war - Contains the psc-mdm.war files to be deployed into the application server.

      • deploy/
        • docker - Contains files and artifacts to create and run Docker containers for Product and Service Catalog.
        • helm - Contains all files required to deploy Product and Service Catalog on the Kubernetes cluster.

        • k8s - Contains Kubernetes scripts for Product and Service Catalog.
      Note: For a complete list of versions and supported platforms, see the TIB_pscebx_2.0.0_readme.txt file.

    3. Make a directory ext-lib in the $PSC_BASE location. Download the jars mentioned in external jars. Copy the additional JAR files such as tibjms, jms2.0 jar, and database related JAR files (ojdbc8 and postgres) and copy them in this directory.

    4. Run the $PSC_BASE/bin/copyArtifact.sh script to copy the required artifacts to $EBX_HOME location. When prompted, provide the path to the wars folder of extracted TIB_ebx-addon_5.6.3.zip file.

    5. Run the $PSC_BASE/tomcat/tomcatConfiguration.sh script to configure the apache-tomcat related changes.

    6. Update the $EBX_HOME/ebx.properties file according to the user details:

      • ebx.license

      • ebx.install.repository.id

      • ebx.install.repository.label

      • ebx.install.admin.login

      • ebx.install.admin.firstName

      • ebx.install.admin.lastName

      • ebx.install.admin.password.encrypted

    7. If TIBCO EMS requires any credentials to access, then it can be configured in the $EBX_HOME/config/config.properties file. You can set the username and password using the following properties:

      com.tibco.psc.jms.topic.connection.username
      com.tibco.psc.jms.topic.connection.password
    8. To publish records on the JMS topics, perform the following steps:

      1. Set ebx.jms.activate=true in $PSC_HOME/ebx.properties and update the TIBCO EMS address URL in the following resource property, which is present in PSC_HOME/apache-tomcat/conf/context.xml.

        <Resource name="jms/EBX_JMSConnectionFactory"
        auth="Container"
        type="com.tibco.tibjms.TibjmsConnectionFactory"
        factory="com.tibco.tibjms.naming.TibjmsAdministeredObjectFac
        tory"
        address=<<ems-address>>
        clientID="TibcoPSCEBX">
        </Resource>
        
      2. Create all the topics in the $PSC_BASE/ems/createtopic.txt file in TIBCO EMS.

    9. Run the $PSC_HOME/apache-tomcat/bin/startPSCServer.bat or $PSC_HOME/apache-tomcat/bin/startPSCServer.sh script to start the Tomcat server.

    10. After starting the server, see Configuring TIBCO® Product and Service Catalog powered by TIBCO EBX®.

    Note:

    These steps install the PSC-EBX with H2 database. To start PSC-EBX with Oracle or PostgreSQL database, see the following sections:

    ResultThe environment is ready to use.