| Table of Contents |
|---|
Introduction
Some EAS development activities require that the developer access an EAS Linux VM from their Windows machine to perform certain tasks, for example, to administer an EAS VM, or to perform database queries. This page describes how to use PuTTY and Secure Shell (SSH) to access an EAS Linux VM from a Windows machine to achieve those ends.
PuTTY
...
...
...
All of the screenshots that follow are from PuTTY 0.62.
Navigate to "Chapter 8: Using public keys for SSH authentication" of the online documentation, and read "Section 8.2 Using PuTTYgen, the PuTTY key generator" to begin generating the new private and public keys. The screenshots that follow illustrate the key steps in the process.
1 Run PuTTYgen.
2 Inspect the default parameter values, and then press the "Generate" button.
3 Move the mouse over the blank area that is in the Key pane for a few seconds to proceed.
...
| Tip |
|---|
The file names that are used below follow an optional naming convention of starting with the user's initials (in this example "jd" for Jane Doe), followed by an indication of the scope of the key's applicability (in this example "eas" for the Enterprise Addressing System), to account for a given individual possibly having more than one private key.
|
...
6 Exit the PuTTY Key Generator dialog.
...
SSH
PuTTY can be used to configure and save an SSH session. Navigate to "Chapter 2: Getting started with PuTTY" and read this short chapter before attempting to create an SSH session.
...
The appropriate IP addresses will be provided by an EAS administrator for any sessions that you need to create. Sensitive information has been redacted in the screenshots that follow.
1 Run PuTTY.
2 Under the Session category, enter the IP address of the target VM in the Host Name (or IP address) field, and specify port 2241 in the Port field. Also confirm that the connection type is "SSH".
3 Under "Authentication parameters", browse to the private key file (jd_eas_private_key.ppk) that was saved in Step 5 above.
4 The remainder of the configuration consists of default values, but if additional configuration is required, then "Chapter 4: Configuring PuTTY" should be consulted.
The following session names should be used to maintain consistency with standard EAS nomenclature. The session name for this example (eas-sf-dev-web) is highlighted in bold font in the table below.
...
eas-sf-dev-db
...
5 Return to the Session category to save this session. Enter the session name in the Saved Sessions field, and press the "Save" button.
6 Before the saved session can be tested, an EAS administrator must place your public key on the target VM, which should have been done in Step 7 above.
7 To test the saved session, select the saved session from the Saved Sessions list, press the "Load" button, and then press the "Open" button.
8 You will be prompted to log in to the target VM. Use the username that was given to you by the EAS administrator, and when prompted a second time, enter the passphrase that was used to create your private key in Step 4 above.
9 Congratulations, you should now be logged in to the target VM!
...
...
Create an SSH tunnel session if you intend to access an EAS database from pgAdmin (or another database client product) running on your Windows machine.
1 Run PuTTY.
...