本文档主要介绍 BMC Studio 的环境搭建以及安装指导。

手动安装 ​

欢迎使用BMC Studio安装视频操作指导，本视频将为您提供详细的安装步骤，帮助您轻松完成BMC Studio的安装。

获取软件 ​

进入 openUBMC应用市场，在“开发工具”模块下，选择“BMC Studio”，进入 BMC Studio 下载页面，单击右侧“立即下载”按钮，将 BMC Studio 软件包下载到本地。

环境准备 ​

• BMC Studio 需要在 Ubuntu24 环境上运行，使用前须先搭建环境，具体的搭建方法请参见《环境准备》，请用户根据使用的操作系统，参考“环境准备”对应章节进行环境搭建。例如：本地使用 Windows 开发环境，请参考“Windows 开发环境搭建”。

  说明：
  

  如果本地环境已搭建完成，可跳过此操作。
  

• 操作过程中可能需要使用 git 和 bingo 工具，请确保本地已安装。

• 运行 BMC Studio 需要安装仓颉工具链，请按照如下方法配置：

  1. 下载仓颉0.53.13版本的安装包。
  2. 在 Ubuntu 内执行以下命令将仓颉安装包移动到 /opt 目录下。
     bash

     mv Cangjie-0.53.13-linux_x64.tar.gz /opt/

  3. 执行以下命令解压安装包。
     bash

     tar -zxf /opt/Cangjie-0.53.13-linux_x64.tar.gz -C /opt/

  4. 执行以下命令设置环境变量。
     bash

     source /opt/cangjie/envsetup.sh

• BMC Studio 依赖 nginx 运行 Web 页面，请执行以下命令安装 nginx。

  bash

  sudo apt install nginx

• 在WSL环境下运行时，请执行以下命令安装 xdg-utils 和 wslu 依赖项

  bash

  sudo apt install xdg-utils wslu

运行环境 ​

操作系统：Ubuntu 24.04。

启动 BMC Studio ​

BMC Studio 启动方法如下：

1. 在 BMC Studio 安装包所在文件夹中执行以下命令进行安装。
   bash

   dpkg -i bmc-studio-x.x.xx.xxxx.deb (其中x.x.xx.xxxx表示BMC Studio的版本号)

2. 环境变量配置。
   bash

   echo 'export LD_LIBRARY_PATH=/usr/share/bmc_studio/server:$LD_LIBRARY_PATH' >> /etc/profile
   source /etc/profile

3. 修改 nginx 网络配置。在 WSL 中部署 BMC Studio 后端的场景下使用，需要手动修改 WSL 中 nginx 的网络配置，使后端能够响应来自 Windows 的访问。
   bash

   sed -i "s@listen 127.0.0.0:@listen @g" /etc/nginx/conf.d/bmc_studio.conf
   service nginx restart

如果使用 Ubuntu20.04 系统，请按照以下步骤先适配 GLIBC 版本，再通过上述方式启动 BMC Studio。

1. 在 BMC Studio 安装包所在文件夹中执行以下命令添加高版本的软件源。
   bash

   echo "deb http://repo.huaweicloud.com/ubuntu jammy main" >> /etc/apt/sources.list
   sudo apt update

2. 安装高版本的 GLIBC。
   bash

   sudo apt install libc6

3. 为保证稳定性，使用如下命令恢复软件源。
   bash

   sed -i '$d' /etc/apt/sources.list
   sudo apt update

常用命令 ​

• 启动 BMC Studio：
  bash

  /usr/share/bmc_studio/bmc_studio.sh start
  /usr/share/bmc_studio/bmc_studio.sh start backend（后台启动）

• 停止 BMC Studio：
  bash

  /usr/share/bmc_studio/bmc_studio.sh stop

• 重启 BMC Studio：
  bash

  /usr/share/bmc_studio/bmc_studio.sh restart

常见问题处理 ​

安装完成后，提示找不到 sqlite ​

问题现象：安装完成后，提示 error while loading shared libraries: libsqlite.so: cannot open shared object file: no such file or directory

可能原因：未配置环境变量。

处理建议：执行以下命令配置环境变量。

echo 'export LD_LIBRARY_PATH=/usr/share/bmc_studio/server:$LD_LIBRARY_PATH' >> /etc/profile
source /etc/profile

安装完成后，提示找不到 libcangjie ​

问题现象：启动 BMC Studio 时，提示 error while loading shared libraries: libcangjie-std-ast.so: cannot open shared object file: No such file or directory

可能原因：未安装仓颉。

处理建议：

1. 安装仓颉。

2. 执行以下命令设置环境变量。

   bash

   source /opt/cangjie/envsetup.sh

在 WSL 中启动 BMC Studio，无法自动打开浏览器页面 ​

问题现象：

• 未安装 wslu 依赖时，启动时控制台报错：x-www-browser: command not found
• 未安装 xdg-utils 依赖时，启动时控制台报错：xdg-open: command not found

可能原因：缺少依赖。

处理建议：

1. 安装 wslu 和 xdg-utils 依赖。

2. 在 wsl 中执行以下命令，重新打开 BMC Studio。

   bash

   sudo apt install xdg-utils wslu

打开 BMC Studio 后，页面无响应 ​

问题现象：BMC Studio 主页无法显示。

可能原因：nginx 配置问题。

处理建议：重新配置 nginx 网络。

sed -i "s@listen 127.0.0.0:@listen @g" /etc/nginx/conf.d/bmc_studio.conf
service nginx restart