安装Lumina服务器和导入许可指南

安装Lumina服务器和导入许可

Lumina服务器需要mysql 5.8+的版本，Ubuntu默认安装mysql 8.0，MySQL由用户自行安装配置。安装Lumina前要先将Teams服务安装并运行正常。

官方安装指南  https://docs.hex-rays.com/admin-guide/lumina-server

注意事项，安装Lumina前，先将Teams server安装完成，安装MySQL并创建lumina数据库，Lumina用户并设置密码和授权。安装Lumina中除输入lumina用户密码外，其它保持默认设置。Lumina服务器第一个登录的用户为管理员，同时也是用户，如果购买1个席位，仅有这一个用户，所有连接都使用这一用户。

Lumina软件使用教程在Lumina服务器安装目录中两个pdf文件：lc_user_manual.pdf和lumina_admin_guide.pdf。

安装Mysql 8.0和配置lumina数据库、用户参考

更新软件包索引打开终端并运行以下命令来更新软件包索引：

sudo apt update

安装MySQL服务器使用以下命令安装MySQL服务器：

sudo apt install mysql-server

mysql -V

mysql  Ver 8.0.37-0ubuntu0.23.10.2 for Linux on x86_64 ((Ubuntu))

安装完成后mysql自动启动。

安全配置MySQL安装完成后，运行以下命令来安全配置MySQL：

sudo mysql_secure_installation

登录mysql，初始登录是没有密码的，在输入密码时直接回车。

sudo mysql -u root -p

Welcome to the MySQL monitor.  Commands end with ; or \g.

Your MySQL connection id is 14

Server version: 8.0.37-0ubuntu0.23.10.2 (Ubuntu)

Copyright (c) 2000, 2024, Oracle and/or its affiliates.

Oracle is a registered trademark of Oracle Corporation and/or its

affiliates. Other names may be trademarks of their respective

owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql>

修改root密码

ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'Ch89!Jqm61pv7';

flush privileges;

创建lumina用户 数据库

localhost:3306  DB:lumina User:lumina  密码 Ch89!Jqm61pv7

创建lumina数据库：

CREATE DATABASE lumina CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

创建用户lumina

create user 'lumina'@'localhost' identified by 'Ch89!Jqm61pv7'; 

alter user 'lumina'@'localhost' identified with mysql_native_password by 'Ch89!Jqm61pv7'; #修改为mysql_native_password

为用户lumina授权

grant all privileges on lumina.* to 'lumina'@'localhost' with grant option;

授权后刷新权限

flush privileges; 

MySQL配置 /tmp/mysql.sock 连接

方式一   使用软件链接方式

mysql的sock在Ubuntu里位置和名称不同，在/var/run/mysqld/mysqld.sock

软链接到/tmp/mysql.sock

ln -s /var/run/mysqld/mysqld.sock /tmp/mysql.sock

软链接后还会报错的话，stop mysql ,删除/tmp/mysql.sock.重启mysql ,再创建软链接 测试一下。如果能重启系统直接重启系统。

测试连接 mysql -u lumina -p -S /tmp/mysql.sock

方式二 修改Mysql配置文件 实际中操作1，2，4步骤

1 停止Mysql服务

在更改sock文件位置之前，我们需要先停止Mysql服务。可以使用以下命令停止Mysql服务：

sudo systemctl stop mysql

2 修改Mysql配置文件

Mysql的配置文件通常位于/etc/mysql/mysql.conf.d/mysqld.cnf 或者 /etc/my.cnf，具体位置可能因操作系统和Mysql版本的不同而有所变化。我们需要打开该文件，找到[mysqld]部分，并添加以下配置：

socket=/tmp/mysql.sock

[mysqld]

#

# * Basic Settings

#

user            = mysql

# pid-file      = /var/run/mysqld/mysqld.pid

# socket        = /var/run/mysqld/mysqld.sock

# port          = 3306

# datadir       = /var/lib/mysql

socket=/tmp/mysql.sock

保存并关闭配置文件。

3 创建软连接

创建一个软连接，将新的sock文件位置指向原有的sock文件。可以使用以下命令创建软连接：

sudo ln -s /tmp/mysql.sock /var/run/mysqld/mysqld.sock

