All-in-one Installation
This installation has a pre-configuration of the H2 database and Tomcat as web server.
-
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
andrepository.label
, which are required later on. -
Create a backup of the
ebx.properties
present in the$EBX_HOME
folder.
- Procedure
-
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 asPSC_BASE
.Note: The user must have the full access rights to thePSC_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 thetomcatConfiguration.sh
script to configure apache-tomcat related changes.bin
- Contains thecopyArtifacts.sh
script to copy the necessary libraries and wars.war
- Contains thepsc-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. -
Make a directory
ext-lib
in the$PSC_BASE
location. Download the jars mentioned in external jars. Copy the additional JAR files such astibjms
,jms2.0 jar
, and database related JAR files (ojdbc8
andpostgres
) and copy them in this directory. -
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 extractedTIB_ebx-addon_5.6.3.zip
file. -
Run the
$PSC_BASE/tomcat/tomcatConfiguration.sh
script to configure the apache-tomcat related changes. -
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
-
-
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
-
To publish records on the JMS topics, perform the following steps:
-
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>
-
Create all the topics in the
$PSC_BASE/ems/createtopic.txt
file in TIBCO EMS.
-
-
Run the
$PSC_HOME/apache-tomcat/bin/startPSCServer.bat
or$PSC_HOME/apache-tomcat/bin/startPSCServer.sh
script to start the Tomcat server. -
After starting the server, see Configuring TIBCO® Product and Service Catalog powered by TIBCO EBX®.
These steps install the PSC-EBX with H2 database. To start PSC-EBX with Oracle or PostgreSQL database, see the following sections: