Install on VM¶
Follow the instructions below to install the WSO2 API Microgateway related binary distributions, namely WSO2 Microgateway Toolkit and WSO2 Microgateway Runtime.
Microgateway Toolkit¶
-
Download the WSO2 API Microgateway toolkit distribution.
-
Extract the archive file to a dedicated directory for the WSO2 API Microgateway Toolkit, which will hereafter be referred to as
<MGW-TK_HOME>
. -
Append the full path of the
/bin
directory of the extracted WSO2 API Microgateway toolkit distribution to the PATH environment variable. This allows you to run the WSO2 API Microgateway toolkit related commands from any directory location.Click here for more instructions on configure path variable in your OS.
Setup toolkit path in Linux/MacOS- Execute the following in your terminal.
export PATH=$PATH:<extracted_toolkit_location>/bin
Setup toolkit path in Windows
Use one of the following approaches to define the paths.
-
Set the Microgateway toolkit distribution path using the following command in the terminal.
setx "%path%;<extracted_toolkit_location>/bin"
-
Set the Microgateway toolkit distribution path using the UI in Windows.
Note
The steps involved in setting the environment variables may vary based on the version of your Windows OS.
-
Copy the path to the Microgateway Toolkit
bin
directory (<path-to-wso2am-micro-gw-toolkit>\bin
). -
Click Edit the system preferences.
-
Navigate to the Advanced tab and click Environment Variables.
-
Navigate to the path system variable and click Edit.
-
Click New, add the path of the Microgateway Toolkit
bin
directory that you copied previously and click OK three times to save the newly added system variable.
4. Optionally, configure WSO2 API Microgateway Toolkit with WSO2 API Manager 3.2.0.
-
Microgateway Runtime¶
-
Ensure that your system meets the following basic prerequisites.
Memory 256MB Cores 2 OS Any -
Download the WSO2 API Microgateway distribution based on your OS and extract it.
-
Extract the archive file to a dedicated directory for the WSO2 API Microgateway Runtime, which will hereafter be referred to as
<MGW_HOME>
. -
Append the full path of the
/bin
directory of the extracted WSO2 API Microgateway distribution to the PATH environment variable. This allows you to run the WSO2 API Microgateway distribution-related commands from any directory location.Click here for more instructions on configure path variable in your OS.
Setup runtime path in Linux/MacOSexport PATH=$PATH:<extracted_distribution_location>/bin
Setup runtime path in Windows
Use one of the following approaches to define the paths.
-
Set the Microgateway toolkit distribution path using the following command in the terminal.
setx "%path%;<extracted_distribution_location>/bin"
-
Set the Microgateway runtime distribution path using the UI in Windows.
- Optionally, configure WSO2 API Microgateway Runtime with WSO2 API Manager 3.2.0 .
-