1. 数据库类型
– Oracle
– MySQL
– DB2
– SQL Server
– PostgreSQL

2. 数据源作用域
– Cell级别：整个Cell可用
– Node级别：单个Node可用
– Server级别：单个Server可用
– Cluster级别：集群可用

3. 连接池配置
– 最小连接数
– 最大连接数
– 超时设置
– 验证设置

4. 安全配置
– 认证方式
– 用户名密码
– SSL连接

# 数据源规划模板

数据源名称：jdbc/fgedudb
JNDI名称：jdbc/fgedudb
数据库类型：Oracle
数据库URL：jdbc:oracle:thin:@192.168.1.100:1521:fgedudb
作用域：Cell级别
最小连接数：10
最大连接数：50
认证方式：容器管理认证

1. 连接数规划
# 计算公式
最大连接数 = 并发用户数 × 每用户连接数 × 峰值系数

# 示例
并发用户数：100
每用户连接数：0.5（平均每个用户使用0.5个连接）
峰值系数：1.5
最大连接数 = 100 × 0.5 × 1.5 = 75

# 不同规模建议

小型应用（并发<50）： - 最小连接数：5 - 最大连接数：20 中型应用（并发50-200）： - 最小连接数：10 - 最大连接数：50 大型应用（并发>200）：
– 最小连接数：20
– 最大连接数：100

2. 超时规划
连接超时：180秒（等待获取连接）
空闲超时：1800秒（30分钟）
最大生命周期：0（不限制）或根据数据库设置

3. 验证规划
验证连接：启用
验证频率：每次使用前验证
验证SQL：SELECT 1 FROM DUAL（Oracle）

# 连接池监控指标

指标 正常范围 告警阈值
──────────────────────────────────────────
连接使用率 < 80% > 90%
等待线程数 < 5 > 10
连接获取时间 < 100ms > 500ms
连接泄漏 0 > 0

1. 容器管理认证
– WebSphere管理用户名密码
– 存储在J2C认证别名中
– 推荐方式

2. 组件管理认证
– 应用管理用户名密码
– 在应用中配置
– 不推荐

3. 无认证
– 不需要认证
– 适合测试环境

# J2C认证别名配置

1. 创建J2C认证别名
# 管理控制台
安全 > 全局安全 > Java认证和授权服务 > J2C认证数据

# wsadmin
/WebSphere/app/profiles/Dmgr01/bin/wsadmin.sh -lang jython \
-username fgeduadmin -password fgedu123

# 创建认证别名
security = AdminConfig.getid(‘/Security:/’)
alias = AdminConfig.create(‘JAASAuthData’, security,
‘[[alias fgeduDbAlias] [userId fgedu] [password fgedu123]]’)

AdminConfig.save()

2. 配置数据源使用认证别名
# 在数据源配置中指定组件管理的认证别名

# SSL连接配置
# 数据库URL添加SSL参数
jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=tcps)(HOST=192.168.1.100)(PORT=2484))(CONNECT_DATA=(SERVICE_NAME=fgedudb)))

# 定制属性
javax.net.ssl.trustStore=/WebSphere/ssl/truststore.jks
javax.net.ssl.trustStorePassword=changeit

1. 连接池指标
– 活动连接数
– 空闲连接数
– 等待线程数
– 连接使用率

2. 性能指标
– 连接获取时间
– 连接使用时间
– SQL执行时间

3. 错误指标
– 连接失败次数
– 连接泄漏次数
– SQL执行错误

# 监控方式

1. 管理控制台
资源 > JDBC > 数据源 > 监控

2. wsadmin
/WebSphere/app/profiles/Dmgr01/bin/wsadmin.sh -lang jython \
-c “print AdminControl.getAttribute(AdminControl.queryNames(‘type=DataSource,name=jdbc/fgedudb,*’), ‘stats’)”

3. PMI
启用数据源PMI统计

# 监控脚本
#!/bin/bash
# ds_monitor.sh
# from:www.itpux.com.qq113257174.wx:itpux-com
# web: http://www.fgedu.net.cn

DS_NAME=jdbc/fgedudb

echo “=== 数据源监控 ===”

# 连接池状态
echo “1. 连接池状态：”
/WebSphere/app/profiles/Dmgr01/bin/wsadmin.sh -lang jython \
-username fgeduadmin -password fgedu123 << EOF 2>/dev/null

