Installing Akana Platform 8.x

Learn how to download and install the Akana Platform self-extracting ZIP file.

Using Admin Console Installing Tools Installing Plug-ins Configuration Categories

Configuration Actions

Table of Contents

  1. Introduction
  2. System Requirements
  3. Step 1: Download Akana Platform ZIP File
  4. Step 2: Install Akana Platform ZIP File
  5. Step 3: Install Akana Platform Updates

Introduction

The Akana Platform is a OSGi environment that Akana features are designed to run within, obey its constraints, and make use of its facilities. The platform supports Windows and UNIX (Linux, Solaris, AIX) environments, and is installed using an extractable ZIP file. The Win-JRE and Linux-JRE ZIP files include a JRE if you do not want to download one. The Platform ZIP file can work anywhere but you must download and install your own JRE.

After installing the platform, feature ZIP files can be extracted to the platform, and then installed and configured using the Akana Administration Console.

System Requirements

As a prerequisite step, verify that you system conforms to the stated system requirements. See Akana Platform System Requirements 8.x.

back to top

Step 1: Download Akana Platform ZIP File

Download an Akana Platform self-extracting ZIP file from the Akana Customer Support Site.

For Version 8.0
  1. Go to the Akana Library site at https://library.akana.com/display/MAIN/Akana+Library.
  2. In the Downloads section, click Akana Platform > AP 8.0.
  3. Download a platform ZIP file:

    akana-platform-linux-jre-8.0.411.zip (Linux only - includes JRE)

    akana-platform-win-jre-8.0.411.zip (Windows only - includes JRE)

    akana-platform-8.0.411.zip (Does not include JRE. Can be used for Windows, Linux, Solaris, Windows only - includes JRE). Note: When using this JRE you must modify the bin/setDEMS.sh script and comment out lines that pertain to your JRE and then ensure you have JAVA set correctly.

For Version 8.1
  1. Go to the Akana Library site at https://library.akana.com/display/MAIN/Akana+Library.
  2. In the Downloads section, click Akana Platform > AP 8.1.
  3. Download a platform ZIP file:

    akana-platform-linux-jre-8.1.xxx.zip (Linux only - includes JRE)

    akana-platform-win-jre-8.1.xxx.zip (Windows only - includes JRE)

    akana-platform-8.1.xxx.zip (Does not include JRE. Can be used for Windows, Linux, Solaris, Windows only - includes JRE). Note: When using this JRE you must modify the bin/setDEMS.sh script and comment out lines that pertain to your JRE and then ensure you have JAVA set correctly.

For Version 8.2

To get access to the Version 8.2 upgrade files, contact Akana Technical Support.

  1. Go to the Akana Library site at https://library.akana.com/display/MAIN/Akana+Library.
  2. In the Downloads section, click Akana Platform > AP 8.2 > 8.2GA.
  3. Download a platform ZIP file:

    akana-platform-linux-jre-8.2.xxx.zip (Linux only - includes JRE)

    akana-platform-win-jre-8.2.xxx.zip (Windows only - includes JRE)

    akana-platform-8.2.xxx.zip (Does not include JRE. Can be used for Windows, Linux, Solaris, Windows only - includes JRE). Note: When using this JRE you must modify the bin/setDEMS.sh script and comment out lines that pertain to your JRE and then ensure you have JAVA set correctly.

  4. To download the latest update to version 8.2, in the Downloads section, click Akana Platform > AP 8.2.
  5. Choose the folder for the most recent version available; for example, 8.2.5.
  6. Download the cumulative update ZIP file; for example, akana-platform-update-cumulative-8.2.5.zip.
For Version 8.4

To get access to the Version 8.4 upgrade files, contact Akana Technical Support.

  1. Go to the Akana Library site at https://library.akana.com/display/MAIN/Akana+Library.
  2. In the Downloads section, click Akana Platform > AP 8.4 > 8.4GA.
  3. Choose the most recent version available.
  4. Download a platform ZIP file:

    akana-platform-linux-jre-8.4.xxx.zip (Linux only - includes JRE)

    akana-platform-win-jre-8.4.xxx.zip (Windows only - includes JRE)

    akana-platform-8.4.xxx.zip (Does not include JRE. Can be used for Windows, Linux, Solaris, Windows only - includes JRE). Note: When using this JRE you must modify the bin/setDEMS.sh script and comment out lines that pertain to your JRE and then ensure you have JAVA set correctly.

  5. Check if there are updates to version 8.4: in the Downloads section, click Akana Platform > AP 8.4.
  6. If there are any update folders listed, choose the folder for the most recent version available.
  7. Download the cumulative update ZIP file; for example, akana-platform-update-cumulative-8.4.1.zip.

