Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Login to the Nginx server.  If you are using the project key pair it will look like this (make sure you have the key in your .ssh folder, get it from Nebula interface https://nebula.ncsa.illinois.edu/dashboard/project/access_and_security/:

    Code Block
    ssh -i ~/.ssh/<key> ubuntu@<vm floating ip address>


  2. Install Nginx:

    Code Block
    apt-get install nginx


  3. Edit nginx config 

    1. create and edit

      Code Block
      sudo vim /etc/nginx/sites-available/gltg 	# creates file name gltg and opens vim editor (change to your key name)


    2. populate config (this is bare min without ssl, more docs coming)

      Code Block
      server {
        listen 80;
        client_max_body_size 0;
      
        proxy_read_timeout 300;  # answer from server, 5 min
        proxy_send_timeout 300;  # chunks to server, 5 min
      
        proxy_set_header   Host $host;
        proxy_set_header   X-Real-IP $remote_addr;
        proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        port_in_redirect   off;
      
        root /usr/share/nginx/html;
        index index.html index.htm;
      
        # Deny all attempts to access hidden files
        # such as .htaccess, .htpasswd, .DS_Store (Mac).
        location ~ /\. {
          deny all;
        }
      
        location / {
            try_files $uri $uri/ /index.html;
        }
      
        rewrite ^/geodashboard$ /geodashboard/ permanent;
        location /geodashboard {
          proxy_pass http://<geodashboard floating IP>:9000;				# replace <geodashboard floating IP> with the floating IP of your geodashboard machine
        }
      
        rewrite ^/clowder$ /clowder/ permanent;
        location /clowder/ {
          proxy_pass http://<clowder floating IP>:9000;					# replace <clowder floating IP> with the floating IP of your geodashboard machine
        }
      }


    3. delete (soft link) of default config and enable new config

      Code Block
      sudo rm /etc/nginx/sites-enabled/default
      sudo ln -s /etc/nginx/sites-available/gltg /etc/nginx/sites-enabled/gltg


    4. Add (Edit) index file to root

      1. For the tutorial we will only put a redirect to the /geodashboard route.  If you want to put in a static web page with links to /geodashboard, /clowder, etc, please do - everyone will love you.

        Code Block
        sudo vim /usr/share/nginx/html			# This is the root path in the config we just created



      2. Add this text to file

        Code Block
        <meta http-equiv="refresh" content="0; url=http://<Floating IP>/geodashboard" />       <!-- <Floating IP> is of the nginx server where you are doing this -->


  4. Install geodashboard-v3 (as of this documentation, geodashboard-v2 runs on the geodashboard server, but uses the v3 search page which is installed on the nginx server)

    1. In the nginx root directory (where we put the redirect above), create a directory 'gd3' which contains the build files bundle.js, config.js, index.html.

      Code Block
      ls /usr/share/nginx/html/gd3						# if gd3 directory is in correct nginx root path, 'ls' will show you the v3 build files 
      bundle.js  config.js  index.html