This application pulls user and system allocation/usage data from the Texas Advanced Computing Center (TACC) Allocation System (TAS) database. Data is retrieved in monthly .xlsl files. Then, using the Pandas and Plotly Dash external Python libraries, an Nginx web server, and a TACC-partitioned VM, it creates a visual, interactive data dashboard with filters, charts, and graphs.

The application serves two separate dashboards--a full version containing sensitive internal user data, and a lite version that only displays overall trends.

The full web app is currently hosted here. Login is required. The lite web app is currently hosted here.

Installation Instructions

1. On your VM, pull the application files from the GitHub repository.

   git clone git@github.com:austin-darrow/dash-dashboard.git

2. In ./assets/data/monthly reports, add all monthly reports. Reports should follow the following naming convention: utrc_report_YYYY-MM-DD_to_YYYY-MM-DD.xlsx (e.g. utrc_report_2019-12-01_to_2020-01-01.xlsx).
3. In ./assets/data, add a file named accounts.txt. This file should contain a single json dictionary with usernames as keys and passwords as values:

   {
   "username1": "password1",
   "username2": "password2"
   }

4. Setup the Nginx web server configuration file to reverse proxy at port 8050 and 8051.

   # /etc/nginx/sites-available/dashboard.conf
   server {
       listen 80;
       listen [::]:80;
   
       # Change to domain name
       server_name 129.114.38.28;
   
       location / {
               proxy_pass http://localhost:8050;
       }
   }

5. Install Python libraries.

   pip install -r requirements.txt

6. Start the applications.

   docker compose up --build -d

Updating Instructions

1. Make changes inside the app directory.
2. While inside the main app directory, stop and restart the docker compose service.

   docker compose stop
   docker compose up --build -d