SonarQube安装和使用以及错误排查（sonarqube8.4+postgresql9.5+jdk11）

浅浅的花香味﹌ 2023-03-03 11:24 108阅读 0赞

## 一、安装前准备 ##

**（1）https://docs.sonarqube.org/7.9/requirements/requirements/查看SonarQube当前版本的软硬件支持情况  
（2）SonarQube 依赖于Java 环境，需要安装相对应版本的JDK  
（3）SonarQube从7.7以上开始不支持MySql数据库（7.7及以下版本支持）**

## 二、开始安装 ##

### JAVA环境安装： ###

JDK11 下载地址:https://www.oracle.com/java/technologies/javase-jdk11-downloads.html  
其他下载地址：https://pan.baidu.com/s/1dzyHZHSAs1NFsjhpTUArUw  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYXRvbmcxNTE_size_16_color_FFFFFF_t_70]

#### 1、创建安装目录 ####

mkdir -p /usr/local/install

#### 2、解压缩JDK的tar包 ####

tar -zxvf JDK

#### 3、移动解压缩后的文件到安装目录 ####

mv jdk-13.0.2 /usr/local/install

#### 4、添加环境变量 ####

vim /etc/profile
    export JAVA_HOME=/usr/local/install/jdk-11
    export PATH=$JAVA_HOME/bin:$PATH

#### 5、命令更新配置文件 ####

source /etc/profile

#### 6、验证 ####

java -version

## Postgresql安装9.5（Ubuntu） ##

$ apt -y install postgresql postgresql-contrib
    
    #安装完成后，默认会增加一个postgres用户，需要对该
    #用户设置密码，并利用这个用户创建新的数据库用户提供给sonar使用
    
    #为postgres用户设置密码
    passwd postgres
    # 切换到postgres用户
    su - postgres
    # 新建postgres数据库用户 sonar
    createuser sonar  # 创建用户
    # 登录数据库
    psql
    # 创建数据库sonar
    CREATE DATABASE sonar WITH ENCODING 'UTF8' OWNER sonar TEMPLATE=template0;
    
    alter user sonar with password 'sonar';           #设置sonar用户密码(否则会导致连不上数据库)
    alter role sonar createdb;alter role sonar superuser;alter role sonar createrole;    #给sonar授权
    alter database sonar owner to sonar；      #更改sonar数据库拥有者(这一步是必须的，否则会sonarqube会连接失败)
    # 退出数据库连接
    \q

### SonarQube安装8.4（Ubuntu） ###

#### 1、下载 ####

将下载的sonarqube-8.4.1.35646.zip包解压到目录下，并将sonarqube目录权限赋予给启动用户：

chown -R sonar:sonar sonarqube

![在这里插入图片描述][20200731111737959.png]

注意：

*  不要解压在以数字开头的目录里
 *  不要使用root运行sonar，创建一个用户只来启动sonar服务

#### 2、配置 ####

sonarqube-8.4.1.35646/conf/sonar.properties

数据库账号密码：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYXRvbmcxNTE_size_16_color_FFFFFF_t_70 1]

数据库连接地址：去掉qube?currentSchema=my\_schema部分。可以尝试localhost不起作用再修改127.0.0.1  
![在这里插入图片描述][20200731111821565.png]

webIP（本机IP）、Port  
![在这里插入图片描述][20200731111838516.png]

ES存储路径：  
![在这里插入图片描述][2020073111195730.png]

创建目录并赋予权限给sonar用户和用户组

mkdir -p /data/sonarqube/data
    mkdir -p /data/sonarqube/temp
    chown -R sonar:sonar /data/

#### 3、启动 ####

su - sonar  切换用户
    ./sonar.sh start    (start/restart/stop/status)

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYXRvbmcxNTE_size_16_color_FFFFFF_t_70 2]  
注意：

*  不能直接su sonar切换用户，JDK会没有权限，必须su - sonar

## 三、错误排查 ##

### 1、启动成功后web端不能访问 ###

（1）首先查看sonarqube是否启动后又停止，多次查看sonarqube状态  
（2）确定启动，查看端口是否放开、或被占用  
telnet IP Port

（3）查看sonar.log是否存在错误日志  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYXRvbmcxNTE_size_16_color_FFFFFF_t_70 3]

### 2、ES、sonarqube运行正常的 ###

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYXRvbmcxNTE_size_16_color_FFFFFF_t_70 4]

### 3、\[1\]: max virtual memory areas vm.max\_map\_count \[65530\] is too low, increase to at least \[262144\]错误 ###

