用了大半天时间总算在实验室那台Ubuntu 20.04工作站的坑坑洼洼里把GAMMA 2020版装利索了。这期间朋友问得最多的就是GAMMA到底怎么装和网上搜出来的gamma校正是一回事吗这里先把最关键的结论放在开头如果你做的是SAR、InSAR方向那你需要的GAMMA是瑞士GAMMA Remote Sensing公司那套软件不是图像处理里做亮度校正的gamma变换。GAMMA 2020版在Linux Ubuntu 20.04上的安装说穿了就是解压软件包、配置授权服务、设置环境变量这三步每一步都有一些不容易注意到的细节。这篇就把整个流程和踩过的坑铺开写清楚正在折腾这门课的硕博生、给实验室服务器装环境管理员都可以直接照着来。很多人在这一步就已经开始晕了为什么别人装得挺顺利我却连第一条命令都跑不通原因多半不是软件本身的问题而是对GAMMA这套软件的安装逻辑没有一个整体把握。它和常见的开源软件不一样不是一个configure、make、make install就能跑起来的工程。理解清楚它的定位和依赖关系后面才能少做很多无用功。1. 装GAMMA 2020前先把这3件事想明白1.1 先确认你手里的GAMMA到底是哪一个GAMMA这一步说出来有点可笑但真有不少人栽在这。搜索关键词里带“GAMMA”的既有显示器的gamma校准工具也有游戏选项里的亮度调节还有数学函数库里的Gamma分布甚至有人把自己的软件命名为GAMMA。我们这里说的GAMMA是遥感领域做合成孔径雷达干涉测量的那套专业软件核心模块包含MSP、ISP、DIFF、IPTA等。拿到安装包后先看一眼压缩包命名通常会出现类似Gamma_2020_Linux64.tar.gz或GAMMA_2020_linux_64bit.tar.z这样的字样里面有Linux、64bit、GAMMA这些关键标识。如果手里拿到的是一个Windows安装版exe或者是32位的老版本那在Ubuntu 20.04上怎么折腾都是装不上的。我在群里看过不少人把“无法执行二进制文件”的报错截图发出来原因就是下载了Windows版。用file命令可以快速识别包类型file GAMMA_2020_linux_64bit.tar.gz输出里会出现gzip compressed data这类字样基本可以确认是个标准Linux压缩包。如果输出结果是“PE32 executable”那就说明拿错了版本。1.2 安装本质解压、授权服务、环境变量GAMMA和大多数商业科学软件一样分发已经编译好的二进制文件而不是源码所以安装过程通常没有需要自己编译的部分。整个安装逻辑可以拆成三件事把软件包解压到指定目录比如/opt/GAMMA。把官方根据你机器信息生成的license文件放到指定位置并启动授权服务。在shell配置里加上GAMMA目录相关的环境变量让系统能找到可执行程序、动态库和license文件。这三点就是全部。后面遇到任何问题都可以回来对照一下到底是哪一环出了问题。比如运行generate_dem提示“command not found”问题大概率在环境变量PATH上。如果程序能启动却报license错误问题就在授权配置上。定位起来非常快。1.3 Ubuntu 20.04为什么适合装2020版很多人有一个误区觉得Ubuntu版本越新越好。但从兼容性角度看GAMMA 2020版发布时的目标系统和当前Ubuntu 20.04是比较匹配的。Ubuntu 20.04是2020年4月发布的LTS版本glibc版本为2.31系统库较完整。GAMMA 2020版的预编译二进制在这个环境下跑起来基本没有兼容性障碍。如果你手头是Ubuntu 22.04或24.04反而要小心。新版本系统的OpenSSL、X11库、gfortran运行时库都更新了老版本的GAMMA二进制可能会因为找不到旧版本动态库而导致加载失败。当然不是一定装不上只是需要额外补充很多兼容库麻烦不少。所以如果手头有选择权建议安装Ubuntu 20.04作为运行环境能省掉很大一部分折腾的时间。2. 安装前的系统准备与可选依赖2.1 给系统做一次体检安装前先花几分钟确认系统基本状态。这一步看起来多余实际能避免后面排查问题时走弯路。打开终端执行下面三条命令uname -a cat /etc/os-release ldd --versionuname -a看内核架构确认是x86_64而不是aarch64。cat /etc/os-release确认是Ubuntu 20.04。ldd --version看glibc版本输出第一行就是版本号一般会显示2.31。如果出现的是2.35或更高版本说明你的系统不是标准20.04安装依赖库时要注意兼容问题。同时建议把系统更新做一遍因为后面很多依赖包的安装需要先更新软件源索引sudo apt update sudo apt upgrade -y2.2 安装依赖库和常用工具GAMMA在运行时依赖不少X11图形界面库和数值计算库。虽然有一部分是静态链接但动态链接的部分缺少了就会直接报错。根据我实际安装的经验下面这组包基本够用sudo apt install -y build-essential gcc g make cmake sudo apt install -y libxt6 libxmu6 libxext6 libxi6 libsm6 libice6 sudo apt install -y libx11-dev libxt-dev libglu1-mesa libgfortran5 sudo apt install -y libfftw3-3 libfftw3-bin libtiff5 sudo apt install -y xterm curl wget net-tools简单解释一下这些包的作用。build-essential、gcc、g、make、cmake是基础编译工具链虽然GAMMA主程序是预编译的但后续可能会用到一些辅助脚本和自编工具提前装好不碍事。libxt6、libxmu6、libxext6、libxi6、libsm6、libice6都是X Window系统的图形库GAMMA部分工具带图形界面没有这些库会报“cannot open shared object file”。libgfortran5是GNU Fortran运行时库老版本GAMMA二进制经常依赖这个Ubuntu 20.04默认不带或者带的是兼容版本显式安装一次比较稳妥。libfftw3是快速傅里叶变换库libtiff5用于处理GeoTIFF文件。如果你的处理流程中要用到CUDA加速那才需要额外安装NVIDIA显卡驱动和CUDA工具包。基础SAR处理不依赖GPU所以不装显卡驱动不影响GAMMA正常安装和运行。2.3 收集主机信息准备LicenseGAMMA的授权文件通常绑定主机信息最常见的是绑定主机名和MAC地址。在准备license文件之前先把自己机器的这两项信息查清楚hostname ip addr | grep etherhostname的输出就是主机名ip addr里ether开头的那串十六进制地址就是MAC地址格式类似00:16:3e:12:34:56。有些版本可能还需要hostid可以用lmhostid命令查询这个命令在安装GAMMA之后会出现在bin目录里也可以先用系统命令查看。拿到这些信息之后发送给GAMMA官方或者校内负责授权的老师他们会生成对应的license.dat发回来。这里有一个重要的提醒license文件里的主机信息必须和你实际机器完全一致连大小写和横杠都不能差。我之前帮同事配置的时候因为主机名里有一个字母的大小写不同导致license服务一直起不来检查了半小时才发现问题。2.4 规划安装目录并分配权限GAMMA的安装目录没有强制规定但建议放在/opt/GAMMA。这个目录透出性强便于多用户共享而且系统重装时不会像/usr/local那样容易被覆盖。创建目录并把所有权交给当前用户sudo mkdir -p /opt/GAMMA sudo chown -R $USER:$USER /opt/GAMMA这里把目录所有权改成当前用户有讲究后续写入license、生成日志、更新环境配置都不需要频繁使用sudo直接用普通用户操作更安全也能避免因为sudo环境变量和用户环境变量不一致导致的PATH问题。如果是多人共用的服务器可以创建一个gamma用户组把使用GAMMA的人都加进去目录权限设为775。3. 主程序安装解压、目录检查和二进制验证3.1 解压安装包跳过中文乱码的坑拿到安装包后先看看压缩格式再动手。GAMMA的Linux发行包常见的是tar.gz或tar.z格式用tar命令解压即可tar -zxvf GAMMA_2020_linux_64bit.tar.gz -C /opt/GAMMA如果是.tar.z格式把-zxvf改成-xvf即可。解压过程中屏幕会滚动大量文件名看到熟悉的MSP/、ISP/、DIFF/、IPTA/这些目录名出现基本就说明包没拿错。很多人解压时遇到过中文乱码的问题那个通常出现在zip压缩包中。如果GAMMA安装包不是tar格式而是zip用zip解压时中文文件名会变成乱码。GAMMA本身的二进制文件名都是英文乱码影响不大但为了保持目录整洁可以用下面的命令解压中文zip包unzip -O GBK GAMMA_2020.zip -d /opt/GAMMA-O GBK的作用是让解压工具按GBK编码解码文件名。GAMMA安装包一般用不到这个参数但如果你同时还在给其他软件包解压这个技巧能省去很多麻烦。3.2 看懂GAMMA目录结构每个模块是干什么的解压完成后进入/opt/GAMMA目录用ls -l看一眼。典型的GAMMA目录结构大致如下bin/存放所有可执行程序安装完成后要把这个目录加到PATH中。lib/存放共享库和静态库需要加到LD_LIBRARY_PATH。include/头文件开发人员做二次开发时会用到。src/部分工具的源码或示例源码。MSP/SAR成像处理模块处理原始数据和单视复图像。ISP/干涉SAR处理模块是InSAR流程的核心。DIFF/差分干涉和地理编码模块用于提取形变信息。IPTA/干涉点目标分析模块处理时间序列形变。这五个模块的划分不是随便的每个都有独立的程序和参数文档。刚上手不需要把所有模块都搞懂但至少要能分清bin目录里哪些程序属于哪个模块遇到问题才好对照官方手册定位。比如par_S1A属于MSP模块作用是把Sentinel-1数据文件转换成GAMMA格式参数文件而generate_dem属于DIFF模块作用是生成DEM。3.3 用ldd检查二进制文件是否缺少动态库这是整个安装过程中我特别推荐的一步。解压完先别急着配环境变量先看看bin目录里的程序能不能加载起来需要的库。随便挑一个程序比如par_S1A用ldd检查ldd /opt/GAMMA/bin/par_S1A | grep not found如果没有任何输出说明所有依赖的库都找得到万事大吉。如果输出了libXm.so.4 not found、libgfortran.so.5 not found这类信息就说明系统里缺少对应依赖包用apt安装即可。比如缺少libgfortran.so.5执行sudo apt install libgfortran5然后再跑一次ldd检查。还有一种情况是输出里出现“wrong ELF class”或者“cannot execute binary file”这说明程序架构和系统不匹配比如拿的是32位程序装到64位系统。需要回头确认安装包版本是否正确。4. License服务配置绝大多数安装失败的根源4.1 GAMMA 2020的License机制长什么样GAMMA的授权机制在2020版中依然沿用经典的服务端-客户端方式常见的是基于FLEXlm/FlexNet这套授权管理系统。简单说授权文件license.dat里描述了哪个Server、哪个Feature、哪个主机可以运行哪些模块。程序启动时会去连接这个授权服务验证通过才放行。license.dat文件的内容大致长这样SERVER hostname 00:16:3e:12:34:56 27000 DAEMON gamma_flexlm /opt/GAMMA/bin/lmgrd FEATURE GAMMA gamma_flexlm 2020.0 permanent 4 HOSTID00:16:3e:12:34:56这里强调一下上面只是帮助你理解格式的示意不是拿来直接保存使用的。实际license文件里面有很多加密校验信息由官方根据你提供的主机信息生成千万别手动篡改。改了之后唯一的结果就是校验失败授权服务起不来。4.2 放置license.dat文件创建license目录并把授权文件放进去mkdir -p /opt/GAMMA/license cp license.dat /opt/GAMMA/license/ chmod 644 /opt/GAMMA/license/license.dat注意文件权限不能是600因为启动授权服务时可能使用不同用户需要让其他进程也能读取这个文件。同时不要把这个license文件放在/home下更不要放在临时目录防止误删。4.3 启动授权服务并验证状态本地授权服务的启动方式通常是直接运行lmgrd指定license文件和日志文件位置export LM_LICENSE_FILE/opt/GAMMA/license/license.dat /opt/GAMMA/bin/lmgrd -c /opt/GAMMA/license/license.dat -l /var/log/gamma_license.log启动之后用lmstat验证服务状态/opt/GAMMA/bin/lmstat -a正常的输出里能看到“License server status”和“Server UP”的字样。看到这个说明核心授权服务已经跑起来了。如果输出里有“Server DOWN”或者“Cannot connect to license server”需要去看日志文件/var/log/gamma_license.log里的具体报错。补充一个虚拟机场景的坑如果你是在VMware或其他虚拟机里安装Ubuntu 20.04来跑GAMMA虚拟机默认的网络配置可能导致MAC地址在每次重启后变化这样绑定MAC的license就会失效。解决方式是给虚拟机设置静态MAC地址或者在生成license时就说明用的是虚拟机环境看官方是否提供基于hostid的授权方式。第一个方案更通用不建议在NAT模式下反复改MAC地址很麻烦。4.4 典型License报错排查授权的问题是安装GAMMA时最容易卡住的环节。整个排查链路就是按顺序看程序能不能连上授权服务器、服务器是否认出宿主机、功能是否为有效版本。下面列几个常见的报错和处理思路报错信息可能原因处理思路Cannot find license fileLM_LICENSE_FILE环境变量没设好检查环境变量路径是否指向正确的license.datInvalid host or hostid主机名或MAC地址与授权文件不一致重新核对hostname和ip addr输出逐字符比对License server does not support this version授权版本与GAMMA版本不匹配联系官方重新生成对应2020版授权文件Daemon is alive but feature expired授权时间过期或demo到期检查授权有效期需要续期Cannot connect to license serverlmgrd没启动或端口被防火墙拦截确认lmgrd进程在跑检查防火墙规则这里的核心逻辑是逐层排查先确认进程在不在再确认网络通不通再看文件对不对最后看时间过没过。跳步排查往往是浪费时间的开始。5. 环境变量与Shell配置让GAMMA命令全局可用5.1 在.bashrc中写入GAMMA环境变量授权服务跑通了主程序也解压好了接下来要做的就是把GAMMA的bin目录加入PATH把lib目录加入动态库搜索路径把license路径加入授权环境变量。编辑~/.bashrc在文件末尾追加export GAMMA_HOME/opt/GAMMA export PATH$GAMMA_HOME/bin:$PATH export LD_LIBRARY_PATH$GAMMA_HOME/lib:$LD_LIBRARY_PATH export LM_LICENSE_FILE/opt/GAMMA/license/license.dat这里有一个细节值得说明GAMMA_HOME这个变量在GAMMA内部的很多脚本中被引用一定要设置。PATH必须包含$GAMMA_HOME/bin否则终端里敲generate_dem会提示command not found。LD_LIBRARY_PATH必须包含$GAMMA_HOME/lib否则运行时找不到GAMMA自己的动态库。LM_LICENSE_FILE指向license.dat文件让GAMMA程序启动时能找到授权信息。设置完之后让配置生效source ~/.bashrc然后验证echo $GAMMA_HOME which generate_demwhich命令如果能输出/opt/GAMMA/bin/generate_dem就说明路径配置成功了。5.2 注意非交互shell和脚本调用的坑这里需要提醒一个很多人忽略的场景如果你写了一个脚本去调用GAMMA命令而这个脚本是通过cron定时任务运行的脚本里必须手动source环境变量因为cron环境默认不加载~/.bashrc。同理通过systemd服务启动的处理任务也一样。常见做法是在脚本开头加一行source /etc/profile或者显式导出GAMMA_HOME和PATH。别小看这一点我见过有同学的批处理脚本在终端里运行一切正常放进crontab就报command not found卡了一个下午才发现是这个原因。5.3 conda环境下的库冲突预防现在很多做遥感处理的人机器上都装了Anaconda或Minicondaconda会把自己目录加到PATH最前面同时改变LD_LIBRARY_PATH。GAMMA的二进制依赖系统库版本如果conda环境里的libtiff、libhdf5或libgfortran版本和GAMMA不匹配运行时会直接段错误Segmentation fault或者报“undefined symbol”。我的建议很简单跑GAMMA时先退出conda环境conda deactivate source ~/.bashrc同时检查一下环境变量里是否还有conda注入的LD_LIBRARY_PATH残留。如果必须在conda环境里调用GAMMA可以临时把GAMMA的lib目录加到LD_LIBRARY_PATH最前面但要做好心理准备这种方案不稳定能不用就不用。6. 安装验证与常见问题排查6.1 跑通一条快速验证命令装完之后怎么判断到底成没成我的推荐是一条命令一条命令来。先验证程序能启动generate_dem不带参数运行如果输出一段usage帮助信息而没有报“command not found”或段错误说明程序本身没问题。再验证授权lmstat -a | grep -i up能看到Server UP就说明授权正常。接下来可以找GAMMA安装包里自带的示例数据跑一个小流程。比如在/opt/GAMMA/ISP/examples或/opt/GAMMA/DIFF/examples目录下官方通常会提供一些小测试数据。用par_S1A处理一个Sentinel-1示例数据生成SLC参数文件再走多视、滤波、相位解缠如果能跑完不报错那整套安装基本就稳了。注意权限示例目录如果是root所有先chown给当前用户再操作否则写入时会遇到Permission denied。6.2 常见问题对照表除了授权问题安装和使用过程中还有不少高频故障点。整理一个对照表遇到问题直接按表排查现象原因处理建议command not foundPATH没配置或没source检查.bashrc确认GAMMA_HOME/bin在PATH中Segmentation faultconda库冲突或驱动问题conda deactivate后重试cannot open shared object file缺少系统依赖库用ldd定位缺失库并apt安装程序启动但显示Unable to open licenselicense路径错误或服务未启动检查LM_LICENSE_FILE和lmgrd进程解压后文件属主混乱之前用sudo解压导致权限异常chown -R 恢复属主中文文件名乱码zip解压编码问题用unzip -O GBK重新解压图形界面工具打开崩溃缺少X11库安装libxt6 libxmu6等图形库这套表是我在实际使用过程中积累的基本上覆盖了90%的安装期问题。6.3 几个实操中的顺序和技巧最后聊几个经验和细节不说多花哨但都很实用。第一个建议是先配License再设环境变量。如果你一上来就设置环境变量然后立刻运行GAMMA命令程序启动后第一件事是找授权一旦授权有问题你很难判断是环境变量错了还是授权错了。先把License服务跑通再配置命令路径每一步的验证范围更小定位更快。第二个建议安装路径避免中文、空格和特殊字符。GAMMA一些程序在解析路径时可能没有做很好的转义处理路径里出现空格或者中文就可能导致找不到文件。建议直接用/opt/GAMMA这种纯英文无空格的路径。第三个建议多用户共享时把权限规划好。服务器场景下最好建一个gamma组把需要使用的用户加进去chgrp -R gamma /opt/GAMMA然后设chmod -R 775。这样新产生的文件也可以被组内其他用户读取避免处理到一半出现权限不足的尴尬。第四个建议定期备份license.dat。这个文件一旦丢失重新申请需要时间而且有些授权文件有生效次数限制。系统重装前把环境变量列表导出一份重装后照抄回去能省不少事。最后再分享一点个人体会GAMMA 2020在Ubuntu 20.04下安装真的不算难但它和装开源软件的逻辑不一样。它不靠编译靠授权、路径和权限。很多人装不上问题往往不是软件坏了而是授权服务没起、环境变量没配、或者库冲突被忽略了。记牢“解压、授权、环境变量”这三件事再按这个顺序去排查大部分问题都能自己解决。希望这份记录能让同在遥感坑里的你少走一点弯路。
GAMMA 2020在Ubuntu 20.04安装全指南：从解压到License配置
用了大半天时间总算在实验室那台Ubuntu 20.04工作站的坑坑洼洼里把GAMMA 2020版装利索了。这期间朋友问得最多的就是GAMMA到底怎么装和网上搜出来的gamma校正是一回事吗这里先把最关键的结论放在开头如果你做的是SAR、InSAR方向那你需要的GAMMA是瑞士GAMMA Remote Sensing公司那套软件不是图像处理里做亮度校正的gamma变换。GAMMA 2020版在Linux Ubuntu 20.04上的安装说穿了就是解压软件包、配置授权服务、设置环境变量这三步每一步都有一些不容易注意到的细节。这篇就把整个流程和踩过的坑铺开写清楚正在折腾这门课的硕博生、给实验室服务器装环境管理员都可以直接照着来。很多人在这一步就已经开始晕了为什么别人装得挺顺利我却连第一条命令都跑不通原因多半不是软件本身的问题而是对GAMMA这套软件的安装逻辑没有一个整体把握。它和常见的开源软件不一样不是一个configure、make、make install就能跑起来的工程。理解清楚它的定位和依赖关系后面才能少做很多无用功。1. 装GAMMA 2020前先把这3件事想明白1.1 先确认你手里的GAMMA到底是哪一个GAMMA这一步说出来有点可笑但真有不少人栽在这。搜索关键词里带“GAMMA”的既有显示器的gamma校准工具也有游戏选项里的亮度调节还有数学函数库里的Gamma分布甚至有人把自己的软件命名为GAMMA。我们这里说的GAMMA是遥感领域做合成孔径雷达干涉测量的那套专业软件核心模块包含MSP、ISP、DIFF、IPTA等。拿到安装包后先看一眼压缩包命名通常会出现类似Gamma_2020_Linux64.tar.gz或GAMMA_2020_linux_64bit.tar.z这样的字样里面有Linux、64bit、GAMMA这些关键标识。如果手里拿到的是一个Windows安装版exe或者是32位的老版本那在Ubuntu 20.04上怎么折腾都是装不上的。我在群里看过不少人把“无法执行二进制文件”的报错截图发出来原因就是下载了Windows版。用file命令可以快速识别包类型file GAMMA_2020_linux_64bit.tar.gz输出里会出现gzip compressed data这类字样基本可以确认是个标准Linux压缩包。如果输出结果是“PE32 executable”那就说明拿错了版本。1.2 安装本质解压、授权服务、环境变量GAMMA和大多数商业科学软件一样分发已经编译好的二进制文件而不是源码所以安装过程通常没有需要自己编译的部分。整个安装逻辑可以拆成三件事把软件包解压到指定目录比如/opt/GAMMA。把官方根据你机器信息生成的license文件放到指定位置并启动授权服务。在shell配置里加上GAMMA目录相关的环境变量让系统能找到可执行程序、动态库和license文件。这三点就是全部。后面遇到任何问题都可以回来对照一下到底是哪一环出了问题。比如运行generate_dem提示“command not found”问题大概率在环境变量PATH上。如果程序能启动却报license错误问题就在授权配置上。定位起来非常快。1.3 Ubuntu 20.04为什么适合装2020版很多人有一个误区觉得Ubuntu版本越新越好。但从兼容性角度看GAMMA 2020版发布时的目标系统和当前Ubuntu 20.04是比较匹配的。Ubuntu 20.04是2020年4月发布的LTS版本glibc版本为2.31系统库较完整。GAMMA 2020版的预编译二进制在这个环境下跑起来基本没有兼容性障碍。如果你手头是Ubuntu 22.04或24.04反而要小心。新版本系统的OpenSSL、X11库、gfortran运行时库都更新了老版本的GAMMA二进制可能会因为找不到旧版本动态库而导致加载失败。当然不是一定装不上只是需要额外补充很多兼容库麻烦不少。所以如果手头有选择权建议安装Ubuntu 20.04作为运行环境能省掉很大一部分折腾的时间。2. 安装前的系统准备与可选依赖2.1 给系统做一次体检安装前先花几分钟确认系统基本状态。这一步看起来多余实际能避免后面排查问题时走弯路。打开终端执行下面三条命令uname -a cat /etc/os-release ldd --versionuname -a看内核架构确认是x86_64而不是aarch64。cat /etc/os-release确认是Ubuntu 20.04。ldd --version看glibc版本输出第一行就是版本号一般会显示2.31。如果出现的是2.35或更高版本说明你的系统不是标准20.04安装依赖库时要注意兼容问题。同时建议把系统更新做一遍因为后面很多依赖包的安装需要先更新软件源索引sudo apt update sudo apt upgrade -y2.2 安装依赖库和常用工具GAMMA在运行时依赖不少X11图形界面库和数值计算库。虽然有一部分是静态链接但动态链接的部分缺少了就会直接报错。根据我实际安装的经验下面这组包基本够用sudo apt install -y build-essential gcc g make cmake sudo apt install -y libxt6 libxmu6 libxext6 libxi6 libsm6 libice6 sudo apt install -y libx11-dev libxt-dev libglu1-mesa libgfortran5 sudo apt install -y libfftw3-3 libfftw3-bin libtiff5 sudo apt install -y xterm curl wget net-tools简单解释一下这些包的作用。build-essential、gcc、g、make、cmake是基础编译工具链虽然GAMMA主程序是预编译的但后续可能会用到一些辅助脚本和自编工具提前装好不碍事。libxt6、libxmu6、libxext6、libxi6、libsm6、libice6都是X Window系统的图形库GAMMA部分工具带图形界面没有这些库会报“cannot open shared object file”。libgfortran5是GNU Fortran运行时库老版本GAMMA二进制经常依赖这个Ubuntu 20.04默认不带或者带的是兼容版本显式安装一次比较稳妥。libfftw3是快速傅里叶变换库libtiff5用于处理GeoTIFF文件。如果你的处理流程中要用到CUDA加速那才需要额外安装NVIDIA显卡驱动和CUDA工具包。基础SAR处理不依赖GPU所以不装显卡驱动不影响GAMMA正常安装和运行。2.3 收集主机信息准备LicenseGAMMA的授权文件通常绑定主机信息最常见的是绑定主机名和MAC地址。在准备license文件之前先把自己机器的这两项信息查清楚hostname ip addr | grep etherhostname的输出就是主机名ip addr里ether开头的那串十六进制地址就是MAC地址格式类似00:16:3e:12:34:56。有些版本可能还需要hostid可以用lmhostid命令查询这个命令在安装GAMMA之后会出现在bin目录里也可以先用系统命令查看。拿到这些信息之后发送给GAMMA官方或者校内负责授权的老师他们会生成对应的license.dat发回来。这里有一个重要的提醒license文件里的主机信息必须和你实际机器完全一致连大小写和横杠都不能差。我之前帮同事配置的时候因为主机名里有一个字母的大小写不同导致license服务一直起不来检查了半小时才发现问题。2.4 规划安装目录并分配权限GAMMA的安装目录没有强制规定但建议放在/opt/GAMMA。这个目录透出性强便于多用户共享而且系统重装时不会像/usr/local那样容易被覆盖。创建目录并把所有权交给当前用户sudo mkdir -p /opt/GAMMA sudo chown -R $USER:$USER /opt/GAMMA这里把目录所有权改成当前用户有讲究后续写入license、生成日志、更新环境配置都不需要频繁使用sudo直接用普通用户操作更安全也能避免因为sudo环境变量和用户环境变量不一致导致的PATH问题。如果是多人共用的服务器可以创建一个gamma用户组把使用GAMMA的人都加进去目录权限设为775。3. 主程序安装解压、目录检查和二进制验证3.1 解压安装包跳过中文乱码的坑拿到安装包后先看看压缩格式再动手。GAMMA的Linux发行包常见的是tar.gz或tar.z格式用tar命令解压即可tar -zxvf GAMMA_2020_linux_64bit.tar.gz -C /opt/GAMMA如果是.tar.z格式把-zxvf改成-xvf即可。解压过程中屏幕会滚动大量文件名看到熟悉的MSP/、ISP/、DIFF/、IPTA/这些目录名出现基本就说明包没拿错。很多人解压时遇到过中文乱码的问题那个通常出现在zip压缩包中。如果GAMMA安装包不是tar格式而是zip用zip解压时中文文件名会变成乱码。GAMMA本身的二进制文件名都是英文乱码影响不大但为了保持目录整洁可以用下面的命令解压中文zip包unzip -O GBK GAMMA_2020.zip -d /opt/GAMMA-O GBK的作用是让解压工具按GBK编码解码文件名。GAMMA安装包一般用不到这个参数但如果你同时还在给其他软件包解压这个技巧能省去很多麻烦。3.2 看懂GAMMA目录结构每个模块是干什么的解压完成后进入/opt/GAMMA目录用ls -l看一眼。典型的GAMMA目录结构大致如下bin/存放所有可执行程序安装完成后要把这个目录加到PATH中。lib/存放共享库和静态库需要加到LD_LIBRARY_PATH。include/头文件开发人员做二次开发时会用到。src/部分工具的源码或示例源码。MSP/SAR成像处理模块处理原始数据和单视复图像。ISP/干涉SAR处理模块是InSAR流程的核心。DIFF/差分干涉和地理编码模块用于提取形变信息。IPTA/干涉点目标分析模块处理时间序列形变。这五个模块的划分不是随便的每个都有独立的程序和参数文档。刚上手不需要把所有模块都搞懂但至少要能分清bin目录里哪些程序属于哪个模块遇到问题才好对照官方手册定位。比如par_S1A属于MSP模块作用是把Sentinel-1数据文件转换成GAMMA格式参数文件而generate_dem属于DIFF模块作用是生成DEM。3.3 用ldd检查二进制文件是否缺少动态库这是整个安装过程中我特别推荐的一步。解压完先别急着配环境变量先看看bin目录里的程序能不能加载起来需要的库。随便挑一个程序比如par_S1A用ldd检查ldd /opt/GAMMA/bin/par_S1A | grep not found如果没有任何输出说明所有依赖的库都找得到万事大吉。如果输出了libXm.so.4 not found、libgfortran.so.5 not found这类信息就说明系统里缺少对应依赖包用apt安装即可。比如缺少libgfortran.so.5执行sudo apt install libgfortran5然后再跑一次ldd检查。还有一种情况是输出里出现“wrong ELF class”或者“cannot execute binary file”这说明程序架构和系统不匹配比如拿的是32位程序装到64位系统。需要回头确认安装包版本是否正确。4. License服务配置绝大多数安装失败的根源4.1 GAMMA 2020的License机制长什么样GAMMA的授权机制在2020版中依然沿用经典的服务端-客户端方式常见的是基于FLEXlm/FlexNet这套授权管理系统。简单说授权文件license.dat里描述了哪个Server、哪个Feature、哪个主机可以运行哪些模块。程序启动时会去连接这个授权服务验证通过才放行。license.dat文件的内容大致长这样SERVER hostname 00:16:3e:12:34:56 27000 DAEMON gamma_flexlm /opt/GAMMA/bin/lmgrd FEATURE GAMMA gamma_flexlm 2020.0 permanent 4 HOSTID00:16:3e:12:34:56这里强调一下上面只是帮助你理解格式的示意不是拿来直接保存使用的。实际license文件里面有很多加密校验信息由官方根据你提供的主机信息生成千万别手动篡改。改了之后唯一的结果就是校验失败授权服务起不来。4.2 放置license.dat文件创建license目录并把授权文件放进去mkdir -p /opt/GAMMA/license cp license.dat /opt/GAMMA/license/ chmod 644 /opt/GAMMA/license/license.dat注意文件权限不能是600因为启动授权服务时可能使用不同用户需要让其他进程也能读取这个文件。同时不要把这个license文件放在/home下更不要放在临时目录防止误删。4.3 启动授权服务并验证状态本地授权服务的启动方式通常是直接运行lmgrd指定license文件和日志文件位置export LM_LICENSE_FILE/opt/GAMMA/license/license.dat /opt/GAMMA/bin/lmgrd -c /opt/GAMMA/license/license.dat -l /var/log/gamma_license.log启动之后用lmstat验证服务状态/opt/GAMMA/bin/lmstat -a正常的输出里能看到“License server status”和“Server UP”的字样。看到这个说明核心授权服务已经跑起来了。如果输出里有“Server DOWN”或者“Cannot connect to license server”需要去看日志文件/var/log/gamma_license.log里的具体报错。补充一个虚拟机场景的坑如果你是在VMware或其他虚拟机里安装Ubuntu 20.04来跑GAMMA虚拟机默认的网络配置可能导致MAC地址在每次重启后变化这样绑定MAC的license就会失效。解决方式是给虚拟机设置静态MAC地址或者在生成license时就说明用的是虚拟机环境看官方是否提供基于hostid的授权方式。第一个方案更通用不建议在NAT模式下反复改MAC地址很麻烦。4.4 典型License报错排查授权的问题是安装GAMMA时最容易卡住的环节。整个排查链路就是按顺序看程序能不能连上授权服务器、服务器是否认出宿主机、功能是否为有效版本。下面列几个常见的报错和处理思路报错信息可能原因处理思路Cannot find license fileLM_LICENSE_FILE环境变量没设好检查环境变量路径是否指向正确的license.datInvalid host or hostid主机名或MAC地址与授权文件不一致重新核对hostname和ip addr输出逐字符比对License server does not support this version授权版本与GAMMA版本不匹配联系官方重新生成对应2020版授权文件Daemon is alive but feature expired授权时间过期或demo到期检查授权有效期需要续期Cannot connect to license serverlmgrd没启动或端口被防火墙拦截确认lmgrd进程在跑检查防火墙规则这里的核心逻辑是逐层排查先确认进程在不在再确认网络通不通再看文件对不对最后看时间过没过。跳步排查往往是浪费时间的开始。5. 环境变量与Shell配置让GAMMA命令全局可用5.1 在.bashrc中写入GAMMA环境变量授权服务跑通了主程序也解压好了接下来要做的就是把GAMMA的bin目录加入PATH把lib目录加入动态库搜索路径把license路径加入授权环境变量。编辑~/.bashrc在文件末尾追加export GAMMA_HOME/opt/GAMMA export PATH$GAMMA_HOME/bin:$PATH export LD_LIBRARY_PATH$GAMMA_HOME/lib:$LD_LIBRARY_PATH export LM_LICENSE_FILE/opt/GAMMA/license/license.dat这里有一个细节值得说明GAMMA_HOME这个变量在GAMMA内部的很多脚本中被引用一定要设置。PATH必须包含$GAMMA_HOME/bin否则终端里敲generate_dem会提示command not found。LD_LIBRARY_PATH必须包含$GAMMA_HOME/lib否则运行时找不到GAMMA自己的动态库。LM_LICENSE_FILE指向license.dat文件让GAMMA程序启动时能找到授权信息。设置完之后让配置生效source ~/.bashrc然后验证echo $GAMMA_HOME which generate_demwhich命令如果能输出/opt/GAMMA/bin/generate_dem就说明路径配置成功了。5.2 注意非交互shell和脚本调用的坑这里需要提醒一个很多人忽略的场景如果你写了一个脚本去调用GAMMA命令而这个脚本是通过cron定时任务运行的脚本里必须手动source环境变量因为cron环境默认不加载~/.bashrc。同理通过systemd服务启动的处理任务也一样。常见做法是在脚本开头加一行source /etc/profile或者显式导出GAMMA_HOME和PATH。别小看这一点我见过有同学的批处理脚本在终端里运行一切正常放进crontab就报command not found卡了一个下午才发现是这个原因。5.3 conda环境下的库冲突预防现在很多做遥感处理的人机器上都装了Anaconda或Minicondaconda会把自己目录加到PATH最前面同时改变LD_LIBRARY_PATH。GAMMA的二进制依赖系统库版本如果conda环境里的libtiff、libhdf5或libgfortran版本和GAMMA不匹配运行时会直接段错误Segmentation fault或者报“undefined symbol”。我的建议很简单跑GAMMA时先退出conda环境conda deactivate source ~/.bashrc同时检查一下环境变量里是否还有conda注入的LD_LIBRARY_PATH残留。如果必须在conda环境里调用GAMMA可以临时把GAMMA的lib目录加到LD_LIBRARY_PATH最前面但要做好心理准备这种方案不稳定能不用就不用。6. 安装验证与常见问题排查6.1 跑通一条快速验证命令装完之后怎么判断到底成没成我的推荐是一条命令一条命令来。先验证程序能启动generate_dem不带参数运行如果输出一段usage帮助信息而没有报“command not found”或段错误说明程序本身没问题。再验证授权lmstat -a | grep -i up能看到Server UP就说明授权正常。接下来可以找GAMMA安装包里自带的示例数据跑一个小流程。比如在/opt/GAMMA/ISP/examples或/opt/GAMMA/DIFF/examples目录下官方通常会提供一些小测试数据。用par_S1A处理一个Sentinel-1示例数据生成SLC参数文件再走多视、滤波、相位解缠如果能跑完不报错那整套安装基本就稳了。注意权限示例目录如果是root所有先chown给当前用户再操作否则写入时会遇到Permission denied。6.2 常见问题对照表除了授权问题安装和使用过程中还有不少高频故障点。整理一个对照表遇到问题直接按表排查现象原因处理建议command not foundPATH没配置或没source检查.bashrc确认GAMMA_HOME/bin在PATH中Segmentation faultconda库冲突或驱动问题conda deactivate后重试cannot open shared object file缺少系统依赖库用ldd定位缺失库并apt安装程序启动但显示Unable to open licenselicense路径错误或服务未启动检查LM_LICENSE_FILE和lmgrd进程解压后文件属主混乱之前用sudo解压导致权限异常chown -R 恢复属主中文文件名乱码zip解压编码问题用unzip -O GBK重新解压图形界面工具打开崩溃缺少X11库安装libxt6 libxmu6等图形库这套表是我在实际使用过程中积累的基本上覆盖了90%的安装期问题。6.3 几个实操中的顺序和技巧最后聊几个经验和细节不说多花哨但都很实用。第一个建议是先配License再设环境变量。如果你一上来就设置环境变量然后立刻运行GAMMA命令程序启动后第一件事是找授权一旦授权有问题你很难判断是环境变量错了还是授权错了。先把License服务跑通再配置命令路径每一步的验证范围更小定位更快。第二个建议安装路径避免中文、空格和特殊字符。GAMMA一些程序在解析路径时可能没有做很好的转义处理路径里出现空格或者中文就可能导致找不到文件。建议直接用/opt/GAMMA这种纯英文无空格的路径。第三个建议多用户共享时把权限规划好。服务器场景下最好建一个gamma组把需要使用的用户加进去chgrp -R gamma /opt/GAMMA然后设chmod -R 775。这样新产生的文件也可以被组内其他用户读取避免处理到一半出现权限不足的尴尬。第四个建议定期备份license.dat。这个文件一旦丢失重新申请需要时间而且有些授权文件有生效次数限制。系统重装前把环境变量列表导出一份重装后照抄回去能省不少事。最后再分享一点个人体会GAMMA 2020在Ubuntu 20.04下安装真的不算难但它和装开源软件的逻辑不一样。它不靠编译靠授权、路径和权限。很多人装不上问题往往不是软件坏了而是授权服务没起、环境变量没配、或者库冲突被忽略了。记牢“解压、授权、环境变量”这三件事再按这个顺序去排查大部分问题都能自己解决。希望这份记录能让同在遥感坑里的你少走一点弯路。
