Installing the Akana API Platform 8.2x

Learn how to download, install, and configure the Akana API Platform 8.2x, including the Akana Platform and all features previously included in Policy Manager and Community Manager.

Note: This document covers instructions for the combined features available in version 8.2x. For versions prior to 8.2x, see Installing Policy Manager 8.x.

Using Admin Console Installing Tools Installing Plug-ins

Configuration Categories Configuration Actions

Installing Akana API Platform 8.4

Supported Platforms: 8.2x

Table of Contents

Installation Procedure:
  1. Overview
  2. Step 1: Gather ZIP files and download to the install folder
  3. Step 2: Unzip files into the installation folder in the correct sequence
  4. Step 3: Run Configurator to create the first container
  5. Step 4: Install Policy Manager features on the container
  6. Step 5: Install plug-ins on the container
  7. Step 6: Configure container features
  8. Step 7: Create and configure additional containers
  9. Step 8: Add Network Director to Policy Manager
  10. Step 9: Create developer portal tenant using the Jython script
  11. Step 10: Run the developer portal
Installation Tasks/Reference:
  1. Supported databases
  2. Database drivers
  3. Installation folder structure
  4. Sample Installation Scenario
  5. Clear Configurator Cache
  6. Configure Container Instance Wizard
  7. Starting a container
  8. Stopping a container
  9. Creating a container using silent install (Linux)
  10. Unregistering and re-registering the Windows service
  11. Linux install: exporting the JAVA_HOME variable
  12. Related Topics

Installation Procedure:

Overview

This document provides instructions for installing the Akana API Platform version 8.2.

It covers a simple scenario of setting up three containers:

  1. One container for Policy Manager.
  2. One container for Community Manager.
  3. One container for Network Director.

This document covers the following broad activities associated with the installation process:

  • Preparation (Steps 1 and 2)
  • Installing features and plug-ins, and configuring, for the first container (Step 3 to Step 6)
  • Installing and configuring additional containers (Step 7, which is Step 3 to Step 6 repeated for each container as needed)
  • Adding Network Director to Policy Manager (Step 8)
  • Creating and running the API Platform tenant (Step 9 and Step 10)

Step 1: Gather ZIP files and download to the install folder