ds = AdminControl.queryNames(‘type=DataSource,name=$DS_NAME,*’)
if ds:
pool = AdminControl.getAttribute(ds, ‘poolConfig’)
print “活动连接: ” + AdminControl.getAttribute(ds, ‘numActive’)
print “空闲连接: ” + AdminControl.getAttribute(ds, ‘numIdle’)
print “等待线程: ” + AdminControl.getAttribute(ds, ‘numWaiting’)
else:
print “数据源未找到”

EOF

echo “=== 监控完成 ===”

步骤：
1. 登录管理控制台
https://fgedu-dmgr.net.cn:9043/ibm/console

2. 导航到数据源
资源 > JDBC > 数据源

3. 选择作用域
选择Cell级别

4. 点击”新建”
– 数据源名称：fgedudb
– JNDI名称：jdbc/fgedudb
– 点击”下一步”

5. 选择JDBC提供者
– 选择现有提供者或创建新提供者
– 如果创建新提供者：
– 提供者名称：Oracle JDBC Driver
– 实现类：oracle.jdbc.OracleDriver
– 类路径：/WebSphere/drivers/oracle/ojdbc8.jar
– 点击”下一步”

6. 输入数据库属性
– 数据库URL：jdbc:oracle:thin:@192.168.1.100:1521:fgedudb
– 点击”下一步”

7. 配置安全别名
– 组件管理的认证别名：fgeduDbAlias
– 点击”下一步”

8. 完成创建
– 检查配置摘要
– 点击”完成”

9. 保存配置
– 点击”保存”

10. 测试连接
– 选择数据源
– 点击”测试连接”

# 连接wsadmin
/WebSphere/app/profiles/Dmgr01/bin/wsadmin.sh -lang jython \
-username fgeduadmin -password fgedu123

# 1. 创建JDBC提供者
provider = AdminJDBC.createJDBCProvider(‘[-scope Cell -databaseType Oracle -providerType “Oracle JDBC Driver” -implementationType “Connection pool data source” -name “Oracle JDBC Driver” -description “Oracle JDBC Driver” -classpath [/WebSphere/drivers/oracle/ojdbc8.jar]]’)

# 2. 创建J2C认证别名
security = AdminConfig.getid(‘/Security:/’)
alias = AdminConfig.create(‘JAASAuthData’, security,
‘[[alias fgeduDbAlias] [userId fgedu] [password fgedu123]]’)

# 3. 创建数据源
ds = AdminJDBC.createDataSource(‘[-scope Cell -providerName “Oracle JDBC Driver” -name fgedudb -jndiName jdbc/fgedudb -dataStoreHelperClassName com.ibm.websphere.rsadapter.Oracle11gDataStoreHelper -containerManagedPersistence true -componentManagedAuthenticationAlias fgeduDbAlias -configureResourceProperties [[databaseName fgedudb] [driverType 4] [serverName 192.168.1.100] [portNumber 1521]]]’)

# 4. 保存配置
AdminConfig.save()

# 5. 同步节点
AdminNodeManagement.syncActiveNodes()

# 6. 测试连接
AdminControl.testConnection(AdminConfig.getid(‘/DataSource:fgedudb/’))

# 完整创建脚本
#!/bin/bash
# create_datasource.sh
# from:www.itpux.com.qq113257174.wx:itpux-com
# web: http://www.fgedu.net.cn

DS_NAME=fgedudb
JNDI_NAME=jdbc/fgedudb
DB_URL=”jdbc:oracle:thin:@192.168.1.100:1521:fgedudb”
DB_USER=fgedu
DB_PASS=fgedu123

echo “创建数据源: $DS_NAME”

