|
1 | | -# SRDE User Guide |
| 1 | +# Connecting to SRDE |
2 | 2 |
|
3 | 3 | Remote access to the secure environment workspace via the Command Line Interface. The SRDE consists of two separate servers: |
4 | 4 | - The Workspace Host is where you access and analyze data |
@@ -162,3 +162,101 @@ And then on the bastion VM: |
162 | 162 | ```sh |
163 | 163 | ssh 10.0.0.2 |
164 | 164 | ``` |
| 165 | + |
| 166 | + |
| 167 | +## Connecting on MacOS/Linux |
| 168 | + |
| 169 | +### Install gcloud CLI |
| 170 | +Follow the [official guidelines](https://cloud.google.com/sdk/docs/install-sdk#installing_the_latest_version) to install the latest version of gcloud CLI locally on your computer. |
| 171 | + |
| 172 | +:::note |
| 173 | +After completing the gcloud installation, verify that the `gcloud` binary is in your $PATH environment variable. |
| 174 | + |
| 175 | +::: |
| 176 | + |
| 177 | +### Configure local gcloud settings |
| 178 | +Run the following command. It generates a link as shown below |
| 179 | + |
| 180 | +```sh |
| 181 | +gcloud auth login --no-launch-browser |
| 182 | +``` |
| 183 | + |
| 184 | + |
| 185 | + |
| 186 | +Copy the link and open your chrome browser in incognito mode to perform user sign in.Username is your NYU NetID email address. For e.g. [email protected] |
| 187 | + |
| 188 | + |
| 189 | +You will be redirected to the NYU SSO page and MFA verification through Duo Push. After successfully logging in, you will be asked to allow google SDK to access your account as shown below |
| 190 | + |
| 191 | + |
| 192 | + |
| 193 | +Pressing the “Allow” button on this page will present the authorization code. Copy the code and paste it in the terminal. If this step is successful, you should see this text printed to the console. **You are now logged in as [[email protected]]. ** |
| 194 | + |
| 195 | +### Connect to the workspace |
| 196 | +Follow the same instructions for connecting with Google Cloud Shell above, starting from section on setting project and zone above. |
| 197 | + |
| 198 | +## Connecting on Windows 10/11 |
| 199 | + |
| 200 | +### Start and Configure SSH-Agent Service |
| 201 | +Using an elevated PowerShell window (run as admin), execute the following command to install the SSH-Agent service and configure it to start automatically when you log into your machine: |
| 202 | +```ps |
| 203 | +Get-Service ssh-agent | Set-Service -StartupType Automatic -PassThru | Start-Service |
| 204 | +
|
| 205 | +``` |
| 206 | + |
| 207 | + |
| 208 | +### Install gcloud CLI |
| 209 | +Download the [Google Cloud CLI installer] (https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe) and run the installer |
| 210 | + |
| 211 | + |
| 212 | + |
| 213 | +Alternatively, run the following command to download and install: |
| 214 | +```ps |
| 215 | +(New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe") |
| 216 | +
|
| 217 | +& $env:Temp\GoogleCloudSDKInstaller.exe |
| 218 | +
|
| 219 | +``` |
| 220 | + |
| 221 | +### Install Git |
| 222 | +Download the Git Bash setup from the official website: https://git-scm.com/ and run the installer |
| 223 | + |
| 224 | + |
| 225 | +### Install Putty |
| 226 | +Download and install Putty from this link https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html |
| 227 | + |
| 228 | +Post installation verify that the Putty authentication agent is installed and available |
| 229 | + |
| 230 | +For 64-bit installer, you will find this executable at `C:/Program Files/PuTTY/pageant.exe` |
| 231 | + |
| 232 | + |
| 233 | +### Install Python (>version 3.0) |
| 234 | +Install Python from the official website:https://www.python.org/downloads/ |
| 235 | + |
| 236 | +Remember to check “Add python to the environment path.” ***add screenshot |
| 237 | + |
| 238 | +Make sure it's installed and available on PATH. On many systems Python comes pre-installed, you can try running the python command to start the Python interpreter to check and see if it is already installed. |
| 239 | + |
| 240 | + |
| 241 | + |
| 242 | +On windows you can also try the py command which is a launcher which is more likely to work. If it is installed you will see a response which will include the version number, for example: |
| 243 | + |
| 244 | + |
| 245 | + |
| 246 | + |
| 247 | +### Logging in: |
| 248 | +Authenticate gcloud by starting a new session of command line or powershell. initialize and login to gcloud with your account (you will be redirected to the browser for authentication) |
| 249 | +```ps |
| 250 | +gcloud auth login |
| 251 | +``` |
| 252 | + |
| 253 | + |
| 254 | + |
| 255 | + |
| 256 | + |
| 257 | + |
| 258 | + |
| 259 | + |
| 260 | + |
| 261 | + |
| 262 | + |
0 commit comments