SAC 安裝說明

Seismic Analysis Code (SAC)
安裝環境 : Linux 作業系統
安裝檔案 : sac-101.6a-linux_x86_64.tar.gz
本文連結 : https://hackmd.io/@kmo/notes_sac_install

• SAC 安裝說明
• 安裝指令
  • 1. 創立資料夾
  • 2. 解壓縮至 ~/sac-101.6a
  • 3. 修改初始化腳本
  • 4. 設定環境變數檔
  • 5. 讓環境變數檔生效
  • 6. 安裝相依 Library
  • 7. 查詢相依的 Library (參考內容，可跳過)
    • 7.1 Library 對應的套件名稱
    • 7.2 確認 Library
• 安裝成功畫面
  • 參考資料
• 後記

安裝指令

本文安裝 sac 所使用的指令。依序執行指令，即可安裝完成。

# create directory
mkdir -p ~/sac-101.6a

# untar sac
tar -xzvf sac-101.6a-linux_x86_64.tar.gz -C ~/sac-101.6a

# modify sacinit.sh
sed -i 's#SACHOME=/usr/local/sac#SACHOME=~/sac-101.6a/sac#' ~/sac-101.6a/sac/bin/sacinit.sh
sed -i 's#PATH=${PATH}:${SACHOME}/bin#PATH=${SACHOME}/bin:${PATH}#' ~/sac-101.6a/sac/bin/sacinit.sh

# append command to ~/.bashrc
echo "source ~/sac-101.6a/sac/bin/sacinit.sh" >> ~/.bashrc

# install dependent library 
## for RHEL/CentOS
sudo yum install libSM libICE libXpm libX11

## for Debian/Ubuntu
sudo apt install libsm6 libice6 libxpm4 libx11-6 

1. 創立資料夾

mkdir -p ~/sac-101.6a

• Linux 指令說明:
  mkdir 創立資料夾 sac-101.61。
  -p 若指定路徑已有目錄會跳過，若無將創立資料夾。

2. 解壓縮至 ~/sac-101.6a

tar -xzvf sac-101.6a-linux_x86_64.tar.gz -C ~/sac-101.6a  

• Linux 指令說明:
  tar -xzvf 解壓縮 *.tar.gz 格式的檔案，
  -C 指定解壓縮路徑。
• ps:
  壓縮檔內有 sac 資料夾，故解壓縮後，現在 sac 實際安裝位置是 ~/sac-101.6a/sac。

3. 修改初始化腳本

sed -i 's#SACHOME=/usr/local/sac#SACHOME=~/sac-101.6a/sac#' ~/sac-101.6a/sac/bin/sacinit.sh  
sed -i 's#PATH=${PATH}:${SACHOME}/bin#PATH=${SACHOME}/bin:${PATH}#' ~/sac-101.6a/sac/bin/sacinit.sh

sac 有提供初始化腳本。需依據安裝路徑，修改初始化腳本。

• Linux 指令說明:
  sed -i 修改初始化腳本 sacinit.sh 內容。
  修改變數 SACHOME 從 SACHOME=/usr/local/sac -> SACHOME=~/sac-101.6a/sac。
  修改變數 PATH 從PATH=${PATH}:${SACHOME}/bin ->PATH=${SACHOME}/bin:${PATH}。
  修改 PATH 變數的順序，目的是讓系統先讀到我們裝的 sac，避免系統因存在相同名稱的程式，而執行到其他指令。

4. 設定環境變數檔

echo "source ~/sac-101.6a/sac/bin/sacinit.sh" >> ~/.bashrc

新增初始化腳本至環境變數設定檔，登入時會自動讀取。

• Linux 指令說明:
  echo 把雙引號內容，寫入~/.bashrc。
  搭配 >>，能把原本應輸出至螢幕的內容，append 內容至檔案。
  ~/.bashrc 是環境變數設定檔，登入時會讀取及執行內容。

5. 讓環境變數檔生效

source ~/.bashrc

or 登出 (Ctrl + D) 再登入系統。
這時候打 sac 就會有反應。

• Linux 指令說明:
  source 讀取腳本內容套用至 shell 環境。

6. 安裝相依 Library

# install dependent library 
## for RHEL/CentOS
sudo yum install libSM libICE libXpm libX11

## for Debian/Ubuntu
sudo apt install libsm6 libice6 libxpm4 libx11-6 

壓縮檔 sac-101.6a-linux_x86_64.tar.gz 內提供的 sac，為預先編譯的執行檔。Linux 系統需具備相依的 library，才能正常使用。

• Linux 指令說明:
  目前知名 Linux distribution，主要為 RHEL/CentOS or Debian/Ubuntu 兩種派系。兩者主要差別之一，是套件管理工具不同，一個是 yum 一個是 apt 。若用戶沒有管理員權限，沒法用 sudo 安裝套件，請向主機管理員請求協助。
• ps:
  若管理員沒法幫忙安裝，可以自行下載 library 套件(*.rpm or *.deb)，解壓縮至指定目錄，並新增環境變數 LD_LIBRARY_PATH 指向解壓縮的路徑，就能讓 sac 正常運行。

7. 查詢相依的 Library (參考內容，可跳過)

以 CentOS 7 最小安裝的環境為例，如下截圖，可以看到系統缺少 sac 所需的 library libSM.so.6、libICE.so.6、libXpm.so.4、libX11.so.6。

ldd $(which sac)

• Linux 指令說明:
  ldd 列出相依的 library。
  which 查閱該指令路徑。
  $() 為 Bash Command substitution 功能，輸出$()內執行結果。

## for RHEL/CentOS
yum whatprovides libSM.so.6

## for Debian/Ubuntu
apt-file search libSM.so.6

查詢哪些套件提供 libSM.so.6。可把 libSM.so.6 替換其他也是 not found 的 library。(在 Debian/Ubuntu 環境，apt-file 並非預先安裝指令，可能需自行安裝。)

7.1 Library 對應的套件名稱

幫大家查好了相依的 library 的套件名稱

Library	RHEL/CentOS	Debian/Ubuntu
libSM.so.6	libSM	libsm6
libICE.so.6	libICE	libice6
libXpm.so.4	libXpm	libxpm4
libX11.so.6	libX11	libx11-6

7.2 確認 Library

安裝完套件後，確認 sac 都有找到所需的 library。

安裝成功畫面

執行 sac，進入 sac 環境。

參考資料

• sac README 文件 ($SACHOME/README)
• sac 網頁提供的安裝說明

後記

畢業已久，脫離地科領域好一陣子。
臉書看到學生，輾轉詢問如何安裝 sac。
(7年前我也卡在安裝 sac 過 XD)。
因此撰寫此文，補充一些 Linux 系統的說明，
希望能幫助初學者，減少熟悉 Linux 系統所花的成本。
安裝完 sac，趕緊進到地震學的重頭戲，利用 sac 進行震波分析。

---

This work is licensed under a CC BY-SA 4.0.