/WebSphere/app/profiles/Dmgr01/bin/wsadmin.sh -lang jython \
-username fgeduadmin -password fgedu123 << 'EOF' # 创建JDBC提供者 print "创建JDBC提供者..." provider = AdminJDBC.createJDBCProvider('[-scope Cell -databaseType Oracle -providerType "Oracle JDBC Driver" -implementationType "Connection pool data source" -name "Oracle JDBC Driver" -description "Oracle JDBC Driver" -classpath [/WebSphere/drivers/oracle/ojdbc8.jar]]') # 创建认证别名 print "创建认证别名..." security = AdminConfig.getid('/Security:/') alias = AdminConfig.create('JAASAuthData', security, '[[alias fgeduDbAlias] [userId fgedu] [password fgedu123]]') # 创建数据源 print "创建数据源..." ds = AdminJDBC.createDataSource('[-scope Cell -providerName "Oracle JDBC Driver" -name fgedudb -jndiName jdbc/fgedudb -dataStoreHelperClassName com.ibm.websphere.rsadapter.Oracle11gDataStoreHelper -containerManagedPersistence true -componentManagedAuthenticationAlias fgeduDbAlias -configureResourceProperties [[URL "jdbc:oracle:thin:@192.168.1.100:1521:fgedudb"]]]') # 保存配置 print "保存配置..." AdminConfig.save() # 同步节点 print "同步节点..." AdminNodeManagement.syncActiveNodes() # 测试连接 print "测试连接..." result = AdminControl.testConnection(AdminConfig.getid('/DataSource:fgedudb/')) print "测试结果: " + result EOF echo "数据源创建完成"

1. 通过管理控制台配置
资源 > JDBC > 数据源 > fgedudb > 连接池

配置项：
最小连接数：10
最大连接数：50
连接超时：180
空闲超时：1800
最大生命周期：0
reapTime：180
unusedTimeout：1800
agedTimeout：0
purgePolicy：EntirePool

2. 通过wsadmin配置
/WebSphere/app/profiles/Dmgr01/bin/wsadmin.sh -lang jython \
-username fgeduadmin -password fgedu123

# 获取数据源
ds = AdminConfig.getid(‘/DataSource:fgedudb/’)

# 获取连接池配置
pool = AdminConfig.list(‘ConnectionPool’, ds)

# 修改连接池参数
AdminConfig.modify(pool, ”’
[[minConnections 10]
[maxConnections 50]
[connectionTimeout 180]
[idleTimeout 1800]
[maxLifeTime 0]
[reapTime 180]
[unusedTimeout 1800]
[agedTimeout 0]
[purgePolicy EntirePool]]
”’)

# 保存配置
AdminConfig.save()

# 同步节点
AdminNodeManagement.syncActiveNodes()

# 验证配置
print AdminConfig.show(pool)

[agedTimeout 0]
[connectionTimeout 180]
[idleTimeout 1800]
[maxConnections 50]
[maxLifeTime 0]
[minConnections 10]
[purgePolicy EntirePool]
[reapTime 180]
[unusedTimeout 1800]

1. 配置验证
资源 > JDBC > 数据源 > fgedudb > 定制属性

验证属性：
testOnBorrow：true（借用时验证）
testOnReturn：false（归还时验证）
testWhileIdle：false（空闲时验证）
validationQuery：SELECT 1 FROM DUAL（验证SQL）

2. 通过wsadmin配置
/WebSphere/app/profiles/Dmgr01/bin/wsadmin.sh -lang jython \
-username fgeduadmin -password fgedu123

# 获取数据源
ds = AdminConfig.getid(‘/DataSource:fgedudb/’)

# 配置验证
AdminConfig.modify(ds, ”’
[[testOnBorrow true]
[validationQuery “SELECT 1 FROM DUAL”]]
”’)

# 添加定制属性
props = AdminConfig.list(‘PropertySet’, ds)
AdminConfig.create(‘ResourceProperty’, props,
‘[[name testOnBorrow] [type boolean] [value true]]’)
AdminConfig.create(‘ResourceProperty’, props,
‘[[name validationQuery] [type string] [value “SELECT 1 FROM DUAL”]]’)

# 保存配置
AdminConfig.save()

# 验证SQL配置
数据库类型 验证SQL
──────────────────────────────────────────
Oracle SELECT 1 FROM DUAL
MySQL SELECT 1
DB2 SELECT 1 FROM SYSIBM.SYSDUMMY1
SQL Server SELECT 1
PostgreSQL SELECT 1

1. 通过管理控制台测试
资源 > JDBC > 数据源 > 选择数据源 > 测试连接

成功输出：
“测试连接成功”

失败输出：
“测试连接失败: [错误信息]”

2. 通过wsadmin测试
/WebSphere/app/profiles/Dmgr01/bin/wsadmin.sh -lang jython \
-username fgeduadmin -password fgedu123 \
-c “AdminControl.testConnection(AdminConfig.getid(‘/DataSource:fgedudb/’))”