4 启动Mysql服务

使用以下命令启动Mysql服务：

sudo systemctl start mysql

至此，Mysql的sock文件位置已成功更改为/tmp/mysql.sock。可以通过以下命令验证新的sock文件位置是否生效：

mysqladmin variables | grep socket 如果输出结果中显示socket = /tmp/mysql.sock，则说明更改成功。

本机登录mysql时可加参数-S命令, mysql -uroot -p -S /tmp/mysql.sock

安装lumina90_x64linux.run 

sudo chmod +x lumina90_x64linux.run

sudo ./lumina90_x64linux.run

欢迎使用 Hex-Rays Lumina 9.0 for IDA Teams 安装向导。

请阅读以下许可协议。在继续安装之前，您必须接受本协议的条款。
按 [Enter] 继续：
Hex-Rays 最终用户许可协议
本最终用户许可协议（“EULA”）是 Hex Rays SA（注册地址位于比利时列日市 Rue Rennequin-Sualem 34, 4000，注册号为 0873.473.914，以下简称“HEX-RAYS”、“我们”、“我们的”）与您（“您”或“最终用户”）之间的具有法律约束力的协议，并规定了您使用 HEX-RAYS 的软件（“软件”）和文档（“文档”）的行为。
如果您不同意本 EULA 的条款，HEX-RAYS 将不会且不授予您使用软件的权利，您不得使用该软件。
如果本 EULA 的条款与任何其他使用条款或条件发生冲突，则以本 EULA 的条款为准。
HEX-RAYS 可自行决定更改、补充或修改本 EULA 的条款，这些更改将适用于您未来对软件的使用。HEX-RAYS 可能会不时出于任何原因进行此类更改，并提前一周通知您。如果您不同意这些新条款，您可以停止使用该软件。
演示版许可。如果您是为评估目的而获得软件许可（“演示版许可”），则您只能在非商业环境中并在有限的时间内使用该软件。演示版软件旨在展示完整版软件的功能，完整版软件的许可条款如下所述。尽管本 EULA 中有任何其他规定，演示版软件的许可“按原样”提供，不提供任何形式的赔偿、支持或明示或暗示的保证。演示版许可是基于“每用户”许可的，并受本 EULA 条款的约束。软件的每个副本一次只能由一个用户使用。您可以将软件安装在您的办公室工作站、个人笔记本电脑和家用电脑上，前提是其他用户不得在这些计算机上使用该软件。
教育版许可。如果您是为教育目的获得软件许可（“教育版许可”），则您只能在非商业环境中使用该软件。教育版软件旨在在程序分析和/或逆向工程课程中教授学生。它可以由定期公开招收学生的大学和其他学术机构使用，特别不包括军事机构。尽管本 EULA 中有任何其他规定，教育版软件的许可“按原样”提供，不提供任何形式的赔偿、支持或明示或暗示的保证。教育版许可是基于“每计算机”许可的，并受本 EULA 条款的约束。
免费版许可。如果您获得的是软件的免费版本（“免费版许可”），则您只能在非商业环境中并根据本 EULA 的条款使用该软件。根据免费版许可提供的软件和文档的每个副本一次只能由一个用户使用。每个免费版许可允许您将软件安装在您的个人笔记本电脑和家用电脑上，前提是其他用户不得在这些计算机上使用该软件。尽管本 EULA 中有任何其他规定，免费版软件的许可“按原样”提供，不提供任何形式的赔偿、支持或明示或暗示的保证。
1. 许可的授予和范围
1.1. 根据本 EULA 的条款和条件，您被授予一项有限的、非独占的、不可转让的、不可再许可的、可撤销的许可，以使用软件及其相关文档（“文档”）：(i) 如果您获得的是演示版许可、教育版许可或免费版许可，则仅用于您的个人和非商业目的；或 (ii) 如果您获得的是非演示版许可、教育版许可或免费版许可的其他软件，则用于您的内部业务目的。您使用软件的权利受本 EULA 中所有条款和条件的限制。
1.2. 如果您是一个商业实体，您可以允许您的承包商（每个称为“被许可的第三方”）仅为向您提供服务的目的使用该软件，前提是该使用符合本 EULA。您应对任何被许可的第三方违反本 EULA 的行为负责。
1.3. 根据购买的许可或根据 EULA 提供的许可，软件可能按以下许可方案提供：
(i) “每命名用户”许可：每个“每命名用户”许可允许您在最多三台属于您或完全由您控制的计算机上安装该软件，前提是其他用户不得在这些计算机上使用该软件。每个“每命名用户”许可允许您一次只能在一台计算机上使用该软件。
(ii) “每固定计算机”许可：每个“每固定计算机”许可允许您的公司仅在一台物理或虚拟计算机上安装和使用该软件。
(iii) “浮动（漫游）”许可：每个浮动许可允许您的公司在所需的任意多台计算机上安装该软件。一个浮动许可允许一次并发使用该软件。
(iv) “团队”许可：每个团队许可允许您的公司在所需的任意多台计算机上安装该软件。一个团队许可允许您的组织指定的一名用户一次从一台计算机上使用该软件。
1.4. 本软件许可还允许您：
(i) 制作合理数量的备份副本，仅用于存档目的。
(ii) 在 HEX-RAYS 明确同意的情况下，将软件和本许可下的所有权利连同本许可和所有文档的副本一起转让给第三方，前提是该第三方同意并遵守本 EULA 的条款。在将许可转让给任何第三方后，您将失去使用软件和文档的权利。
1.5. 除免费版许可外，本许可为临时许可，前提是您已全额支付 HEX-RAYS 为软件开具的所有发票。如果未及时收到任何软件付款，您必须立即停止使用该软件。
1. 限制
2.1. 除非本 EULA 明确允许，否则您不得，也不得允许或授权任何人：
(i) 分发、转让、出借、租赁、共享、出售、转让、再许可、出租或分时共享任何软件或其任何组件或产品密钥，或允许第三方下载或安装任何软件；
(ii) 复制、反编译、反汇编或逆向工程，或以其他方式尝试从软件中提取或推导源代码或任何方法、算法或程序，除非适用法律明确允许，或修改、改编、翻译或基于软件创建衍生作品；
(iii) 更改或规避任何产品、密钥或许可限制，或以使您超出购买数量、击败任何使用限制或允许多个用户共享此类权利以超出购买数量的方式转让或重新分配命名用户许可或权利；
(iv) 以任何形式使用、提供、嵌入或以其他方式利用该软件，无论是否收费，在任何托管服务提供商（MSP）产品中：平台即服务（PaaS）产品；服务局；或其他类似产品或服务，包括将独立软件作为托管服务提供；
(v) 如果您是竞争对手，则不得使用该软件，或以任何与 HEX-RAYS 竞争的方式使用该软件，包括但不限于基准测试、收集和发布与软件性能相关的数据或分析，或开发或营销与任何软件或服务竞争的产品，而未经 HEX-RAYS 事先审查结果；
(vi) 以任何方式或出于任何目的使用该软件，侵犯、盗用或以其他方式侵犯任何第三方的知识产权或其他权利，或违反任何适用法律，包括出口法律。
1. 知识产权
3.1. 软件和文档由 HEX-RAYS 许可给您，而非出售给您。除本 EULA 明确授予的许可外，HEX-RAYS 代表其自身及其关联公司和供应商保留软件和文档中未明确授予您的所有权利。软件和文档中的权利在所有形式、媒体和技术中均有效并受保护，无论是现在存在的还是将来开发的。如果软件是通过可移动介质提供给您的，您可能拥有交付软件的介质，但 Hex-Rays SA 保留软件本身的所有副本的所有权。
1. 最终用户数据的收集和使用
4.1. 您承认并同意，HEX-RAYS 可以审查和使用您通过使用软件提供的所有反馈、数据或其他信息，包括通过软件上传或创建的数据或内容，或与您使用或软件性能相关的信息（“最终用户数据”），以验证您是否遵守本 EULA 中规定的条款和条件，并用于与您使用软件相关的任何目的，包括但不限于用户分析、改进软件性能或开发更新。HEX-RAYS 将免费并在此被授予一项非独占的、免版税的、全球范围的、可再许可的、可转让的许可，以 (a) 在本协议期限内及之后使用此类信息和数据来改进和增强软件，并用于与软件和 HEX-RAYS 其他产品相关的其他开发、诊断和纠正目的，以及 (b) 以汇总形式披露此类数据，前提是该信息不会直接或间接识别最终用户数据。
4.2. 您授予 HEX-RAYS 一项非独占的、免版税的、全球范围的、可再许可的、可转让的许可，以使用、复制、存储、修改、传输和显示最终用户数据，以提供和维护软件。HEX-RAYS 保留但不承担审查和删除任何违反本 EULA 规定、侵犯第三方权利或违反任何适用法律或法规的最终用户数据的权利。
1. 免责声明
5.1. 软件“按原样”提供，不提供任何明示或暗示的保证，包括但不限于任何适销性或适用于特定用途的暗示保证。HEX-RAYS 不保证软件将无中断运行、满足任何性能或可靠性标准、实现任何预期目的、与任何其他软件或系统兼容，或具有可纠正的错误。
1. 赔偿
6.1. 您将辩护、赔偿并使 HEX-RAYS 及其关联公司、独立承包商、服务提供商、供应商、合作伙伴、经销商、分销商和顾问及其各自的董事、高级职员、员工和代理免受任何第三方索赔、诉讼或行动以及由此产生的损害、成本、责任和费用（包括但不限于合理的律师费）的影响，这些索赔、诉讼或行动源于或与以下内容相关：(a) 您使用或无法使用软件；或 (b) 您违反本 EULA 的任何条款。
1. 责任限制
7.1. 在适用法律允许的最大范围内，Hex-Rays SA 及其董事、关联公司、子公司、承包商、代理、代表和员工在任何情况下均不对任何间接的、特殊的、附带的或间接的损害负责，包括但不限于使用损失、利润损失或数据损失，无论是在合同、侵权、过失、严格责任或任何其他法律或衡平法理论下的诉讼中，因使用或无法使用软件而引起或与之相关的，即使 HEX-RAYS 已被告知可能发生此类损害。在任何情况下，HEX-RAYS 和/或其关联公司及其各自的董事、高级职员、员工和代理在本 EULA 或软件下产生的总责任，无论是在合同、保证、侵权、产品责任或其他理论下，均不得超过 HEX-RAYS 为软件支付的补偿（如有）。
7.2. 我们保留因您未能遵守本 EULA 的条款或特定软件的具体条件而暂停或终止您使用全部或部分软件的权利。
1. 出口法律和制裁
8.1. 一些国家控制产品和信息的出口（“出口法律”）。此类出口法律可能适用于软件和文档。如果是这样，您同意此类法律适用于您对软件和文档的使用，并且您同意遵守所有此类出口法律。您同意，不会直接或间接违反这些出口法律出口任何由软件（或其直接产品）产生的数据、信息、软件程序和/或材料。
8.2. 您声明并保证，您不是受禁运国家（包括但不限于伊朗、叙利亚、苏丹、古巴和朝鲜）的公民，或位于这些国家境内，并且您不受出口法律的禁止接收该软件。使用软件和文档的所有权利均以您遵守本 EULA 的条款为条件，如果您未能遵守本 EULA 的条款，则这些权利将被没收。
8.3. 您保证，截至本 EULA 签署之日，您或任何直接或间接控制您 50% 或以上股份的实体或个人（“关联公司”）不受联合国、欧盟、美国或任何其他相关司法管辖区实施的经济、贸易或金融制裁或其他贸易限制的约束，包括但不限于欧盟综合制裁名单、美国财政部外国资产控制办公室特别指定国民和被封锁人员名单或任何欧盟成员国或最终用户注册/居住国维护的任何类似名单（“制裁”）。违反本保证将构成本 EULA 的重大违约。您同意，如果在 EULA 签订日期之后的任何时间，您或您的任何关联公司受到任何制裁的约束，无论是在该日期之前或之后引入的，这些制裁禁止或限制您履行 EULA 的权利或义务，或履行 EULA 使您面临或有可能面临任何制裁，包括但不限于任何域外或次级制裁，HEX-RAYS 可以在这些制裁生效时暂停或终止 EULA。
8.4. 您应赔偿 HEX-RAYS 因您违反本义务而遭受的任何损失、责任、损害、罚款、费用（包括但不限于法律费用）和开支。
1. 终止
9.1. 如果 HEX-RAYS 认为或有合理理由怀疑您违反了本 EULA 的条款，HEX-RAYS 可以立即终止您访问和使用软件的权利。
9.2. HEX-RAYS 可以随时出于任何原因并自行决定：(a) 更改、暂停或终止软件或其任何部分或功能，无论是临时还是永久性的；或 (b) 限制、暂停或终止（全部或部分）您访问或使用软件和/或删除并丢弃您可能通过使用软件贡献或获得的任何最终用户数据；所有这些均无需向您或任何其他人发出通知或承担责任。
9.3. 终止后，您必须立即归还、销毁或永久删除软件和文档的所有副本。您可以通过销毁软件及其所有副本来随时终止本许可。
1. 数据保护
10.1. 您还承认，当您下载、安装或使用软件时，HEX-RAYS 有权自动收集有关您使用软件的信息。HEX-RAYS 还可能要求您提供有关您自己的信息以便下载、安装或使用软件。所有与软件相关的从您那里收集的信息均可由 HEX-RAYS 按照 Hex Rays 的隐私政策 [https://hex-rays.com/privacy_policy/] 使用。通过使用、安装、下载或提供信息，您同意隐私政策以及我们按照该政策使用您的信息。
1. 其他
11.1. 不可抗力。如果由于我们无法控制的原因导致 HEX-RAYS 在履行与软件相关的义务时出现任何故障或延迟，HEX-RAYS 将不承担任何责任，这些原因包括但不限于天灾、战争、罢工或劳资纠纷、禁运、政府命令、流行病、电信、网络、计算机、服务器或互联网停机、网络攻击、第三方未经授权访问 HEX-RAYS 的信息技术系统或任何其他超出 HEX-RAYS 合理控制范围的原因（“不可抗力事件”）。
11.2. 可分割性。如果本 EULA 的任何条款因任何原因被视为无效或不可执行，本 EULA 的其他条款仍可执行，并且无效或不可执行的条款将被视为已修改，以使其在法律允许的最大范围内有效和可执行。
11.3. 弃权。未能执行本 EULA 的任何条款并不构成对该条款或任何其他条款的弃权。
11.4. 转让。您不得将本 EULA 或任何权利或义务转让或转移给任何第三方。HEX-RAYS 可以自由地 (i) 将其在本 EULA 下的义务或权利（部分）转让或分配给其关联公司，以及 (ii) 将其在本 EULA 下的履行或支持履行的分包给其关联公司、独立承包商和第三方服务提供商，而无需事先通知最终用户。
11.5. 适用法律和管辖权。本 EULA 受比利时法律管辖，不考虑任何冲突法原则。您在此不可撤销地同意比利时列日地区法院对本 EULA 或软件相关的任何诉讼的管辖权。1980 年《联合国国际货物销售合同公约》或其任何后续版本不适用于本 EULA。
按 [Enter] 继续：
您是否接受此许可？[y/n]: y

请指定 Hex-Rays Lumina 9.0 for IDA Teams 的安装目录。
安装目录 [/opt/lumina]:

初始化
执行基本配置（选择“否”将需要在安装后手动配置）？[Y/n]: y

服务用户名
请指定运行服务器的用户名。如果该用户不存在，将会被创建。[lumina]: lumina

数据库连接信息
Lumina 需要一个 MySQL 数据库；请输入连接数据库所需的信息

主机名 [localhost]:
端口 [3306]:
数据库名称 [lumina]:

数据库凭据
用户名 [lumina]:
密码 :  #输入lumina用户密码回车

配置服务
使用 systemd 设置服务 [Y/n]: y

监听端口
这是 Lumina 服务器应监听的端口。如果您选择特权端口，请确保运行它的用户可以绑定到该端口。[65432]:

安装程序现已准备好开始在您的计算机上安装 Hex-Rays Lumina 9.0 for IDA Teams。
您要继续吗？[Y/n]: y

请稍候，安装程序正在您的计算机上安装 Hex-Rays Lumina 9.0 for IDA Teams。
安装中
0% ______________ 50% ______________ 100%
#########################################

安装完成

导入许可文件和CA 启动服务

查看lumina.conf配置是否正确

sudo cat lumina.conf

CONNSTR="mysql;Server=localhost;Port=3306;Database=lumina;Uid=lumina;Pwd=Ch89!Jqm61pv7"

上传许可文件和CA文件 修改权限

sudo cp hexvault.crt hexvault.key lumina_server_96-DDBA-E5D0-5B.hexlic /opt/lumina/

sudo chown lumina:lumina hexvault.crt hexvault.key lumina_server_96-DDBA-E5D0-5B.hexlic

sudo chmod 640 hexvault.crt hexvault.key lumina_server_96-DDBA-E5D0-5B.hexlic

lumina不同程序的名称不同，看目录中的具体名称，有lumina_server_pro和 lumina_server 两种。

初始化数据

为了使 Lumina 服务器正常工作，它需要有一个适当的数据库模式（此时，MySQL 数据库（即"{mysql_db}"）必须已经存在但仍然是空的。）

这就是为什么在第一次安装时，您需要初始化服务器将使用的数据库：

sudo -u lumina ./lumina_server --config-file lumina.conf --recreate-schema lumina #后面要添加上lumina

sudo -u lumina ./lumina_server --config-file lumina.conf --recreate-schema lumina

Hex-Rays IDA Pro Lumina Server v9.0 Hex-Rays (c) 2024

Loading configuration file "lumina.conf"

Using connection string provided in configuration file "lumina.conf".

2024-10-18 03:21:02 Database has been initialized; exiting.

现在服务器已经安装完毕并且有一个可以使用的数据库，我们可以测试它是否正常工作：

sudo -u lumina ./lumina_server_pro --config-file lumina.conf \

--certchain-file hexvault.crt \

--privkey-file hexvault.key

默认监听端口 65432，按Ctrl+C中断。

修改lumina.service里正确的许可文件：

sudo vi lumina.service

[Unit]

Description=Hex-Rays Lumina daemon

Wants=network-online.target

After=network-online.target

[Service]

Type=simple

ExecStart=/opt/lumina/lumina_server -f /opt/lumina/lumina.conf -p 65432 -l /opt/lumina/logs/lumina_server.log -L /opt/lumina/lumina_server_96-DDBA-E5D0-5B.hexlic -c /opt/lumina/hexvault.crt -k /opt/lumina/hexvault.key

User=lumina

[Install]

WantedBy=multi-user.target

启动服务器

sudo systemctl daemon-reload

sudo systemctl start lumina

启动后查看进程和端口65432，如果没有启动，systemctl status lumina查看报错，有可能是mysql.sock问题，参考上文 MySQL配置 /tmp/mysql.sock 连接 处理。

配置Lumina使用用户

第一个登录服务器的用户将成为第一个管理员。lc是 Lumina 命令行管理客户端，随 Lumina 服务器安装程序一起提供。我们假设服务器已安装在 中/opt/lumina/，因此lc存在于 中/opt/lumina/lc。

配置用户示例：

cd /opt/lumina

./lc -hlumina.acme.com -ualice -psecr3t info

Hex-Rays Lumina Server v8.0

Lumina time: 2022-09-01 14:28:02, up since 2022-09-01 14:27:58

MAC address:

Client name: alice ADMIN

Client host: 127.0.0.1

由于 Alice 是第一个登录服务器的用户，她提供的凭据将用于创建服务器的主管理员。

您可以通过检查用户列表来验证您是唯一的用户：

./lc -hlumina.acme.com -ualice -psecr3t users

LastActive          Adm Login License         User name Email

------------------- --- ----- --------------- --------- --------------

2022-09-01 14:28:04 *   alice AA-A11C-AC8E-01 Alice     alice@acme.com

# Shown 1 results

也可以通过下面IDAPro软件中Lumina登录用户成为初始管理员和用户。

IDA PRO软件中连接私有Lumina设置

在菜单栏Option-->General-->Lumina里，将原来的公共Lumina server,换成这个私有Lumina server IP和端口，然后输入帐号密码就可以使用。