From 61433d5dc50197be11430142871a846d989e722a Mon Sep 17 00:00:00 2001
From: Armando Luiz Nicolini Delgado <nicolui@inf.ufpr.br>
Date: Wed, 23 Jun 2021 09:43:47 -0300
Subject: [PATCH] =?UTF-8?q?Guia=20de=20instala=C3=A7=C3=A3o=20de=20LIKWID?=
 =?UTF-8?q?=20em=20Linux=20Standalone?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 LIKWID-INSTALL.txt | 114 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 114 insertions(+)
 create mode 100644 LIKWID-INSTALL.txt

diff --git a/LIKWID-INSTALL.txt b/LIKWID-INSTALL.txt
new file mode 100644
index 0000000..04364cd
--- /dev/null
+++ b/LIKWID-INSTALL.txt
@@ -0,0 +1,114 @@
+===== GUIA DE INSTALAÇÃO E CONFIGURAÇÃO DO LINUX PARA USO DO LIKWID ===============
+
+0. Deve-se  compilar e instalar o  LIKWID. Use um dos  links abaixo para
+   fazer o download do código-fonte:
+
+         http://ftp.fau.de/pub/likwid/likwid-stable.tar.gz
+
+         https://github.com/RRZE-HPC/likwid
+
+   --> Para isto, pode-se executar os comandos abaixo:
+
+        $VERSION=stable
+        wget http://ftp.fau.de/pub/likwid/likwid-$VERSION.tar.gz
+        tar -xaf likwid-$VERSION.tar.gz
+        cd likwid-$VERSION
+        
+        # configura compilação. Default é instalar os executáveis e bibliotecas em '/usr/local'
+        vi config.mk
+        make
+
+        # 'sudo' necessário para instalar o daemon de acesso com permissões apropriadas
+        sudo make install
+   
+
+1. Garantir que módulo do kernel 'msr' esteja carregado:
+    * 'lsmod | grep msr':  se não aparecer nada, 'msr' não está carregado
+
+    * Carregar manualmente 'msr' (após boot):
+    
+           sudo modprobe msr
+
+    * Carregar 'msr' automaticamente após boot:
+          --> Editar '/etc/modules' ('sudo vi /etc/modules') e acrescentar uma
+	  linha contendo apenas 'msr'
+
+2. Alterar permissões de '/dev/cpu/*/msr':
+      * Manualmente (após boot):
+
+          sudo chmod o+rw /dev/cpu/*/msr
+          
+      * Automaticamente após boot:
+          -  Editar '/etc/rc.local' ('sudo vi /etc/rc.local') e acrescentar
+             'chmod o+rw /dev/cpu/*/msr' em alguma linha ANTES da última linha
+	     que contém 'exit 0'
+             
+	  - Executar
+
+               sudo chmod +x /etc/rc.local
+
+3. Definir 'capability' em alguns comandos do Likwid (administrador)
+
+       sudo setcap cap_sys_rawio+ep /home/soft/likwid/bin/likwid-lua
+       sudo setcap cap_sys_rawio+ep /home/soft/likwid/sbin/likwid-accessD
+
+4. Acrescentar linhas abaixo em '/etc/profile':
+
+       export LIKWID_HOME="/home/soft/likwid"
+ 
+       if [ -d "${LIKWID_HOME}" ] ; then
+	   PATH="$PATH:${LIKWID_HOME}/bin:${LIKWID_HOME}/sbin"
+	   export LIKWID_LIB="${LIKWID_HOME}/lib"
+	   export LIKWID_INCLUDE="${LIKWID_HOME}/include"
+	   export LIKWID_MAN="${LIKWID_HOME}/man"
+	   export LD_LIBRARY_PATH="$LD_LIBRARY_PATH:${LIKWID_LIB}"
+	   export MANPATH="$MANPATH:${LIKWID_MAN}"
+       fi
+
+5.  Efetuar reboot e conferir permissões de acesso de '/dev/cpu/*/msr'.
+
+    Para verificar se LIKWID  está corretamente instalado e configurado,
+    executar:
+
+                likwid-topology -c -g
+                likwid-perfctr -a
+
+
+
+===== GUIA DE CONFIGURAÇÃO DE FREQUENCIA DE RELÓGIO EM LINUX ===============
+
+
+No item de (1) a (3), será necessário que se tenha permissão de administrador.
+
+1. Execute a seguinte linha de comando:
+
+   sudo echo "performance" > /sys/devices/system/cpu/cpufreq/policy3/scaling_governor
+
+2. Para retornar à frequencia original
+
+   sudo echo "powersave" > /sys/devices/system/cpu/cpufreq/policy3/scaling_governor 
+
+OBS.: Para permitir que qualquer  usuário possa executar os comandos dos
+      itens (1) e (2), mudar permissão do arquivo:
+
+      sudo chmod a+rw /sys/devices/system/cpu/cpufreq/policy3/scaling_governor 
+
+      E acrescentar o comando acima  (sem 'sudo') em '/etc/rc.local', em
+      alguma linha ANTES da última linha que contém 'exit 0'.
+
+3. Alternativamente, instale o pacote 'cpufrequtils' (via 'apt-get install cpufreputils')
+   e execute os passos abaixo:
+
+   (a) Para aumentar a frequência:
+   
+        sudo cpufreq-set -g performance
+   
+   (b) Para retornar à frequência original:
+   
+        sudo cpufreq-set -g powersave
+   
+   (c) Para verificar a frequência:
+   
+        cpufreq-info
+   
+
-- 
GitLab