成功输出：
“连接成功”

失败输出：
“连接失败: [错误信息]”

3. 通过应用测试
# 创建测试JSP
cat > /WebSphere/app/profiles/AppSrv01/installedApps/fgeduCell01/fgeduapp.ear/fgeduweb.war/test.jsp << 'EOF' <%@ page import="javax.naming.*,javax.sql.*,java.sql.*" %>
<% try { Context ctx = new InitialContext(); DataSource ds = (DataSource) ctx.lookup("jdbc/fgedudb"); Connection conn = ds.getConnection(); Statement stmt = conn.createStatement(); ResultSet rs = stmt.executeQuery("SELECT 1 FROM DUAL"); while (rs.next()) { out.println("连接成功: " + rs.getString(1)); } rs.close(); stmt.close(); conn.close(); } catch (Exception e) { out.println("连接失败: " + e.getMessage()); } %>
EOF

# 访问测试页面
curl http://localhost:9080/fgeduapp/test.jsp

连接成功: 1

# 常见测试失败原因

错误信息 原因 解决方案
─────────────────────────────────────────────────────────────────────
ClassNotFoundException 驱动类找不到 检查驱动路径
IoException: Connection refused 数据库连接失败 检查数据库状态和端口
ORA-01017: invalid credentials 认证失败 检查用户名密码
ORA-12514: TNS:listener 服务名错误 检查服务名配置

故障现象：
应用报错：Connection not available

故障诊断：
1. 检查连接池状态
/WebSphere/app/profiles/Dmgr01/bin/wsadmin.sh -lang jython \
-username fgeduadmin -password fgedu123 << EOF ds = AdminControl.queryNames('type=DataSource,name=jdbc/fgedudb,*') if ds: print "活动连接: " + AdminControl.getAttribute(ds, 'numActive') print "空闲连接: " + AdminControl.getAttribute(ds, 'numIdle') print "最大连接: " + AdminControl.getAttribute(ds, 'maxConnections') print "等待线程: " + AdminControl.getAttribute(ds, 'numWaiting') EOF 活动连接: 50 空闲连接: 0 最大连接: 50 等待线程: 10 2. 分析原因 - 连接未释放（连接泄漏） - 连接池太小 - 数据库响应慢 解决方案： 1. 检查连接泄漏 # 查看应用日志 grep -i "connection" /WebSphere/app/profiles/AppSrv01/logs/server1/SystemOut.log # 启用连接泄漏检测 AdminConfig.modify(ds, '[[connectionLeakDetectionEnabled true]]') 2. 增加连接池大小 pool = AdminConfig.list('ConnectionPool', ds) AdminConfig.modify(pool, '[[maxConnections 100]]') 3. 优化数据库 # 检查数据库慢查询 # 优化SQL语句 # 增加数据库资源 # 预防措施 1. 应用正确关闭连接 try { conn = ds.getConnection(); // 使用连接 } finally { if (conn != null) conn.close(); } 2. 使用连接池监控 3. 设置合理的连接池参数

故障现象：
应用报错：Connection timed out

故障诊断：
1. 检查数据库连接
sqlplus fgedu/fgedu123@192.168.1.100:1521/fgedudb

SQL*Plus: Release 19.0.0.0.0 – Production
Connected to:
Oracle Database 19c Enterprise Edition

2. 检查网络
ping 192.168.1.100
telnet 192.168.1.100 1521

3. 检查防火墙
iptables -L -n | grep 1521

解决方案：
1. 检查数据库状态
# 确保数据库服务正常运行
lsnrctl status

2. 检查网络连通性
# 确保网络正常
traceroute 192.168.1.100

3. 检查防火墙规则
# 开放数据库端口
iptables -I INPUT -p tcp –dport 1521 -j ACCEPT

4. 增加连接超时时间
pool = AdminConfig.list(‘ConnectionPool’, ds)
AdminConfig.modify(pool, ‘[[connectionTimeout 300]]’)

# 数据库连接超时配置
Oracle URL格式：
jdbc:oracle:thin:@(DESCRIPTION=(CONNECT_TIMEOUT=10)(TRANSPORT_CONNECT_TIMEOUT=3)(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.1.100)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=fgedudb)))

MySQL URL格式：
jdbc:mysql://192.168.1.100:3306/fgedudb?connectTimeout=10000&socketTimeout=30000