How to install ActiveSpaces Transactions on Linux with the latest TIBCO Supplement For Oracle Java

How to install ActiveSpaces Transactions on Linux with the latest TIBCO Supplement For Oracle Java

book

Article ID: KB0070944

calendar_today

Updated On:

Products Versions
TIBCO ActiveSpaces Transactions 2.5

Description

Follow the steps below to install ActiveSpaces Transactions (AST) 2.5 on Linux with the latest TIBCO Supplement For Oracle Java. This provides a more secure, up-to-date version of Java 8 for use by AST.
 

Environment

Linux

Resolution

1. Download ActiveSpaces Transactions 2.5 from https://edelivery.tibco.com. In this example, we will use the Linux installation kit for AST 2.5.11: 'TIB_ast_2.5.11_linux_x86_64.zip'

2. Submit a Support request to obtain the latest TIBCO Supplement For Oracle Java version 1.0.0, which corresponds to Oracle Java version 1.8. Refer to the attached file ('TIBCOSupplementOracleJavaInstall.pdf') for detailed instructions. In this example, we will use version 1.0.0_HF-014, which provides Oracle Java 1.8.0_u381. The file name of this installation kit is: 'TIBCO_Supplement_For_Oracle_Java1.0.0_HF-014-Linux64.zip'

3. Install AST:
 
$ cd ~/temp/
$ unzip ~/installers/TIB_ast_2.5.11_linux_x86_64.zip
$ ./TIBCOUniversalInstaller-lnx-x86-64.bin -console

Select all the default options during the installation. This should result in a new $TIBCO_HOME being configured in your user's home directory (~/). Once the installation is complete, perform this manual step to direct AST applications to the appropriate libsasl library version:
 
$ cd /lib64/
$ sudo ln -s libsasl2.so.3.0.0 libsasl2.so.2

4. Install the TIBCO Supplement For Oracle Java:
 
$ cd ~/temp/
$ rm -rf *
$ unzip ~/installers/TIB_jresplmnt_1.0.0_HF-014_linux_x86_64.zip
$ cp ~/tibco/tools/universal_installer/TIBCOUniversalInstaller-lnx-x86-64.bin .
$ ./TIBCOUniversalInstaller-lnx-x86-64.bin -console

Select the 'JRE only' installation profile when you are prompted, and ensure the 'Oracle Elliptic Curve Cryptography Library Update' option is UN-checked.

5. After the installation is complete, move your current copies of..
  • $TIBCO_HOME/tibcojre64/1.8.0/lib/security/local_policy.jar
  • $TIBCO_HOME/tibcojre64/1.8.0/lib/security/US_export_policy.jar

..out of the $TIBCO_HOME path, and place them in a temporary directory. For details on why this step is required, please refer to our additional Knowledge article:

https://support.tibco.com/s/article/TIBCO-Administrator-TRA-5-10-3-5-11-2-Post-Domain-Migration-Task

6. Configure your environment to use AST:
 
$ export SW_HOME=~/tibco/ast/2.5.11/
$ export PATH=~/tibco/tibcojre64/1.8.0/bin/:$SW_HOME/distrib/kabira/bin/:$PATH
$ export JAVA_HOME=~/tibco/tibcojre64/1.8.0/

7. Install and start a node:
 
$ cd ~/temp/
$ administrator install node

        Installing application kabira/ast on node myhost01...

        Starting node myhost01 ...
                Installing Registry ...
                Updating Registry ...
                Installing Components ...
                Starting Components ...
                Waiting for security services to start ...
                Loading Security Policy ...
        Startup complete

        Node myhost01 is configured to use PRODUCTION executables
        Node myhost01 shared memory size is 512Mb
        Node myhost01 concurrent allocation segments is 4
        Node myhost01 path: /home/myuser/temp/myhost01
        Node myhost01 host: myhost01

        Installing components for application kabira/ast

        Administration Port: 41920
        Service Name: "myhost01"
        Node Name: "myhost01"

You can see the above output tells you the administrator port number (41920). The node name defaults to the hostname of the machine ('myhost01', in this case). Specify this port to start the node:
 
$ administrator adminport=41920 start node

        Components started
        Loading configurations
        Auditing security configuration
        Host: localhost
        Administration Port: 41920
        Service Name: "myhost01"
        Node Name: "myhost01"

8. Create a simple Java application to deploy in AST. Create a file named 'Daemon.java' with the following code:
 
// $Revision: 1.1.2.1 $
package com.kabira.snippets.vmlifecycle;
/**
 * Using daemon threads
 * <p>
 * <h2> Target Nodes</h2>
 * <ul>
 * <li> <b>domainnode</b> = A
 * </ul>
 */
public class Daemon {
    /**
     * Application thread
     */
    public static class MyThread extends Thread {
        @Override
        public void run() {
            try {
                System.out.println("thread sleeping...");
                Thread.sleep(5000);
            } catch (InterruptedException ex) {
                // Handle exception
            }
        }
    }
    /**
     * Main entry point
     * @param args Not used
     */
    public static void main(String[] args) {
        //
        // Create a new thread
        //
        MyThread t = new MyThread();
        //
        // Mark the thread as a daemon thread
        //
        t.setDaemon(true);
        //
        // Start the thread
        //
        t.run();
        //
        // Returning from main - causes the JVM to exit
        //
        System.out.println("returning from main");
    }
}

Then place this file in a temporary directory on your machine, and compile it:
 
$ mv Daemon.java ~/classpath/com/kabira/snippets/vmlifecycle/
$ cd ~/classpath/com/kabira/snippets/vmlifecycle/
$ javac Daemon.java

9. Deploy the Daemon application in AST:
 
$ export CLASSPATH=~/classpath:$CLASSPATH
$ cd ~/temp/
$ java -jar ~/tibco/ast/2.5.11/distrib/kabira/ast/java/deploy.jar \
    username=guest password=guest \
    hostname=myhost01 \
    adminport=41920  \
    com.kabira.snippets.vmlifecycle.Daemon

Issue/Introduction

Outlines the steps needed to install ActiveSpaces Transactions 2.5 on Linux with the latest TIBCO Supplement For Oracle Java.

Attachments

How to install ActiveSpaces Transactions on Linux with the latest TIBCO Supplement For Oracle Java get_app