Keycloak 无法启动¶
常见故障¶
故障表现¶
MySQL 已就绪，无报错。在安装全局管理后 keycloak 无法启动（> 10 次）。
检查项¶
- 如果数据库是 MySQL，检查 keycloak database 编码是否是 UTF8。
- 检查从 keycloak 到数据库的网络，检查数据库资源是否充足，包括但不限于资源限制、存储空间、物理机资源。
解决步骤¶
- 检查 MySQL 资源占用是否到达 limit 限制
- 检查 MySQL 中 database keycloak table 的数量是不是 95 （Keycloak 不同版本数据库数量可能会不一样，可以与同版本的开发或测试环境的 Keycloak 数据库数量进行比较）， 如数量少了，则说明数据库表初始化有问题（查询表数量命令提示为：show tables;）
- 删除 keycloak database 并创建，提示 CREATE DATABASE IF NOT EXISTS keycloak CHARACTER SET utf8
- 重启 Keycloak Pod 解决问题
CPU does not support ×86-64-v2¶
故障表现¶
keycloak 无法正常启动，keycloak pod 运行状态为 CrashLoopBackOff 并且 keycloak 的 log 出现如下图所示的信息
检查项¶
运行下面的检查脚本，查询当前节点 cpu 的 x86-64架构的特征级别
cat <<"EOF" > detect-cpu.sh
#!/bin/sh -eu
flags=$(cat /proc/cpuinfo | grep flags | head -n 1 | cut -d: -f2)
supports_v2='awk "/cx16/&&/lahf/&&/popcnt/&&/sse4_1/&&/sse4_2/&&/ssse3/ {found=1} END {exit !found}"'
supports_v3='awk "/avx/&&/avx2/&&/bmi1/&&/bmi2/&&/f16c/&&/fma/&&/abm/&&/movbe/&&/xsave/ {found=1} END {exit !found}"'
supports_v4='awk "/avx512f/&&/avx512bw/&&/avx512cd/&&/avx512dq/&&/avx512vl/ {found=1} END {exit !found}"'
echo "$flags" | eval $supports_v2 || exit 2 && echo "CPU supports x86-64-v2"
echo "$flags" | eval $supports_v3 || exit 3 && echo "CPU supports x86-64-v3"
echo "$flags" | eval $supports_v4 || exit 4 && echo "CPU supports x86-64-v4"
EOF
chmod +x detect-cpu.sh
sh detect-cpu.sh
执行下面命令查看当前 cpu 的特性，如果输出中包含 sse4_2，则表示你的处理器支持SSE 4.2。
解决方法¶
需要升级你的云主机或物理机 CPU 以支持 x86-64-v2 及以上，确保x86 CPU 指令集支持 sse4.2，如何升级需要你咨询云主机平台提供商或着物理机提供商。