![在这里插入图片描述][20200731112218118.png]

查看本机的内核参数

sysctl vm.max_map_count
    sysctl fs.file-max
    ulimit -n

![在这里插入图片描述][20200731112230601.png]

动态修改值（重启后修改的值还原）：

sysctl -w vm.max_map_count=262144
    sysctl -w fs.file-max=65536
    ulimit -n 65536

永久设置，修改/etc/sysctl.d/99-sonarqube.conf（或/etc/sysctl.conf文件）：

vi /etc/sysctl.conf
    
    vm.max_map_count=262144
    fs.file-max=65536

在/etc/profile文件末尾添加ulimit -n 65536

vi /etc/profile
    
    ulimit -n 65536           #保存后运行#source /etc/profile 使其生效
    
    source /etc/profile

### 4、JVM问题 ###

猜测是由于su sonar方式切换用户导致没有JDK权限  
![在这里插入图片描述][20200731112316151.png]

### 5、web中的日志，数据库问题 ###

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYXRvbmcxNTE_size_16_color_FFFFFF_t_70 5]

（1）数据库连接地址由localhost修改成127.0.0.1  
（2）检查用户名密码  
（3）检查数据库设置（是否创建库、授权等）

psql   #进入命令行
    \l     #查看库情况
    \du    #查看用户

## 四、Sonar-Scanner扫描器安装及使用方法（用于扫描项目） ##

官方下载地址：https://docs.sonarqube.org/latest/analysis/scan/sonarscanner/

\#丢到/usr/local/下面解压  
unzip sonar-scanner-cli-4.2.0.1873-linux.zip  
cd sonar-scanner-4.2.0.1873-linux/

vim conf/sonar-scanner.propertie \#改下配置

修改配置：  
![在这里插入图片描述][2020073111240613.png]

保存退出后，创建软连接，将sonar-scanner改为全局即可使用（修改成自己的目录）：

ln -s /usr/local/sonar-scanner-4.2.0.1873-linux/bin/sonar-scanner /usr/bin/sonar-scanner

重新启动sonarqube。  
访问web页面（默认本机IP:port/about）：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYXRvbmcxNTE_size_16_color_FFFFFF_t_70 6]

账户密码：admin/admin  
安装中文插件：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYXRvbmcxNTE_size_16_color_FFFFFF_t_70 7]

参考文章：https://blog.51cto.com/14268033/2475706  
https://www.jianshu.com/p/398cd10986ba  
https://blog.csdn.net/shm19990131/article/details/107527755

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYXRvbmcxNTE_size_16_color_FFFFFF_t_70]: /images/20230208/4f8aac3182254b2aa0fc4058f00f50c3.png
[20200731111737959.png]: /images/20230208/c327e8fbad154959abea88e41e3ad3c0.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYXRvbmcxNTE_size_16_color_FFFFFF_t_70 1]: /images/20230208/11936035ce6c4e0ea71571902b7604fd.png
[20200731111821565.png]: /images/20230208/b1fddf9286b84b70845667aedcff84f1.png
[20200731111838516.png]: /images/20230208/4600c9c0e1a44d9f8757f4a0892bfe5c.png
[2020073111195730.png]: /images/20230208/e15b46b876a34c9b94236ae29e0868ad.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYXRvbmcxNTE_size_16_color_FFFFFF_t_70 2]: /images/20230208/d5ad08827fa14518959009fe001f6f9b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYXRvbmcxNTE_size_16_color_FFFFFF_t_70 3]: /images/20230208/95f7454a4320436d923e42b266d94d4f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYXRvbmcxNTE_size_16_color_FFFFFF_t_70 4]: /images/20230208/3a3615c308b745e0b54f49684d088343.png
[20200731112218118.png]: /images/20230208/f1b0704678914145a8cf75f2535a1a23.png
[20200731112230601.png]: /images/20230208/ec70205cb024465998c317d992b98436.png
[20200731112316151.png]: /images/20230208/2bf9d9cd50314b519685438d7267a3cc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYXRvbmcxNTE_size_16_color_FFFFFF_t_70 5]: /images/20230208/aa58aca4b1334536b22798c5611c22b6.png
[2020073111240613.png]: /images/20230208/3606fc4abee74e51864a3ed6c9172f92.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYXRvbmcxNTE_size_16_color_FFFFFF_t_70 6]: /images/20230208/e3c1cd6eabc6450896bd4ba7aa0bf4b0.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ppYXRvbmcxNTE_size_16_color_FFFFFF_t_70 7]: /images/20230208/3005c0796299497db2f13cf369bb85db.png