1. 系统要求

至少 3GHz CPU
至少 4GB 内存 （2GB给WSO2,2GB给操作系统）
至少 10GB 磁盘

JDK1.8_x64, 其中JDK1.8.0_151版本存在已知的GZIP decoding问题,不建议使用

内置H2数据库可以用于开发测试，生成环境建议用企业级数据库，支持Oracle, PostgreSQL, MySQL, MS SQL, etc

支持LDAP进行用户管理

生成环境建议使用最新版RedHat Enterprise Linux 或者Ubuntu Server LTS

2. 安装

下载地址：https://wso2.com/api-management

1. linux

1. 下载并解压apim
2. 安装jdk1.8-x64, 并配置JAVA_HOME环境变量

2.windows安装

1. 下载并解压apim
2. 下载 snappy-java_1.1.1.7.jar放到repository\components\lib目录下
3. 安装jdk1.8-x64, 并配置JAVA_HOME环境变量

3. 运行

1. 启动

定位到<PRODUCT_HOME>\bin\目录
window上运行：wso2server.bat --run
linux前台运行：sh wso2server.sh
linux后台运行：sh wso2server.sh start
linux后台停止：sh wso2server.sh stop

2. 管理控制台

浏览器访问地址：https://localhost:9443/carbon
默认登录账号密码：admin/admin
默认15分钟超期，可以在<PRODUCT_HOME>/repository/conf/tomcat/carbon/WEB-INF/web.xml修改默认配置

<session-config><session-timeout>15</session-timeout> </session-config> 

3.API Publisher

浏览器访问：https://<Server Host>:9443/publisher

4.API Store

浏览器访问：https://<Server Host>:9443/store

5.访问IP限制

参考：https://docs.wso2.com/display/AM250/Running+the+Product

6.添加互访链接

默认情况下API Publisher上没有直接跳转到API Store的链接，可以通过以下方式添加，打开/repository/conf/api-manager.xml配

<APIStore> <DisplayURL>true</DisplayURL> <URL>https://<hostname>:9443/store</URL> </APIStore> 

7.修改默认密码

打开文件<PRODUCT_HOME>/repository/conf/user-mgt.xml，修改如下内容：

<Realm><Configuration><AddAdmin>true</AddAdmin> <AdminRole>admin</AdminRole> <AdminUser> <UserName>admin</UserName> <Password>admin</Password> </AdminUser> <EveryOneRoleName>everyone</EveryOneRoleName> <!-- By default users in this role see the registry root --> <Property name=""></Property> ............... </Configuration> ... </Realm> 

4. 汉化

1.汉化文件位置：

服务端输出字符串汉化文件位置：/repository/deployment/server/jaggeryapps/publisher/site/conf/locales/jaggery

客户端输出字符串汉化文件位置：/repository/deployment/server/jaggeryapps/publisher/site/conf/locales/js

2.汉化方法

以服务端输出汉化为例：

1. 复制locale_default.json文件并重名为locale_zh.json
2. 使用文本编辑器修改文件中每一段，将冒号后面的英文翻译为对应的中文，保存文件

5. 使用Oracle数据库

1. 单机Oracle

1. 创建一个Oracle数据库
2. 使用下列语句添加Oracle用户

Create user <USER_NAME> identified by password account unlock; grant connect to <USER_NAME>; grant create session, create table, create sequence, create trigger to <USER_NAME>; alter user <USER_NAME> quota <SPACE_QUOTA_SIZE_IN_MEGABYTES> on '<TABLE_SPACE_NAME>'; commit; 

1. 把ojdbc驱动（例如ojdbc14.jar）放入<PRODUCT_HOME>/repository/components/lib/目录下
2. 修改DataSource配置，链接到Oracle数据库中，配置文件位置：<PRODUCT_HOME>/repository/conf/datasources/master-datasources.xml，参考下列方式修改

<datasource><name>WSO2_CARBON_DB</name> <description>The datasource used for registry and user manager</description> <jndiConfig> <name>jdbc/WSO2CarbonDB</name> </jndiConfig> <definition type="RDBMS"> <configuration> <url>jdbc:oracle:thin:@SERVER_NAME:PORT/SID</url> <username>regadmin</username> <password>regadmin</password> <driverClassName>oracle.jdbc.OracleDriver</driverClassName> <maxActive>80</maxActive> <maxWait>60000</maxWait> <minIdle>5</minIdle> <testOnBorrow>true</testOnBorrow> <validationQuery>SELECT 1 FROM DUAL</validationQuery> <validationInterval>30000</validationInterval> <defaultAutoCommit>false</defaultAutoCommit> </configuration> </definition> </datasource> 

1. 登录oracle执行sql语句初始化数据库，sql文件位置<PRODUCT_HOME>/dbscripts/oracle.sql

2. Oracle RAC

1. 创建一个Oracle数据库
2. 使用下列语句添加Oracle用户

Create user <USER_NAME> identified by password account unlock; grant connect to <USER_NAME>; grant create session, create table, create sequence, create trigger to <USER_NAME>; alter user <USER_NAME> quota <SPACE_QUOTA_SIZE_IN_MEGABYTES> on '<TABLE_SPACE_NAME>'; commit; 

1. 把ojdbc驱动（例如ojdbc14.jar）放入<PRODUCT_HOME>/repository/components/lib/目录下
2. 修改DataSource配置，链接到Oracle数据库中，配置文件位置：<PRODUCT_HOME>/repository/conf/datasources/master-datasources.xml，参考下列方式修改

<datasource><name>WSO2_CARBON_DB</name> <description>The datasource used for registry and user manager</description> <jndiConfig> <name>jdbc/WSO2CarbonDB</name> </jndiConfig> <definition type="RDBMS"> <configuration> <url>jdbc:oracle:thin:@(DESCRIPTION=(LOAD_BALANCE=on) (ADDRESS=(PROTOCOL=TCP)(HOST=racnode1) (PORT=1521)) (ADDRESS=(PROTOCOL=TCP)(HOST=racnode2) (PORT=1521)) (CONNECT_DATA=(SERVICE_NAME=rac)))</url> <username>regadmin</username> <password>regadmin</password> <driverClassName>oracle.jdbc.driver.OracleDriver</driverClassName> <maxActive>80</maxActive> <maxWait>60000</maxWait> <minIdle>5</minIdle> <testOnBorrow>true</testOnBorrow> <validationQuery>SELECT 1 FROM DUAL</validationQuery> <validationInterval>30000</validationInterval> <defaultAutoCommit>false</defaultAutoCommit> </configuration> </definition> </datasource> 

1. 登录oracle执行sql语句初始化数据库，sql文件位置<PRODUCT_HOME>/dbscripts/oracle.sql

3. 修改数据库的完整配置过程

apim涉及以下多个数据源，全部都需要按照上述方式修改

• WSO2AM_DB: For API-M-specific data.
• WSO2MB_DB: For message brokering data.
• WSO2METRICS_DB: For storing data for Metrics monitoring.
• WSO2AM_STATS_DB：For the Analytics database

具体参考： https://docs.wso2.com/display/AM250/Changing+the+Default+API-M+Databases

下一篇：WSO2 Api Manager 集成 Analytics