]> code.communitydata.science - nu-vpn-proxy.git/blob - README-CDSC
incorporating a pointer to our wiki page re issues w openconnect v8.2 and above
[nu-vpn-proxy.git] / 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

Community Data Science Collective || Want to submit a patch?