WebLogic 14.1.2.0 是 14c 系列的最新长期支持版本我拿到这个版本后第一时间就在 Linux 上安装了。折腾图形化界面安装时发现网上很多教程还停留在旧版本的老套路要么直接甩一串静默命令要么压根没讲清楚图形界面起不来是怎么回事。这篇就把我实际走通的流程、中间踩过的坑、以及每条命令背后为什么这么写完整梳理一遍。这篇内容适合谁看两类人最合适一是刚接触 WebLogic、想通过图形界面把安装流程和目录结构彻底看明白的新手二是在无桌面服务器上想远程做图形化安装、但又不想靠静默模式黑盒操作的老手。全程按 14.1.2.0 版本的实际行为来写环境是 LinuxCentOS/RHEL 系为主方法论同样适用于其他发行版。1. 安装方案选型为什么推荐图形化界面1.1 三条安装路线如何选WebLogic 在 Linux 上安装方式大致分三种命令行交互式、图形化界面OUI、静默模式。命令行交互式其实很少用因为既然能出文本界面不如直接上图形化静默模式适合批量部署写 response 文件然后扔一条 java -jar 命令就能跑但它是黑盒日志出现问题后排查成本高。我自己更推荐图形化界面理由很直接OUI 会实时做前置检查比如 JDK 版本、磁盘空间、临时目录权限任何一项有问题会在界面直接标红提示肉眼看得见、改起来快。静默安装一旦失败只能翻 log有时折腾半天发现就是 /tmp 空间不够这类事我见过太多次了。对于单人维护、还在摸索阶段的环境图形化界面能让你对 WebLogic 的安装结构有完整的体感认知。1.2 14.1.2.0 版本对环境有哪些硬性要求先说版本号。14.1.2.0 对应的是 WebLogic Server 14.1.2属于 14c 代际官方要求必须搭配 JDK 17 使用JDK 8 和 JDK 11 在这个版本上都不行。这一点和旧的 12c、14.1.1 差别很大旧教程里很多人写“装个 JDK 8 就行”直接照搬必然翻车。内存建议至少 4GB图形化安装器本身是 Java 进程加上系统桌面或远程显示环境2GB 会卡到怀疑人生。磁盘空间安装包解压加实际安装预留 3GB 以上比较稳妥。操作系统方面 64 位是硬性要求CentOS 7/8/9、RHEL 7/8/9、Oracle Linux 都支持国内常见的基于 Linux 的发行版核心逻辑也一样只是个别依赖包名不同。需要提前准备的物料fmw_14.1.2.0.0_wls_lite_generic.jar 安装包、JDK 17Oracle JDK 或 OpenJDK 都行建议 OpenJDK 省事、一个非 root 的普通用户。注意官方明确不建议用 root 装 WebLogic 跑应用生产环境尤其要避免。提示下载安装包时需要 Oracle 账号界面语言默认跟随系统 locale如果服务器是中文环境又缺中文字体界面可能乱码推荐统一用 en_US.UTF-8 环境跑安装器后面会讲具体做法。2. 图形化显示环境搭建本地/远程两种典型方式2.1 坐在服务器前本机图形界面直装如果服务器装了桌面环境GNOME/KDE 等事情最简单直接开终端切到非 root 用户export DISPLAY:0 然后 java -jar 启动安装器界面就出现在桌面上了。问题在于生产服务器几乎没有装桌面环境的所以我遇到最多的情况其实是下面两种远程方案。2.2 远程操作SSH X11 转发X11 转发的本质安装器的图形界面运行在服务器上但窗口显示在你本地电脑屏幕上。服务器只需要有 X 相关的库通常带 xorg-x11-xauth 就行不需要完整桌面这样最轻量。服务器端操作# 检查 X11Forwarding 是否开启 grep -i x11forwarding /etc/ssh/sshd_config # 没有输出或为 no 时改成 yes 并重启 sshd sudo sed -i s/#X11Forwarding no/X11Forwarding yes/ /etc/ssh/sshd_config sudo systemctl restart sshd本地端登录时带上 -X 参数ssh -X weblogic192.168.1.100登录后测试一下 DISPLAY 是否正常echo $DISPLAY # 能看到 localhost:10.0 之类才算转发成功如果输出为空手动指定也行export DISPLAYlocalhost:10.0有一个常用测试工具 xclock能弹出小钟表窗口就说明 X11 转发链路完全通畅。这步很关键我一般会先跑一下确认无误再启动安装器。2.3 远程操作VNC 桌面X11 转发虽然轻量但网络不好的时候画面会卡而且有的公司对 SSH 端口转发有限制这时候就用 VNC 搭一个远程桌面。VNC 的思路是在服务器上跑一个虚拟桌面本地用一个 VNC 客户端连上去操作。服务器上安装并启动sudo yum install -y tigervnc-server # 切换为安装 WebLogic 的用户然后设置 VNC 密码 su - weblogic vncpasswd # 启动第一个桌面:1 表示端口 5901 vncserver :1 -geometry 1280x800启动后用本地 VNC 客户端连接 服务器IP:5901输入密码就进入一个简易桌面。如果连接后只有桌面壁纸、没有窗口管理器还得补装一个轻量桌面比如 xfce并配置 ~/.vnc/xstartup 启动它。这点最容易遗漏配好了才是真正能显示安装窗口的完整环境。VNC 的优势是会话可以保持即使本地断线重连服务器上的桌面和安装进程都还在特别适合安装到一半掉线的场景。2.4 安装前的环境变量与系统检查无论用哪种显示方案进入图形环境前统一做这几件事whoami # 确保不是 root java -version # 确认默认 java 是 17 echo $JAVA_HOME # 必须输出 JDK 17 的路径 free -h df -h /tmp$JAVA_HOME 为空或者指向旧 JDK 时OUI 会直接无法启动。如果系统装了多个 JDK用 update-alternatives --config java 切换或者干脆显式指定export JAVA_HOME/usr/lib/jvm/java-17-openjdk export PATH$JAVA_HOME/bin:$PATH注意安装包路径不要放在中文目录或带空格的路径下否则 Java 启动器解析路径可能出问题。我习惯放在 /home/weblogic/install/ 这种纯英文无空格的路径下。3. 图形化安装全过程逐步拆解3.1 启动安装向导前必做的几项检查安装包是一个 generic jar 文件不是 .bin也不是 .rpm这是很多人一开始不习惯的地方。启动命令很简单java -jar fmw_14.1.2.0.0_wls_lite_generic.jar但执行前我强烈建议确认两点。第一/tmp 可用空间至少 1GB因为 Java 安装器会在 /tmp 下面解压临时文件空间不足会卡在初始化阶段报错信息还很模糊。第二确认你是在能显示图形界面的会话里执行远程 SSH 没开 X11 转发、DISPLAY 变量没设置的话报错是 “Unable to instantiate GUI, defaulting to console mode”。初次执行时如果看到这个提示说明图形会话没起来等于白白降级成命令行模式。建议先跑一个小小的显示测试xclock如果 xclock 能弹窗安装器就一定能弹窗。3.2 跟着界面走从欢迎页到安装完成启动成功后安装向导按顺序走我每个界面补充一下实际选什么、为什么欢迎页没得选点 Next。自动更新页强烈建议选 “Skip Software Updates”。这步会连 Oracle 官网做更新检查没有外网环境会卡很久即使有外网下载更新包也很拖时间。安装位置默认是 /home/weblogic/Oracle/Middleware建议保持默认或者改成 /opt/oracle/middleware。目录不要带中文和空格。安装类型两个选项Typical Installation 和 Custom Installation。Typical 会装 WebLogic Server 核心组件和管理控制台80% 场景够用。Custom 可以勾选 Coherence、JMS 等附加组件不确定就别折腾保持 Typical。JDK 选择这一步界面上会把系统检测到的 JDK 列出来。必须确认选择的是 JDK 17路径通常在 /usr/lib/jvm/java-17-openjdk。如果这里什么都检测不到返回去检查 JAVA_HOME。安装概要列出将要安装的组件和总大小确认后点 Install。进度条开始走显示 “Installing WebLogic Server 14.1.2.0.0”这一步会写大量文件等 3 到 5 分钟正常卡太久就要怀疑磁盘 IO 或 /tmp 占满。完成页会出现 “Installation Complete” 页面可以勾选 “Run QuickStart” 也可以不勾最后点 Finish。3.3 安装目录与 JDK 选择背后的逻辑为什么默认路径是 home 下而非 /opt因为 WebLogic 需要当前用户对安装目录拥有完整写权限而安装用户是我们自己创建的普通用户home 目录天然满足这个条件这也是官方推荐非 root 安装的原因之一。JDK 选择这一步则要注意一个隐蔽问题安装器检测到的 JDK 列表来自 JAVA_HOME 和 PATH 里扫描到的版本但即使默认选对了安装完以后 WebLogic 启动脚本也会通过 JAVA_HOME 找 JDK。所以安装前设置的 JAVA_HOME 一定要写到用户环境文件里否则装完会出现“安装成功但启动不了”的尴尬。echo export JAVA_HOME/usr/lib/jvm/java-17-openjdk ~/.bashrc echo export PATH$JAVA_HOME/bin:$PATH ~/.bashrc source ~/.bashrc3.4 安装完成后验证与目录结构安装完先别急着创建 Domain检查一下安装产物。安装目录下会有几个关键内容wlserverWebLogic Server 主目录所有核心 jar 都在这里oracle_common公共组件目录.product.properties版本和安装信息一个 uninstall 目录卸载脚本位置验证命令ls $ORACLE_HOME/wlserver $ORACLE_HOME/wlserver/common/bin/wlst.sh -versionwlst.sh -version 能正常输出版本信息说明安装基本没问题。我习惯把安装根目录记到 shell 里export ORACLE_HOME/home/weblogic/Oracle/Middleware/Oracle_Home注意安装完成后实际的 ORACLE_HOME 就是你选的那个安装位置目录层级可能比预想深一层用 pwd 确认一下再设置。3.5 创建并启动第一个管理域安装好只是第一步真正跑起来的实体是 Domain。图形化配置 Domain 的入口是$ORACLE_HOME/wlserver/common/bin/config.sh启动后同样是 OUI 界面流程更简单。选择 “Create a new domain”填 Domain 名称比如 base_domain选 Domain 位置默认即可。为当前安装配置什么组件这里直接下一步就行。然后是管理员账号设置WebLogic 的管理员账号是 Weblogic 自身体系的和操作系统账号没关系。我习惯用一个独立密码长度至少 8 位且包含数字和字母后面所有控制台操作都靠它。这一步密码千万不要用 weblogic123 之类的弱口令生产环境分分钟被扫描爆破。Domain 模式有开发和生产两种如果只是本机测试选开发模式它会自动启动托管服务器进程生产环境一律选生产模式性能和安全模型更严格。配置完成后启动管理服务器$DOMAIN_HOME/startWebLogic.sh看到 “Server started in RUNNING mode” 就说明成功了浏览器访问http://服务器IP:7001/console输入刚才设置的账号密码进入 WebLogic 管理控制台。4. 我反复踩过的坑问题排查与修复实录4.1 打开界面就报 DISPLAY 错误这是最常见的启动失败类型报错文案一般是Unable to instantiate GUI, defaulting to console mode或者是Cant connect to X11 window server先跑 echo $DISPLAY 看有没有值。SSH X11 转发模式下如果没被自动赋值手动 export DISPLAYlocalhost:10.0 往往能解。VNC 模式下则要确保 vncserver 正在运行用 vncserver -list 查看。还有一种特殊情况本机有桌面但用的是 Wayland 而不是 X11可能导致 X 转发不兼容这种情况建议切 VNC。4.2 图形界面中文乱码服务器 locale 是中文但没装中文字体界面文字全变成方块。两条路解决一是给系统装中文字体包sudo yum install -y fontconfig urw-base35-fonts # 或者安装文泉驿 fc-cache -fv更省事的办法是强制用英文环境启动安装器export LANGen_US.UTF-8 java -jar fmw_14.1.2.0.0_wls_lite_generic.jar后者是我最常用的能少装一堆没用的字体包。4.3 JDK 版本导致安装失败启动安装器时报UnsupportedClassVersionError: ... has been compiled by a more recent version of the Java Runtime这类错误十有八九是当前 java 版本不对或者 OUI 检测到了 PATH 里老版本的 JDK。重点检查 which java 的路径和 JAVA_HOME 是否一致。还有一种隐蔽场景服务器上装了多版本 JDKJAVA_HOME 设置了 17但 PATH 里前面的目录还有一个更旧的 JDK导致 java -version 显示的是旧版本。解决方式就是显式指定export PATH$JAVA_HOME/bin:$PATH hash -r java -version确认输出是 17 再启动。4.4 远程桌面连上但安装器白屏VNC 连上后终端里启动 java -jar窗口出来了但是全白或者只显示边框不显示内容。大概率是服务器缺少字体库Java GUI 渲染需要底层字体服务。我踩过坑后习惯先装sudo yum install -y dejavu-sans-fonts装完基本就能正常渲染有时候还需要同步缺失的 X 客户端库sudo yum install -y xorg-x11-utils xorg-x11-xauth4.5 安装完成后控制台打不开安装流程一切正常startWebLogic.sh 也显示 RUNNING但浏览器访问 7001 端口就是不通。先本地 curl 验证curl -v http://localhost:7001/console本地返回 302 或正常页面说明服务没问题通常是防火墙拦截sudo firewall-cmd --permanent --add-port7001/tcp sudo firewall-cmd --reload如果服务器还有安全组之类的过滤规则也要一并放行 7001。另一个少见但真实的原因是 WebLogic 默认监听地址可能是 localhost检查管理服务器的监听地址配置是否改成了 0.0.0.0 或具体 IP这个在 config.sh 创建 Domain 时就能设置。4.6 常见问题速查表现象原因处理办法安装器启动后变成纯命令行DISPLAY 变量未设置export DISPLAY 对应地址窗口白屏或方框乱码缺少字体安装 dejavu-sans-fonts / 用 en_US.UTF-8UnsupportedClassVersionErrorJDK 版本不是 17切换 PATH 和 JAVA_HOME 到 JDK 17安装进度卡住不动/tmp 空间不足df -h /tmp清理或换大分区安装完 startWebLogic 起不来JAVA_HOME 没写进环境变量加入 ~/.bashrc 并 source控制台访问不到防火墙/监听地址放行端口、修改监听地址VNC 连上黑屏桌面会话没起来配置 xstartup 并启动窗口管理器我在实际安装 WebLogic 14.1.2.0 的时候最强烈的感受是版本升级后大家最容易栽在 JDK 版本这个基础问题上反而图形化操作本身非常顺滑。如果你在远程服务器上操作提前把显示环境测试通安装过程可能连十分钟都用不了如果你打算长期管理这套环境建议后续把 Domain 的启动做成 systemd 服务同时把管理服务器的监听地址、日志目录规划好这样重启机器后 WebLogic 能自动拉起比自己手动 nohup 优雅得多。