Ubuntu 22.04下OpenAM7与MySQL连接配置问题及步骤咨询

前置准备 #

• 更新系统并安装依赖：

  sudo apt update && sudo apt upgrade -y
  

• 安装并启动MySQL 8.0：

  sudo apt install mysql-server -y
  sudo systemctl start mysql
  sudo systemctl enable mysql
  

• 下载mysql-connector-java-8.0.x.jar（版本需与MySQL匹配），将其复制到OpenAM的类路径目录，示例路径：

  sudo cp mysql-connector-java-8.0.30.jar /path/to/openam/webapps/openam/WEB-INF/lib/
  

  注意：替换/path/to/openam为你的OpenAM实际安装路径，替换jar包版本号为对应下载版本。

MySQL 端配置 #

1. 登录MySQL控制台：

   sudo mysql -u root -p
   

2. 创建OpenAM专用数据库：

   CREATE DATABASE openam_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
   

3. 创建专用数据库用户并授权：

   CREATE USER 'openam_user'@'localhost' IDENTIFIED BY 'your_strong_password';
   GRANT ALL PRIVILEGES ON openam_db.* TO 'openam_user'@'localhost';
   FLUSH PRIVILEGES;
   

   替换your_strong_password为安全密码。

4. 调整用户认证方式（适配OpenAM兼容性）：

   ALTER USER 'openam_user'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_strong_password';
   FLUSH PRIVILEGES;
   

5. 退出MySQL：

   EXIT;
   

OpenAM 端配置 #

方式1：初始化向导配置（新安装OpenAM） #

1. 启动OpenAM服务：

   sudo systemctl start openam
   

2. 访问初始化页面：http://your-server-ip:8080/openam（替换为你的服务器IP/域名）
3. 进入Data Store Configuration步骤，选择JDBC Data Store
4. 填写连接参数：
   • JDBC Driver Class Name：com.mysql.cj.jdbc.Driver
   • JDBC URL：jdbc:mysql://localhost:3306/openam_db?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true

     若使用国内时区，可将UTC改为Asia/Shanghai

   • Database User Name：openam_user
   • Database User Password：your_strong_password
5. 点击Test Connection验证连接，成功后继续完成初始化向导。

方式2：已有OpenAM实例修改配置 #

1. 登录OpenAM管理控制台
2. 进入Configure > Data Stores，点击New Data Store
3. 选择JDBC Data Store类型，填写上述连接参数并测试连接
4. 设置该JDBC数据存储为默认存储，保存配置后重启OpenAM服务：

   sudo systemctl restart openam
   

连接验证 #

• 创建测试用户，检查是否成功写入openam_db数据库
• 查看OpenAM调试日志排查问题：

  cat /path/to/openam/var/log/debug
  

常见问题排查 #

• 驱动未生效：确认jar包已放入正确目录，重启OpenAM服务
• 连接超时/拒绝：检查MySQL服务是否运行，防火墙是否放行3306端口
• 认证失败：确认MySQL用户名、密码正确，且用户已授权本地访问
• 时区错误：确保JDBC URL中指定了serverTimezone参数

内容的提问来源于stack exchange，提问作者Razeena