back to top

Step 2: Install Akana Platform ZIP File

  1. Extract the platform ZIP file to a new or existing folder.
  2. The following table provides a brief description of Akana Platform folder.

    Folder Name Description
    \bin

    Includes the Akana Platform shell and batch scripts. This includes Start /Stop scripts for all the Akana Platform processes, scripts used to register and un-register Windows services, and scripts for launching the Akana Platform administration and configuration wizards. This folder also includes a script run the Akana Platform product as a unique Cron job.

    \config

    Includes Akana Platform properties files. These property files are reserved for system use.

    \instances

    A runtime created folder. After the platform is installed, the initial \instances folder includes config.properties and system.properties files.

    When you launch and complete the Configure Container Instance Wizard, a Configurator folder is created that includes the following sub-folders.

    • asynchworkflow – Stores code samples for platform APIs.
    • \cache - Stores OSGi bundles for installed features.
    • \deploy - Includes properties files (com.soa.config.cfg and com.soa.log.cfg) that include Akana Platform default configuration settings. These files are used to push default configuration information to the Administration Console and are typically for one-time use only. These properties pushed to the Administration Console can be updated via the "Configuration" tab. Bundles and other .cfg files can also be added to the \deploy folder and will be published to the Administration Console. These properties can also be updated via the "Configuration" tab.
    • \log - Stores log files that are automatically generated when an Akana Platform function is operating. The logging process records the actions performed for each Akana Platform function and stores the information in the log file. Log files can be archived for historical record based on your requirements.

    Each time a new container instance is created a new folder is created using the assigned container name. For example, if you installed the Policy Manager ZIP file and named the container instance the associated folder will include the following folders:

    • asynchworkflow – Stores code samples for platform APIs.
    • \cache - Stores OSGi bundles for installed features.
    • \cachedir - Reserved for system use.
    • \cm – Stores configuration data associated with Akana Administration Console "Configure" tab.
    • \deploy - Includes properties files (com.soa.config.cfg and com.soa.log.cfg) that include Akana Platform default configuration settings. These files are used to push default configuration information to the Administration Console and are typically for one-time use only. These properties pushed to the Administration Console can be updated via the "Configuration" tab. Bundles and other .cfg files can also be added to the \deploy folder and will be published to the Administration Console. These properties can also be updated via the "Configuration" tab.
    • \log - Stores log files that are automatically generated when an Akana Platform function is operating. The logging process records the actions performed for each Akana Platform function and stores the information in the log file. Log files can be archived for historical record based on your requirements.
    • \scriptStore - Stores code samples for platform  APIs.
    • \snapshot - Stores changes to a container made during updates. Is also used for update roll backs.
    • \wsdlStore - Stores code samples for platform APIs.
    \jre

    A Java Runtime Environment (JRE) folder that is automatically created during an Akana product installation. The Akana Platform is packaged with the following JRE version for each platform:

    • For Windows and UNIX platforms - 64-bit version of JRE 8.0.
    • For the AIX platform - 64-bit version of JRE 8.0.
    \jreupdate

    Includes a \ext folder that stores bouncy castle artifacts, and a \security folder that provides security algorithms, and is used for PKCS12 keystore management.

    \lib

    Includes the jar files needed by the available Akana features.

    \scripts

    Includes script utilities that help with container creation without using the Configure Container Instance Wizard UI.

back to top

Step 3: Download and Install Akana Platform Updates

Akana periodically issues updates for the Akana Platform. Update files can be downloaded from the Akana Customer Support Site. Update files must be copied to the Akana Platform Release Directory. Each update file must be extracted in version number order (earliest version first) prior to configuring a container instance.

For Version 8.0
  1. Go to the Akana Library site at https://library.akana.com/display/MAIN/Akana+Library.
  2. In the Downloads section, click Akana Platform > AP 8.0.
  3. In the Updates section, download the update ZIP files (one or more).
  4. Extract the ZIP files to the Akana Platform Release Directory in version number order.
For Version 8.1
  1. Go to the Akana Library site at https://library.akana.com/display/MAIN/Akana+Library.
  2. In the Downloads section, click Akana Platform > AP 8.1.
  3. In the Updates section, download the update ZIP files (one or more).
  4. Extract the ZIP files to the Akana Platform Release Directory in version number order.

back to top