@@ -4,49 +4,55 @@ title: Setup
4
4
root : .
5
5
---
6
6
7
- There are several pieces of software you will wish to install before the workshop. Though
8
- installation help will be provided at the workshop, we recommend that these tools are installed (or
9
- at least downloaded) beforehand.
7
+ There are several pieces of software you will wish to install before the
8
+ workshop. Though installation help will be provided at the workshop, we
9
+ recommend that these tools are installed (or at least downloaded) beforehand.
10
10
11
11
> ## Bash and SSH
12
12
>
13
- > This lesson requires a terminal application (` bash ` , ` zsh ` , or others) with the
14
- > ability to securely connect to a remote machine (` ssh ` ).
13
+ > This lesson requires a terminal application (` bash ` , ` zsh ` , or others) with
14
+ > the ability to securely connect to a remote machine (` ssh ` ).
15
15
{: .prereq}
16
16
17
17
## Where to type commands: How to open a new shell
18
18
19
- The shell is a program that enables us to send commands to the computer and receive output. It is
20
- also referred to as the terminal or command line.
19
+ The shell is a program that enables us to send commands to the computer and
20
+ receive output. It is also referred to as the terminal or command line.
21
21
22
- Some computers include a default Unix Shell program. The steps below describe some methods for
23
- identifying and opening a Unix Shell program if you already have one installed. There are also
24
- options for identifying and downloading a Unix Shell program, a Linux/UNIX emulator, or a program
25
- to access a Unix Shell on a server.
22
+ Some computers include a default Unix Shell program. The steps below describe
23
+ some methods for identifying and opening a Unix Shell program if you already
24
+ have one installed. There are also options for identifying and downloading a
25
+ Unix Shell program, a Linux/UNIX emulator, or a program to access a Unix Shell
26
+ on a server.
26
27
27
28
### Windows
28
29
29
- Computers with Windows operating systems do not automatically have a Unix Shell program installed.
30
- In this lesson, we encourage you to use an emulator included in Git for Windows, which gives you
31
- access to both Bash shell commands and Git. If you have attended a Software Carpentry workshop
32
- session, it is likely you have already received instructions on how to install Git for Windows.
30
+ Computers with Windows operating systems do not automatically have a Unix Shell
31
+ program installed. In this lesson, we encourage you to use an emulator included
32
+ in Git for Windows, which gives you access to both Bash shell commands and Git.
33
+ If you have attended a Software Carpentry workshop session, it is likely you
34
+ have already received instructions on how to install Git for Windows.
33
35
34
- Once installed, you can open a terminal by running the program Git Bash from the Windows start menu.
36
+ Once installed, you can open a terminal by running the program Git Bash from
37
+ the Windows start menu.
35
38
36
39
#### Reference
37
40
38
- * [ Git for Windows] ( https://gitforwindows.org/ ) &ndash ; * Recommended*
39
- * [ Windows Subsystem for Linux] ( https://docs.microsoft.com/en-us/windows/wsl/install-win10 )
40
- &ndash ; advanced option for Windows 10
41
+ * [ Git for Windows] ( https://gitforwindows.org/ ) &mdash ; * Recommended*
42
+ * [ Windows Subsystem for Linux] (
43
+ https://docs.microsoft.com/en-us/windows/wsl/install-win10 )
44
+ &mdash ; advanced option for Windows 10
41
45
42
46
> ## Alternatives to Git for Windows
43
47
>
44
- > Other solutions are available for running Bash commands on Windows. There is now a Bash shell
45
- > command-line tool available for Windows 10. Additionally, you can run Bash commands on a remote
46
- > computer or server that already has a Unix Shell, from your Windows machine. This can usually be
47
- > done through a Secure Shell (SSH) client. One such client available for free for Windows computers
48
- > is PuTTY. See the reference below for information on installing and using PuTTY, using the Windows
49
- > 10 command-line tool, or installing and using a Unix/Linux emulator.
48
+ > Other solutions are available for running Bash commands on Windows. There is
49
+ > now a Bash shell command-line tool available for Windows 10. Additionally,
50
+ > you can run Bash commands on a remote computer or server that already has a
51
+ > Unix Shell, from your Windows machine. This can usually be done through a
52
+ > Secure Shell (SSH) client. One such client available for free for Windows
53
+ > computers is PuTTY. See the reference below for information on installing and
54
+ > using PuTTY, using the Windows 10 command-line tool, or installing and using
55
+ > a Unix/Linux emulator.
50
56
>
51
57
> For advanced users, you may choose one of the following alternatives:
52
58
>
@@ -59,65 +65,71 @@ https://docs.microsoft.com/en-us/powershell/scripting/learn/remoting/ssh-remotin
59
65
>
60
66
> > ## Warning
61
67
> >
62
- > > Commands in the Windows Subsystem for Linux (WSL), Powershell, or Cygwin may differ slightly
63
- > > from those shown in the lesson or presented in the workshop. Please ask if you encounter such
64
- > > a mismatch &ndash ; you're probably not alone.
68
+ > > Commands in the Windows Subsystem for Linux (WSL), Powershell, or Cygwin
69
+ > > may differ slightly from those shown in the lesson or presented in the
70
+ > > workshop. Please ask if you encounter such a mismatch &mdash ; you're
71
+ > > probably not alone.
65
72
> {: .challenge}
66
73
{: .discussion}
67
74
68
75
### macOS
69
76
70
- On macOS, the default Unix Shell is accessible by running the Terminal program from the ` /Application/Utilities ` folder in Finder.
77
+ On macOS, the default Unix Shell is accessible by running the Terminal program
78
+ from the ` /Application/Utilities ` folder in Finder.
71
79
72
80
To open Terminal, try one or both of the following:
73
81
74
- * In Finder, select the Go menu, then select Utilities. Locate Terminal in the Utilities folder and
75
- open it.
76
- * Use the Mac ‘Spotlight’ computer search function. Search for: ` Terminal ` and press
77
- <kbd >Return</kbd >.
82
+ * In Finder, select the Go menu, then select Utilities. Locate Terminal in the
83
+ Utilities folder and open it.
84
+ * Use the Mac ‘Spotlight’ computer search function. Search for: ` Terminal ` and
85
+ press <kbd >Return</kbd >.
78
86
79
87
#### Reference
80
88
81
- [ How to Use Terminal on a
82
- Mac ] ( http://www.macworld.co.uk/feature/mac-software/how-use-terminal-on-mac-3608274/ )
89
+ [ How to Use Terminal on a Mac ] (
90
+ http://www.macworld.co.uk/feature/mac-software/how-use-terminal-on-mac-3608274/ )
83
91
84
92
### Linux
85
93
86
- On most versions of Linux, the default Unix Shell
87
- is accessible by running the [ (Gnome) Terminal] ( https://help.gnome.org/users/gnome-terminal/stable/ )
88
- or [ (KDE) Konsole] ( https://konsole.kde.org/ ) or [ xterm] ( https://en.wikipedia.org/wiki/Xterm ) , which
89
- can be found via the applications menu or the search bar.
94
+ On most versions of Linux, the default Unix Shell is accessible by running the
95
+ [ (Gnome) Terminal] ( https://help.gnome.org/users/gnome-terminal/stable/ ) or
96
+ [ (KDE) Konsole] ( https://konsole.kde.org/ ) or
97
+ [ xterm] ( https://en.wikipedia.org/wiki/Xterm ) , which can be found via the
98
+ applications menu or the search bar.
90
99
91
100
### Special cases
92
101
93
- If none of the options above address your circumstances, try an online search for: ` Unix shell [your operating system] ` .
102
+ If none of the options above address your circumstances, try an online search
103
+ for: ` Unix shell [your operating system] ` .
94
104
95
105
## SSH for Secure Connections
96
106
97
- All students should have an SSH client installed. SSH is a tool that allows us to connect to and
98
- use a remote computer as our own.
107
+ All students should have an SSH client installed. SSH is a tool that allows us
108
+ to connect to and use a remote computer as our own.
99
109
100
110
### Windows
101
111
102
112
Git for Windows comes with SSH preinstalled: you do not have to do anything.
103
113
104
114
> ## GUI Support
105
115
>
106
- > If you know that the software you will be running on the cluster requires a graphical user
107
- > interface (a GUI window needs to open for the application to run properly), please install
108
- > [ MobaXterm] ( http://mobaxterm.mobatek.net ) Home Edition.
116
+ > If you know that the software you will be running on the cluster requires a
117
+ > graphical user interface (a GUI window needs to open for the application to
118
+ > run properly), please install [ MobaXterm] ( http://mobaxterm.mobatek.net ) Home
119
+ > Edition.
109
120
{: .discussion}
110
121
111
122
### macOS
112
123
113
- macOS comes with SSH pre-installed: you do not have to do anything.
124
+ macOS comes with SSH pre-installed: you do not have to do anything.
114
125
115
126
> ## GUI Support
116
127
>
117
- > If you know that the software you will be running requires a graphical user interface, please
118
- > install [ XQuartz] ( www.xquartz.org ) .
128
+ > If you know that the software you will be running requires a graphical user
129
+ > interface, please install [ XQuartz] ( www.xquartz.org ) .
119
130
{: .discussion}
120
131
121
132
### Linux
122
133
123
- Linux comes with SSH and X window support preinstalled: you do not have to do anything.
134
+ Linux comes with SSH and X window support preinstalled: you do not have to do
135
+ anything.
0 commit comments