Configuring a Standalone Container

Learn how to configure a Standalone Container using GUI or Silent methods.

Using the Admin Console Managing Containers

Table of Contents

  1. Introduction
  2. Step 1: Prerequisites
  3. Step 2a: Configure Container (GUI Option)
  4. Step 2b: Configure Container (Silent Option)
  5. Step 3: Install Features

Introduction

The Configure Container Instance Wizard is used to define an OSGi container. This container type can support multiple features. GUI and Silent installation methods are provided.

Step 1: Prerequisites

  • Installation of one of the supported platform versions.

Step 2a: Configure Container (GUI Option)

  1. Launch the Configure Container Instance Wizard. Navigate to the Platform release directory c:\{release directory}\bin and enter one of the following:

    For Windows:

    startup.bat configurator

    For Unix:

    startup.sh configurator
  2. Define the container (ND1) and Default Admin User.
  3. On the Default HTTP Listener screen, set the default HTTP Port and Host IP Address for this instance. The listener configuration will be used as the Administration Console address.
    • Port—Represents the default HTTP Port.
    • Bind to all interfaces—The listener binds to the 0.0.0.0 address. localhost or any other valid IP for the machine can be used to connect to the client/browser.
    • Bind to a specific interface—The selected host name is used to connect to the client/browser.

    The Default HTTP Listener information is used to compose the Administration Console URL as follows:

    http://{hostname}:{port}/admin/

    Note: The trailing forward slash is required in the Admin Console URL (admin/).

  4. After the container has successfully started, launch the Administration Console using the following URL format:
    http://{computer name}:{port}/ContextPath/admin/

    Example:

    http://localhost:9900/nd1/admin/login.html
  5. After the Administration Console launches, navigate to the Available Features tab to install desired features, plug-ins, or tools.

    For more information, see Using the Administration Console.

back to top

Step 2b: Configure Container (Silent Option)

The Configure Container Instance Wizard can be set up to run in an automated mode (silent mode). This is done by defining a properties file and pre-defining a set of property values to be used by the wizard to automatically configure a container instance.

  1. Define a properties file (for example, myprops.properties)
  2. Add the following default content:
    container.instance.name=instancename
    credential.username = administrator
    credential.password = password
    default.host=localhost
    default.port=9900

    For more information on the base properties, see Base Properties below.

  3. Run the silent configuration. The silent configuration file accepts three system properties which together are used to perform a silent configuration:
    • silent—If True, silent configuration will be performed
    • deploymentName—Standalone
    • properties—location on filesystem of property file to be used for configuration
  4. Windows and UNIX script examples:

    Windows:

    \{release_directory}\bin>startup.bat configurator "-D silent=true" "-D properties =C:/{property file directory location}/myprops.properties"

    UNIX

    \{release_directory}\bin>startup.sh configurator -Dsilent=true -Dproperties=/export/home/username/{property file directory location}\myprops.properties

Base Properties

The following properties are used for Standalone deployments:

  • container.instance.name—Name of the Container.
  • credential.username—Username for logging into the Administration Console.
  • credential.password—Password for logging into the Administration Console.
  • default.host—Host for the Container Instance.
  • default.port—Port for the Container Instance.

back to top

Step 3: Install Features

  1. After the container has successfully started, launch the Administration Console using the following URL format:
    http://{computer name}:{port}/admin/

    Example:

    http://localhost:9900/admin/login.html
  2. After the Administration Console launches, navigate to the Available Features tab to install desired features, plug-ins, or tools.

    For more information, see Using the Administration Console.

back to top