AWS Marketplace

{{toc}}

# Usage Instructions

## Getting started

1. Launch the product via 1-Click

2. Use a web browser to access the Admin console at: http://[ec2-ip]:9000, where [ec2_ip] is the public ip provided by Amazon for your instance.

3. Log in using the following credentials only the first time and then you will be asked to change the password in order to enter the application:

   * Username: admin

   * Password: Your instance id

You can also access your instance via SSH using the username and your Amazon private key.

The **username** depends on the operative system:

* Centos 9 Stream: 'ec2-user'

* Other Centos: 'centos'

* Ubuntu: 'ubuntu'

* Rocky Linux: 'rocky'

## Installation details

SonarQube is deployed in /usr/java/sonarqube-[version] directory, which is linked to /usr/java/sonarqube.

Server service is configured with systemd.

View status server:

``` shell

$ sudo systemctl status sonarqube

```

Stop server:

``` shell

$ sudo systemctl stop sonarqube

```

Start server:

``` shell

$ sudo systemctl start sonarqube

```

### PostgreSQL

SonarQube is configurated with the PostgreSQL database.

View status server:

``` shell

$ sudo systemctl status postgresql

```

Stop server:

``` shell

$ sudo systemctl stop postgresql

```

Start server:

``` shell

$ sudo systemctl start postgresql

```

## Other useful data

**Location of sensitive information**

All the information is saved in the database.

In PostgreSQL the data folder is /var/lib/pgsql/data

**Encryption configuration**

There is no encrypted data.

**Changing system credentials**

To change the SonarQube you have to go to the Administration section, Security subsection, select users in the menu and, in your user press the action button and select "Enter a new Password" .

**Instructions on how the user interacts with SonarQube to decrypt necessary data**

You can use the SonarQube management console to view all necessary data.

**How to assess and monitor the health and proper function of the application**

1. Navigate to your Amazon EC2 console and verify that you're in the correct region.

2. Choose Instance and select your launched instance.

3. Select the server to display your metadata page and choose the Status checks tab at the bottom of the page to review if your status checks passed or failed.

## Additional resources

* SonarQube official site: https://www.sonarqube.org

* PostgreSQL: https://www.postgresql.org