StorageGRID Webscale Accounting: Quota and Disk Usage

This is a php-based code that provides a web-interface to show a list of tenants, quota and disk usage in a read-only view. The workflow is simple, you provide login credentials and API endpoint. RESTful API calls are made on your behalf and the result is presented in a table with pagination, sort and filter features.

Pre-requisites

• git
• docker
• docker-compose

Installation

1. Clone this:

    git clone https://github.com/adlytaibi/sgws-acnt
   

    cd sgws-acnt
   

2. SSL certificates

    mkdir web/sslkeys
   

   1. Self-sign your own certificates: (modify web to match your server)

       openssl req -x509 -nodes -newkey rsa:4096 -keyout web/sslkeys/host.key -out web/sslkeys/host.pem -days 365 -subj "/C=CA/ST=Ontario/L=Toronto/O=Storage/OU=Team/CN=web"
      

   2. Or sign your SSL certificate with a CA:

      1. Create private key, generate a certificate signing request

          openssl genrsa -out web/sslkeys/host.key 2048
         

      2. Create a Subject Alternate Name configuration file san.cnf in ‘web/sslkeys’

          [req]
          distinguished_name = req_distinguished_name
          req_extensions = v3_req
          prompt = no
          default_md = sha256
          [req_distinguished_name]
          C = CA
          ST = Ontario
          L = Toronto
          O = Storage
          OU = Storage
          CN = acnt
          [v3_req]
          keyUsage = keyEncipherment, dataEncipherment
          extendedKeyUsage = serverAuth
          subjectAltName = @alt_names
          [alt_names]
          DNS.1 = acnt
          DNS.2 = acnt.acme.net
          IP.1 = 1.2.3.4
         

      3. Generate a certificate signing request

          cd web/sslkeys/
          openssl req -new -sha256 -nodes -key host.key -out acnt.csr -config san.cnf
         

      4. In your CA portal use the acnt.csr output and the following SAN entry to sign the certificate, you should get a certnew.pem that can be saved as host.pem

          san:dns=acnt.acme.net&ipaddress=1.2.3.4
         

      5. Copy your host.pem certificate files to web/sslkeys

3. docker-compose

    docker-compose up -d
   

4. The login page can be accessed using the URL below:

    https://<IP_address>
   

   (or if accessing from the same guest https://localhost)

   

5. Enter the API endpoint which is typically your GMI (Grid Management Interface) or Admin node’s hostname or IP_address. The user you login with requires a minimum of Tenant Accounts group management permission.

   

   

6. Sort, filter, pagination and logout to clear API authorization

   

Further reading

• Docker Compose
• Apache
• PHP
• DataTables
• Bootstrap
• jQuery
• Httpful

Notes

This is not an official NetApp repository. NetApp Inc. is not affiliated with the posted examples in any way.