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