README-CDSC

   1 ===========================
   2 == INSTALLATION ===========
   3 ===========================
   4
   5 1.
   6
   7 Install prerequisites. This will include:
   8
   9   sudo apt install python3-gi gir1.2-gtk-3.0 gir1.2-webkit2-4.0 openconnect ocproxy netcat-openbsd
  10
  11 Also, note that you'll need at least version 8 of openconnect but NOT a version that is greater 8.2 or less than 9.0. If you're not sure what you've got, run:
  12
  13   openconnect --version
  14
  15 These scripts did not seem to work at all due a bug in openconnectversion 8.2+. The bug does appear to have been fixed in openconnect version 9. Consult https://wiki.communitydata.science/CommunityData:Northwestern_VPN for more details.
  16
  17 2.
  18
  19 Install this directory into: ~/bin/nu-vpn-proxy
  20
  21 3.
  22
  23 Change your System UUID in the script. You can get this with the command:
  24
  25   sudo dmidecode|grep UUID
  26
  27 You should see a line like:
  28
  29   UUID: deadbeef-dead-beef-dead-beefdeadbeef
  30
  31 Edit the file hipreport-modified.sh to change the variable HOSTID so that it is
  32 equal to this number. Change the line that says
  33 "deadbeef-dead-beef-dead-beefdeadbeaf" so that it lists your UUID.
  34
  35 4. [optional]
  36
  37 Change bmh1867 to your username and add the following stanza text to your
  38 ~/.ssh/config:
  39
  40 Host kibo kibo.soc.northwestern.edu
  41     Hostname kibo.soc.northwestern.edu
  42     User bmh1867
  43     ProxyCommand ~/bin/nu-vpn-proxy/ssh-vpn-proxy %h %p
  44     ForwardAgent yes
  45     ServerAliveInterval 120
  46
  47 ===========================
  48 == USAGE ==================
  49 ===========================
  50
  51 There are two ways to use this.
  52
  53 1. *Only* for SSH connections to kibo.
  54
  55 This should be just as simple as running:
  56
  57   ssh kibo
  58
  59 You can run the command mulptiple time and it should work. When you close the
  60 first connection though, it will disconnect all of your connections.
  61
  62 2. Your entire connection.
  63
  64 Run the following command:
  65
  66   ~/bin/nu-vpn-proxy/openconnect_command-general.sh
  67
  68 While this command is running, you should be connected through the VPN. Run
  69 Ctrl-C to disconnect.
  70