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

获取软件 ​

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

环境准备 ​

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

运行环境 ​

操作系统：Ubuntu24.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