WSO2 API Manager安装部署配置

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

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

2.windows安装

下载并解压apim
下载 snappy-java_1.1.1.7.jar放到repository\components\lib目录下
安装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.汉化方法

以服务端输出汉化为例：

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

5. 使用Oracle数据库

1. 单机Oracle

创建一个Oracle数据库
使用下列语句添加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;

把ojdbc驱动（例如ojdbc14.jar）放入<PRODUCT_HOME>/repository/components/lib/目录下
修改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>

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

2. Oracle RAC

创建一个Oracle数据库
使用下列语句添加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;

把ojdbc驱动（例如ojdbc14.jar）放入<PRODUCT_HOME>/repository/components/lib/目录下
修改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>

登录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

posted @ 2018-09-05 15:40 kuntaljy 阅读(4672) 评论(0) 编辑收藏举报

会员力量，点亮园子希望

刷新页面返回顶部