Installing Configuration Studio

Overview

Configuration Studio is a graphical tool that enables administrators to configure environment-specific properties to deploy APIs and policies in non-development environments. For more details, see the API Gateway Deployment and Promotion Guide. This topic describes how to install Configuration Studio on the following platforms:

  • Windows

  • Linux

  • Solaris

Prerequisites

You must ensure the following:

System Requirements

See the System Requirements to ensure that the target machine is of a suitable specification.

Executable Permission

On Linux/UNIX, you must ensure that the installation executable has the appropriate permissions in your environment. For example, you can use the chmod command to update the file permissions.

Patching Configuration Studio 11.1.2.2.0

To patch your existing Configuration Studio installation, perform the following steps:

  1. Back up your existing API Gateway 11.1.2.2.0 installation.

  2. Delete your exsiting Configuration Studio installation directory (for example, INSTALL_DIR\configurationstudio).

  3. Use the API Gateway 11.1.2.2.0 installation executable to install Configuration Studio into the same directory.

Installing Configuration Studio 11.1.2.2.0

Use the API Gateway 11.1.2.2.0 installation executable to install a new Configuration Studio installation. When you run the executable in default GUI mode, you are presented with an introductory welcome screen. Click Next to continue with the installation.

For details on installing on the command line, see the section called “Unattended Installation”.

Installation Location

Enter or click Browse to specify the directory where you wish to install API Gateway components, for example:

Windows C:\OAG-11.1.2.2.0
Linux/UNIX /opt/OAG-11.1.2.2.0


Click Next to continue.

Select Components

Ensure that the Configuration Studio component is selected in the list, and click Next to continue.

This topic describes how to install the Configuration Studio component only. For details on installing other components, see the following topics:

Ready to Install

The installer is ready to start installing the selected components and settings on your system.

Click Next to continue.

Installing

A progress screen is displayed showing the progress of the installation. Please wait for the installation to complete.

Click Next to continue.

Completing the Configuration Studio Setup

When the installer has finished installing the selected components, click Finish to complete the installation.

Starting Configuration Studio

To launch Configuration Studio after installation, perform the following steps:

  1. Open a command prompt.

  2. Change to your Configuration Studio installation directory (for example, INSTALL_DIR\configurationstudio).

  3. Start configurationstudio.

For more details on Configuration Studio, see the API Gateway Deployment and Promotion Guide.

Unattended Installation

You can run the API Gateway installer in unattended mode on the command line. The following command shows an example of installing the Configuration Studio component only:

Windows

OAG-11.1.2.2.0-windows-installer.exe --mode unattended 
   --enable-components apigatewayexplorer 
   --disable-components analytics,nodemanager,policystudio,configurationstudio,apimgmt

Linux

./OAG-11.1.2.2.0-linux-installer.run --mode unattended 
   --enable-components apigatewayexplorer 
   --disable-components analytics,nodemanager,policystudio,configurationstudio,apimgmt

The specified components are installed in the background.

Further Information

For a description of all available command options and default settings, enter the --help option. This outputs the help text in a separate console.