The first step is to gather the installation ZIP files from the Akana Library (https://library.akana.com/display/MAIN/Akana+Library. On the left, click Downloads.

Note: If you don't see the 8.2 files, contact Technical Support for access.

Create a folder for your installation; for example, AP82. Gather all applicable ZIP files in the installation folder.

You'll need at minimum the following files:

  1. Akana Platform ZIP file: choose the appropriate file for the operating system you're using:
    • Windows (includes JRE: akana-platform-win-jre-8.2.xxx.zip
    • Linux ( includes JRE): akana-platform-linux-jre-8.2.xxx.zip
    • Windows, Linux, or Solaris (does not include JRE; provide your own JRE, version 1.8): akana-platform-8.2.xxx.zip
  2. Akana API Platform ZIP file (contains all necessary files for Akana API Platform installation, including Policy Manager and Community Manager installation): akana-api-platform-8.2.xxx.zip.

Depending on the scenario, you might also need the following files:

  • Incremental updates to the Akana Platform: download any that are available, up to the latest version.
  • Incremental updates to the Akana API Platform: download any that are available, up to the latest version.
  • Plug-ins: The ZIP file, and any updates, for any plug-ins you want to use in your installation.

back to top

Step 2: Unzip files into the installation folder in the correct sequence

When you've downloaded all applicable ZIP files, extract the files into your AP82 folder in the sequence listed below.

Note: The sequence is very important. Be sure to install products, and updates, in the sequence given below.

  1. Akana Platform main file.
  2. Akana Platform updates if applicable: One or more updates if there are any, beginning with the earliest update, up to the latest. If you're prompted whether to overwrite a file, select Yes.
  3. Akana API Platform main file.
  4. Akana API Platform updates if applicable: One or more updates if there are any, beginning with the earliest update, up to the latest. If you're prompted whether to overwrite a file, select Yes.
  5. Plug-ins for your installation, if any.

back to top

Step 3: Run Configurator to create the first container

The first step in creating a container is to run the Configurator. Here, you specify basic values about the container.

Once the container has been created, you can go into the Akana Admin Console for the container and install features into it.

You can create a container in any of three different modes:

To create a container via the GUI

For information on the Configure Container Instance Wizard, see Configure Container Instance Wizard.

  1. Open up a command prompt.

    Note: if you want to install the container as a Windows service, open the command prompt in Administrator mode.

  2. Go to the new folder where you unzipped the version 8.2x files (for example, AP82).
  3. Navigate to the \bin subfolder and run one of the following commands, depending on your operating system:

    Windows:

    startup.bat configurator

    Unix:

    startup.sh configurator

    The Configurator starts with the Welcome to Configure Container Instance Wizard page, as shown below.

    Configurator

  4. Click Next. The wizard steps you through the following pages:
    1. Instance Name: Specify the name of the Akana container instance; for example, pm1. Click Next.
    2. Default Admin User: Specify Administrator Credentials (username and password) or accept defaults. Click Next.
    3. Default HTTP Listener: Specify port, host IP address, and bind to all interfaces/specified interface only, or accept defaults. Click Next.
    4. Instance Startup: Choose Standalone, Install as Windows Service, or Do Not Start Instance. Click Next.

      Note if you want to install as windows service, the command prompt you used to start the Configurator must be running in Administrator mode.

    5. Launch Admin Console: The checkbox is selected by default. If you do not want to launch the Admin Console UI, clear the checkbox. Click Next.
    6. Instance Configuration Summary: Review the summary. If all OK, click Finish. The container is configured. When configuration is complete, the Admin Console starts automatically (unless you cleared the checkbox in Step 7 above; if so, you'll need to start it manually).

Continue to the next step.

back to top

Step 4: Install Policy Manager features on the container

You can configure a Policy Manager container using either GUI or Silent options.

Follow the short procedure below to install the Policy Manager features for this three-container scenario (one PM, one CM, one ND). For additional information on features for different scenarios, see Sample Installation Scenarios.

To install Policy Manager features on the container
  1. In the Akana Administration Console, go to the Available Features list.
  2. Choose the options applicable to your install, and then click Install Feature; then, at the Resolution Summary, click Install Feature again. In this multi-container example with PM and CM in separate containers, you'd choose the features below for the PM container:
  3. At the Installation Complete summary, click Configure (if you are installing plug-ins, click Close and install plug-ins first).

For additional information, if needed, refer to the following topics:

The next step is to install any plug-ins that are needed for the container.

back to top

Step 5: Install plug-ins on the container (as needed)

Depending on your installation scenario, you might need to install one or more plug-ins on your container.

In this installation scenario of three containers (PM, CM, and ND), one plug-in is needed on the PM container, and one or more on the CM container. The procedures below walk you through both of these.

To install plug-ins on the container (PM example)
  1. At the Available Features list, from the Filter drop-down list at the top left, choose Plug-Ins.
  2. Choose features to install. For example, if you are setting up the Policy Manager container, but the installation will include Community Manager on another container, you'd choose the option below:
    • Akana Community Manager Policy Console
  3. Click Install Feature.
  4. Review the installation summary. To continue to the configuration step, click Configure.
To install plug-ins on the container (CM example)
  1. At the Available Features list, from the Filter drop-down list at the top left, choose Plug-Ins.
  2. Choose features to install. For example, if Community Manager is installed on the container you'd choose one or more themes:
    • Akana Community Manager Policy Console
    • Akana Community Manager Default Theme
    • Akana Community Manager Hermosa Theme
    • Akana Community Manager Simple Developer Theme
  3. Click Install Feature; then, at the Resolution Summary, click Install Feature again.
  4. Review the installation summary. To continue to the configuration step, click Configure.

back to top

Step 6: Configure container features

The next step is to configure the features you've just installed. When you click Configure at the end of the installation process in the previous step, the process steps you through the wizards for each configuration step.

If you're not continuing straight from the Installation Complete summary, you can resume these tasks later: in the Akana Administration Console for the container, click the Installed Features tab. Pending installation steps are listed at the bottom left. Click Complete Configuration to start the process.

Note: Before configuring the database, make sure you have the applicable database driver in place. See Database drivers.

To configure Policy Manager features
  1. Click through the configuration wizards, choosing values as needed. Configuration steps vary according to the features you're installing. In this example, the first wizard is the Manage PKI Keys Wizard. Choose key management options and other values and then click Finish. Review the summary and then click Go to Next Task.
  2. At the Configure Database Options Wizard, specify your database and other values. Since this is the first container, select Create new database (for subsequent containers, you'll use the same database, so you'd select Use existing database).

    You'll need to have your database driver in place, in the {installation}\instances\{containername}\deploy folder, before running this wizard. See Database drivers.

    If you're using a new Oracle database, see Database notes: Oracle for additional Oracle-specific information about DBA permissions and password configuration.

  3. At the Manage Schemas wizard, check the checkbox for the Policy Manager schema, as shown below, and click Finish. Review the summary and then click Go to Next Task.

    Manage Schemas wizard

  4. At the Define Policy Manager Administrator Credentials Wizard, specify Administrator Credentials (username and password) or accept defaults. Click Finish. Review the summary and then click Go to Next Task.
  5. At the Provisioning Wizard, make sure the box is checked, and then click Finish.
  6. When the provisioning task is complete, you'll see a message box prompting you to restart your system. Click OK.
  7. At the Complete Configuration page, click Close.

Configuration of the first container is now complete.

back to top

Step 7: Create and configure additional containers

Once you have the first container set up, it's time to create and configure additional containers. Essentially you'll follow these steps for each container: Step 3: Run Configurator to create the first container through Step 6: Configure container features. See To create an additional container below.

Create containers in this sequence:

  1. First, create all Policy Manager containers.
  2. Then, create all Community Manager containers.
  3. Then, create all Network Director containers.

    You can configure a Network Director container using either GUI or Silent options. For instructions on how to install a Network Director Container (ND1), install and configure the Network Director feature, and register the ND1 container in Policy Manager, refer to Using Network Director Feature.

To create an additional container
  1. Run Configurator to create the container. See Step 3: Run Configurator to create the first container. Note these differences:
    • Use a different port number for each container.
  2. Install features on the container. See Step 4: Install Policy Manager features on the container. For information on which features you might choose, see Sample Installation Scenarios.
  3. Install any needed plug-ins on the container. See Step 5: Install plug-ins on the container (as needed). For information on which plug-ins you'd select, see Sample Installation Scenarios. For the CM container you'll need to install at least the following:
    • Akana Community Manager Policy Console.
    • One or more themes: Akana Community Manager Default Theme, Akana Community Manager Hermosa Theme, or Akana Community Manager Simple Developer Theme.

    For the Network Director container, you don't need any plug-ins unless you are setting up a cluster.

  4. Configure the features. See Step 6: Configure container features. Note these differences:
    • If you had to copy a database driver for the first container, you'll need to complete the same action for each subsequent container.
    • In the Configure Database Options Wizard, choose Use existing database, and add the information about the database you set up for the first container.
    • For a CM container, the Manage Schemas Wizard will look something like the below:

      install schemas for CM

    • For the Network Director container, you'll need to configure WS-MetaDataExchange options. Make sure the URL is set to {PM_URL}/wsmex. For example: http://localhost:9900/wsmex. If you have multiple PM containers set up as a cluster, use the URL for the master node.

Follow the steps for each container until all containers are set up and configured.

As you complete configuration for each container, be sure to restart at the prompt.

back to top

Step 8: Add Network Director to Policy Manager

The next step is to add the Network Director to Policy Manager so that you can access the developer portal and start sending traffic.

To add Network Director to Policy Manager
  1. Using the URL you set up for Policy Manager (Step 3 above), access Policy Manager in the browser. For example: http://localhost:9900. This redirects to the Policy Manager login page: {pm_url}/admin/login.html. Log in using the credentials you set up.
  2. In the Organization Tree, under Containers, click Add Container, as shown below.

    add container

  3. At the Add Container Wizard:
    • Select Container Type: Container or Container Cluster. Click Next.
    • Specify Metadata Import Options: Set up the metadata URL of the Network Director container, using the URL you set up for the container and appending /metadata. For example: http://localhost:9902/metadata. Click Next.
    • X.509 Certificate Not Trusted: If you get this message, modify the certificate or accept the default to add the certificate to the Policy Manager trusted certificate store. Click Next.
    • Specify Container Details: Provide an instance name (for example, ND1). Click Finish.
    • Completion Summary: review the summary and then click Close.
  4. Check that the container appears in Policy Manager. It should look something like the below. The initial state value is Stopped, but after a short time it changes to Started as shown below.

    Network Director container in Policy Manager

If you're using the developer portal, the next step is to create the Community Manager tenant.

back to top

Step 9: Create developer portal tenant using the Jython script

The next step is to create the tenant for the developer portal. To do this, you'll need to do one or more of the following:

  1. Conditional, Linux users only: Export the JAVA_HOME location to your installation directory. See Linux install: exporting the JAVA_HOME variable.
  2. All users: Run a Jython script at the command line. The script includes various parameters that you can use to specify values for your tenant, such as the tenant name, the theme you want to use, the Administrator login, the "from" email address for notifications that the developer portal sends to users, and other values. See Developing and running the Jython script below.
  3. Conditional, for custom tenant name: If you choose a tenant name other than the default (atmosphere), update a configuration setting to the new value, in the Akana Administration Console for the CM container. See Conditional: updating configuration setting for new context root below.

Developing and running the Jython script

In composing your script, refer to the examples below:

  • Example 1: Template script with placeholders.
  • Example 2: An example with each parameter on a separate line, with sample values.
  • Example 3: Jython script example for Unix.

For detailed information about the various parameters that make up the Jython script, and the values you can choose, see Jython Script Elements.

Note: The default value for the context path in the consoleAddress parameter is atmosphere. If you change the value, as in Example 2 below where the value is set to acmepaymentscorp, there is an additional step you'll need to take before running the developer portal, to update the atmosphere.context.root value in the Akana Administration Console. See Conditional: updating configuration setting for new context root below.

Example 1: Template script with placeholders

In the template script below, a few line breaks have been added for clarity. Replace the values enclosed in curly brackets with the values for your implementation (remove the curly brackets).

jython.bat ../scripts/Lib/soa/atmosphere/tenant.py -a -v --url {CM_URL} 
--tenantName {tenantid} --tenantId {tenantid} --address {CM_URL} 
--consoleAddress {CM_URL/{tenantid} --theme default --themeImpl default 
--email {emailaddress} --password {password} 
--contactEmailAddress {emailaddress} --fromEmailAddress {emailaddress}

Example 2: Each parameter on a separate line, with sample values

In the example below, line breaks have been added between the Jython script elements. This example installs Hermosa theme (theme = hermosa, themeImpl = default).

jython.bat ../scripts/Lib/soa/atmosphere/tenant.py -a –v 
--url http://localhost:9901 
--tenantName acmepaymentscorp 
--tenantId acmepaymentscorp 
--address http://localhost:9901 
--consoleAddress http://localhost:9901/acmepaymentscorp 
--theme hermosa 
--themeImpl default 
--email administrator@acmepaymentscorp 
--password password 
--contactEmailAddress support@acmepaymentscorp.com 
--fromEmailAddress notifications@acmepaymentscorp.com

Example 3: Unix example

./jython.sh ../scripts/Lib/soa/atmosphere/tenant.py -a -v --url http://lxc1-pm8x-22.local.akana.com:9900 
--tenantName EnterpriseAPI --tenantId enterpriseapi --address http://lxc1-pm8x-22.local.akana.com:9900 
--consoleAddress http://lxc1-pm8x-22.local.akana.com:9900/enterpriseapi --theme default --themeImpl default 
--email support@acmepaymentscorp.com --password password --contactEmailAddress support@acmepaymentscorp.com 
--fromEmailAddress no_reply_cm@acmepaymentscorp.com
To run the Jython script
  1. At a command prompt, go to the \bin folder for your installation.
  2. Run the Jython script command, customized for your installation, as shown in the example above.
  3. The script runs, and returns a response code 200 with a message that it was successful, as shown in the example below.

    Jython script successful

Note: If you get a 404, make sure that the container is started. Start the container and run the script again.

Conditional: updating configuration setting for new context root

The default value for the context path in the consoleAddress parameter is atmosphere. If you use a different value in the Jython script, you'll need to change a configuration setting before running the developer portal. Follow the instructions below. For example, if you choose / as the context root (consoleAddress value of {CM_URL}/), change this configuration setting to /.

The default tenant name is atmosphere. If you use a different tenant name in the Jython script, you'll need to change a configuration setting before running the developer portal. Follow the instructions below.

To update the configuration setting for the new context root
  1. Log in to the Akana Administration Console for the CM container.
  2. Click the Configuration tab.
  3. On the left, under Configuration Categories, scroll down to find the com.soa.atmosphere.console category.
  4. On the right, find the atmosphere.context.root property, and update the value. An example is shown below.

    updating configuration

  5. Click Apply Changes.
  6. Restart the container so that the changes take effect.

Now, you can log in to the developer portal and start configuring settings and adding apps and APIs. See Step 10: Run the developer portal below.

back to top

Step 10: Run the developer portal

Installation steps are now complete, and you can run the develop portal and set up domains and users, configure settings, and add apps and APIs. To access the developer portal, follow the steps below.

To run the developer portal
  1. Compose the developer portal URL as follows:
    • Take the root address for the container that CM is installed on: for example, http://localhost:9901.
    • Append /{tenantid}.
    • For example: http://localhost:9901/atmosphere.
  2. Paste the URL in the browser. The browser redirects to the default landing page; for example: http://localhost:9901/atmosphere/#/home/landing.
  3. Log in, using the username and password from the Jython script.

For information about tasks relating to the developer portal, including Site Admin tasks such as configuring platform login, setting up domains, and choosing platform settings, as well as user tasks such as adding apps and APIs, refer to the platform help: http://docs.akana.com/cm/learning.html.

back to top

Installation Tasks/Reference:

Supported databases

Akana API Platform 8.2.x supports the following database versions:

In addition, versions 8.2.3 onwards support the following:

  • Microsoft SQL Server 2012 and 2014
Database notes: Oracle

Please note the following if you're working with an Oracle database:

  • Oracle password: If you’re creating a new Oracle database using the Create New Database wizard (standard installation procedure), make sure the Oracle database password does not start with a number or special character.
  • Database permissions, Oracle 12c only: When using Oracle 12c to configure a new database, the DBA must GRANT SELECT ON SYS.USER$ TO SYSTEM; (substitute the SYSTEM user for the user specified for the Administrator credentials). This is because Oracle 12c introduced restricted access to SYS.USER$, which the platform uses to query on.
  • Database drivers: For Oracle database drivers, see Database drivers below.

back to top

Database drivers

Depending on which database server you're using, you might need to install a database driver before running the Configure Database Options Wizard.

If you need to install a database driver, place it in this location:

  • /instances/{container_name}/deploy folder

Database options, with driver information:

back to top

Installation folder structure

After installation, the directory structure will look similar to the following:

Installation folder structure

Installation includes the following folders:

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 to run the Akana Platform product as a unique Cron job.
config
Includes Akana Platform properties files. Reserved for system use.
docs
Includes product documentation.
instances
After installation, 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. After initial configuration, you can update properties in the Administration Console 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. You can archive log files for historical record as needed.
Each time a new container instance is created, the platform creates a new folder using the container name. For example, if you install the Policy Manager ZIP file and name the container instance, the associated folder includes the above folders plus the following:
  • cachedir—Reserved for system use.
  • cm—Stores configuration data associated with the Akana Administration Console Configure tab.
  • scriptStore—Stores code samples for platform APIs.
  • snapshot—Stores changes to a container made during updates. Also used for update rollbacks.
  • 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 applicable JRE version for each release.
jreupdate
Includes an 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 you can use to create containers without using the Configure Container Instance Wizard UI.
yajsw
Includes files used by the Akana Platform to support YAJSW. See http://yajsw.sourceforge.net.

back to top

Sample installation scenarios

The examples below show which features to install for some sample scenarios, including:

One container with Policy Manager installed (no Community Manager)

Install these features on the Policy Manager container:

  • Akana Policy Manager Console
  • Akana Policy Manager Services

Install this feature on the Network Director container:

  • Akana Network Director

Multi-container setup with Policy Manager installed (no Community Manager)

Policy Manager Container Features:

  • Akana Managed Services
  • Akana Policy Manager Console
  • Akana Policy Manager Services
  • Akana Scheduled Jobs
  • Akana Security Services

Network Director Container Features:

  • Akana Network Director

One container with both Policy Manager and Community Manager installed

Install these features:

  • Akana Embedded Elasticsearch Node
  • Akana Policy Manager Console
  • Akana Policy Manager Services
  • Akana Community Manager
  • Akana Community Manager APIs
  • Akana Community Manager Default Theme
  • Akana Community Manager OAuth Provider
  • Akana Community Manager Scheduled Jobs
  • Akana Managed Services
  • Akana OAuth Provider
  • Akana Scheduled Jobs
  • Akana Security Services

Install these plug-ins on every non-Network Director container:

  • Akana Community Manager Policy Console
  • One or more of the following (at least one theme is required for Community Manager):
    • Akana Community Manager Default Theme
    • Akana Community Manager Hermosa Theme
    • Akana Community Manager Simple Developer Theme

Install this feature on every Network Director container:

  • Akana Network Director

Multi-container setup with Policy Manager and Community Manager in separate containers

Policy Manager Container Features:

Policy Manager Container Plug-ins:

  • Akana Community Manager Policy Console

Community Manager Container Features:

  • Akana Community Manager
  • Akana Community Manager APIs
  • Akana Community Manager OAuth Provider
  • Akana Community Manager Scheduled Jobs
  • Akana Embedded Elasticsearch Node
  • Akana Policy Manager Console (for more information on this feature see Using the Policy Manager Console Feature)

Community Manager Container Plug-ins:

Install these plug-ins:

  • Akana Community Manager Policy Console
  • One or more of the following (at least one theme is required for Community Manager):
    • Akana Community Manager Default Theme
    • Akana Community Manager Hermosa Theme
    • Akana Community Manager Simple Developer Theme

Network Director Container Features:

  • Akana Network Director

Needed in any multi-container deployment that does not include Community Manager

Install these features on every non-Network Director container:

  • Akana Managed Services
  • Akana Scheduled Jobs
  • Akana Security Services

Install this feature on every Network Director container:

  • Akana Network Director

Needed in any multi-container deployment that includes Community Manager

Install these features on every non-Network Director container:

  • Akana Managed Services
  • Akana Scheduled Jobs
  • Akana Security Services
  • Akana Embedded Elasticsearch Node

Install these plug-ins on every non-Network Director container:

  • Akana Community Manager Policy Console
  • One or more of the following (at least one theme is required for Community Manager):
    • Akana Community Manager Default Theme
    • Akana Community Manager Hermosa Theme
    • Akana Community Manager Simple Developer Theme

Install this feature on every Network Director container:

  • Akana Network Director

Needed for the Network Director container

Install the below on the Network Director container:

  • Akana Network Director

back to top

Clear Configurator Cache

You might need to clear the configurator cache. Follow the steps below.

To clear configurator cache
  1. Locate the configurator cache folder: \instances\configurator\cache, as shown below.

    Configurator cache folder

  2. Delete the folder if it exists (if there is no cache, the folder will not be there).

back to top

Configure Container Instance Wizard

Configure Container Wizard pages:
  • Instance Name: provide name; for example, aap82.
  • Default Admin User: specify Administrator Credentials (username and password) or accept defaults.
  • Default HTTP Listener: port, host IP address, bind to all interfaces/specified interface only.
  • Instance Startup: Choose Standalone, Install as Windows Service, or Do Not Start Instance.

    Note: If you want to run Install as Windows Service, the command prompt you used to start the Configurator must be in Administrator mode. If necessary, restart the Configurator in a new window in Administrator mode.

  • Launch Admin Console: Checkbox is selected by default. If you do not want to launch the Admin Console UI, clear the checkbox. Click Next.
  • Instance Configuration Summary: review options. If all OK, click Finish.

back to top

Starting a container

There are several approaches to starting a container:

  • In Windows:
    • At a command prompt
    • As a Windows service
  • In Unix:
    • At the command line
    • With background option
To start a container in Windows at a command prompt
  1. At a command prompt, navigate to the \bin folder for the implementation. For example: c:\akana\ap82\bin.
  2. Type:
    startup {containername}

There might be a short delay while the container starts.

To start a container as a Windows service

Note: You can only start a container as a Windows service if it was installed as a Windows service.

  1. Launch the Services list (Control Panel > Administrative Tools > Services).
  2. Select the instance name on the list.
  3. From the right-click Actions menu, choose Stop.

There might be a short delay while the container starts.

To start a container in Unix
  1. At the command line, navigate to the /bin folder for the implementation. For example: /akana/ap82/bin.
  2. Type:
    startup.sh {containername}

There might be a short delay while the container starts.

To start a container in Unix (background)
  1. At the command line, navigate to the /bin folder for the implementation. For example: /akana/ap82/bin.
  2. Type:
    startup.sh {containername} -bg

There might be a short delay while the container starts.

back to top

Stopping a container

You can start a container in several ways; you can also stop a container in several ways.

To stop a container at a command prompt
  1. Go to the command prompt window where the process is running.
  2. Type Ctrl+C or close the command prompt.
To stop a container as a Windows service

Note: You can only start/stop a container as a Windows service if it was installed as a Windows service.

  1. Launch the Services list (Control Panel > Administrative Tools > Services).
  2. Select the instance name on the list.
  3. From the right-click Actions menu, choose Stop.
To stop a container in Unix
  1. Go to the command line window where the process is running.
  2. Send the process a KILL signal or type Ctrl+C.
To stop a container in Unix (background)
  1. At the command line, navigate to the /bin folder for the implementation. For example: /akana/ap82/bin.
  2. Type:
    shutdown.sh

back to top

Creating a container using silent install (Linux)

As part of Step 3, Step 3: Run Configurator to create the first container, in some scenarios such as Linux installations, you'll create the container using silent install.

Before you begin, make sure you have Administrator rights on the machine you’re using.

A silent installation is an automatic process that installs the Akana Platform without any user interaction. Before running the silent install, you must configure the properties file (installer.properties). For example, you must specify a target installation directory, install set, and input options to be executed at the end of the installation. Once you've configured the properties file, you can deploy the platform onto multiple computers in a scripted, non-interactive way.

One way to generate a properties file is to first perform a standard Akana Platform installation using the correct files for your installation. When platform installation is complete, the properties file is automatically saved in the directory from which you launched the setup file. The file includes the configuration settings you specified during setup; from here, you can customize further as needed.

You can also create the properties file from scratch. An example is shown below. For more details about the properties file, see Configure Container (Silent Option).

Properties file with placeholders:

//Required properties
container.instance.name={instancename}
credential.username = {username}
credential.password = {password}
default.host={hostname}
default.port={port}

//Optional properties
container.key={container_key_name}

Sample properties file with values:

container.instance.name=AAP82
credential.username = administrator
credential.password = password
default.host=rhe12345.akana.local
default.port=9945
container.key=AAP82

To run the properties file in a Linux environment, go to the {release_directory}/bin folder and run the following command:

startup.sh configurator -Dsilent=true -Dproperties={properties file path}/{filename}.properties

For example:

startup.sh configurator -Dsilent=true -Dproperties=properties/pm_silentinstall.properties

Then:

For full instructions, refer to: Configure Container (Silent Option).

Note: Silent install is not supported for Windows machines.

back to top

Unregistering and re-registering the Windows service

If you have a container registered as a Windows service so that the container will start automatically when Windows starts, and you want to unregister and re-register the Windows service, follow the steps below for each container.

Unregistering/re-registering the Windows service is generally part of upgrade procedure, but you might need to do this for some other reason.

If you’re not sure which containers are registered as a Windows service, you can check in the Windows Control Panel (Administrative Tools > Services). To change the services, you must run as Administrator.

To unregister and re-register the Windows service
  1. Open a command prompt in Administrator mode (If you don’t use Administrator mode, Windows prompts for Admin permission before unregistering/registering the service, but doesn’t actually start the service).
  2. Run the command below:
    .\sm70\bin\unregisterContainerServiceYAJWS.bat{instance_name}
  3. Register the new version as a Windows service:
    .\{plat82_foldername}\bin\registerContainerServiceYAJWS.bat {instance_name}

    If you’re running in Administrator mode, Windows registers the service and also starts it.

  4. Repeat steps 2 and 3 for each additional container that’s registered as a Windows service.

Note: The above filenames, unregisterContainerServiceYAJWS.bat and registerContainerServiceYAJWS.bat, are correct for product version 8.1.7 and later and version 8.2.2 and later. In earlier versions, up to 8.1.6 or 8.2.1, the filenames are unregisterContainerService.bat and registerContainerService.bat.

back to top

Linux install: exporting the JAVA_HOME variable

Because Linux containers don't have a JAVA_HOME environment variable set, you'll need to export the JAVA_HOME location to your installation directory.

For example:

export JAVA_HOME=/opt/akana/AP82/jre

If you omit this step, you'll get an error during the installation.

back to top

Version 8.4:

Version 8.2:

Version 8.0: