UMIACS - User contributions [en]

MacOSPrinting

2016-02-26T20:19:12Z

Dustinb:

__NOTOC__
We support printing from user managed Mac OS X 10.8 or later machines. Please note that you have to be on a UMIACS network directly or connected to the [[VPN]].

[[Image:Osx-print00.png|right|100px]]
=System Preferences=
To start, open your System Preferences from the Dock or Applications folder. Once you have opened it, click '''Printers & Scanners'''.

[[Image:osx-print01.png|right|100px]]

=Print & Fax=
When the '''Printers & Scanners''' window appears, create a new local printer by clicking the '''+''' icon in the lower left corner of the first pane in the window.

=Add Printer=
This will bring up a Add Printer dialog. Please ensure that you have selected IP.

'''Note:''' If you just want basic printing, use the steps below. If you would like to enable all the advanced options for the printer, jump over this section to '''"Enabling Advanced Printer Options"'''.

* Set Protocol to '''Internet Printing Protocol - IPP'''
* Set Address to '''print.umiacs.umd.edu'''
* Set the Queue to printers/queue; in this example for cps3142 it would be '''printers/cps3142'''. You have to make sure the queue is prefixed by '''printers/'''. For clarification, the queue is typically the printer name.
* Set Name to the name of the printer you are trying to use. This makes it easily Identifiable in your list of printers.
* It will always select '''Generic Postscript Printer'''. If you need to access the more advanced features of a queue/printer you will need take extra steps, please see the Advanced section at the bottom of this page.
* Select Add
* You will be asked about enabling duplex. If you know the printer has the option, which is true for most of our printers, go ahead and enable it. Then hit OK. If you're not sure, just leave it disabled. You can always enable it after the queue is added.

[[Image:osx-print02.png]]

You should now be able to print to this printer/queue from any Mac OS X print menu.

=Enabling Advanced Printer Features=
Some printers may have features not accessible with the default drivers provided above. If this is the case, follow the guide below to identify, and install your print drivers from their manufacturer.

'''Note:''' If you already installed the printer with generic drivers, you will need to highlight the printer and click '''-''', before attempting to add it again. You may also need a system update to get the latest drivers from Apple, if your printer does not have software drivers listed in the next steps.

'''Step 1:''' Locate your printers name and search for its Make and Model here: http://print.umiacs.umd.edu/printers/

'''Step 2:''' Follow the '''Add Printer''' steps above until you get to '''Generic Postscript Printer'''. Select '''Software''', then '''Add'''.

[[Image:PrinterSoftwareSelection.png]]

'''Step 3:''' A window labeled "Printer Software" will now pop up. Scroll thru the list to find your specific make and model of printer. Click on it, and hit Ok.

[[Image:PrinterSoftwareList.png]]

'''Step 4:''' Click Add on the next window and it should install your printers software suite. You should have a list of options (if they are available) that looks similar this:

[[Image:AdvPrinterOptions.png]]

'''Final Step:''' Enable the Options you wish to use, Click '''OK'''. You should now be able to print to this printer/queue from any Mac OS X print menu.

File:Osx-print01.png

2016-02-26T20:18:40Z

Dustinb: Dustinb uploaded a new version of "File:Osx-print01.png"

MacOSPrinting

2016-02-26T20:17:30Z

Dustinb:

__NOTOC__
We support printing from user managed Mac OS X 10.8 or later machines. Please note that you have to be on a UMIACS network directly or connected to the [[VPN]].

[[Image:Osx-print00.png|right|100px]]
=System Preferences=
To start, open your System Preferences from the Dock or Applications folder. Once you have opened it, click '''Printers & Scanners'''.

[[Image:Osx-print01.png|right|100px]]

=Print & Fax=
When the '''Printers & Scanners''' window appears, create a new local printer by clicking the '''+''' icon in the lower left corner of the first pane in the window.

=Add Printer=
This will bring up a Add Printer dialog. Please ensure that you have selected IP.

'''Note:''' If you just want basic printing, use the steps below. If you would like to enable all the advanced options for the printer, jump over this section to '''"Enabling Advanced Printer Options"'''.

* Set Protocol to '''Internet Printing Protocol - IPP'''
* Set Address to '''print.umiacs.umd.edu'''
* Set the Queue to printers/queue; in this example for cps3142 it would be '''printers/cps3142'''. You have to make sure the queue is prefixed by '''printers/'''. For clarification, the queue is typically the printer name.
* Set Name to the name of the printer you are trying to use. This makes it easily Identifiable in your list of printers.
* It will always select '''Generic Postscript Printer'''. If you need to access the more advanced features of a queue/printer you will need take extra steps, please see the Advanced section at the bottom of this page.
* Select Add
* You will be asked about enabling duplex. If you know the printer has the option, which is true for most of our printers, go ahead and enable it. Then hit OK. If you're not sure, just leave it disabled. You can always enable it after the queue is added.

[[Image:osx-print02.png]]

You should now be able to print to this printer/queue from any Mac OS X print menu.

=Enabling Advanced Printer Features=
Some printers may have features not accessible with the default drivers provided above. If this is the case, follow the guide below to identify, and install your print drivers from their manufacturer.

'''Note:''' If you already installed the printer with generic drivers, you will need to highlight the printer and click '''-''', before attempting to add it again. You may also need a system update to get the latest drivers from Apple, if your printer does not have software drivers listed in the next steps.

'''Step 1:''' Locate your printers name and search for its Make and Model here: http://print.umiacs.umd.edu/printers/

'''Step 2:''' Follow the '''Add Printer''' steps above until you get to '''Generic Postscript Printer'''. Select '''Software''', then '''Add'''.

[[Image:PrinterSoftwareSelection.png]]

'''Step 3:''' A window labeled "Printer Software" will now pop up. Scroll thru the list to find your specific make and model of printer. Click on it, and hit Ok.

[[Image:PrinterSoftwareList.png]]

'''Step 4:''' Click Add on the next window and it should install your printers software suite. You should have a list of options (if they are available) that looks similar this:

[[Image:AdvPrinterOptions.png]]

'''Final Step:''' Enable the Options you wish to use, Click '''OK'''. You should now be able to print to this printer/queue from any Mac OS X print menu.

File:Osx-print01.png

2016-02-26T20:17:01Z

Dustinb: Dustinb uploaded a new version of "File:Osx-print01.png"

MacOSPrinting

2016-02-26T20:16:13Z

Dustinb:

File:Osx-print00.png

2016-02-26T20:13:41Z

Dustinb: Dustinb uploaded a new version of "File:Osx-print00.png"

File:PrinterSoftwareSelection.png

2016-02-26T20:09:03Z

Dustinb: Dustinb uploaded a new version of "File:PrinterSoftwareSelection.png"

Example of selecting a drop down menu for printer software selection in Osx Mavericks

File:AdvPrinterOptions.png

2016-02-26T20:02:17Z

Dustinb: Dustinb uploaded a new version of "File:AdvPrinterOptions.png"

Shows what advanced printer options should look like in OSX Mavericks

File:PrinterSoftwareList.png

2016-02-26T20:01:25Z

Dustinb: Dustinb uploaded a new version of "File:PrinterSoftwareList.png"

Shows Osx Mavericks Printer Software List

File:Osx-print02.png

2016-02-26T19:19:19Z

Dustinb: Dustinb uploaded a new version of "File:Osx-print02.png"

MacOSPrinting

2016-02-12T20:36:15Z

Dustinb:

__NOTOC__
We support printing from user managed Mac OS X 10.8 or later machines. Please note that you have to be on a UMIACS network directly or connected to the [[VPN]].

[[Image:osx-print00.png|right|100px]]
=System Preferences=
To start, open your System Preferences from the Dock or Applications folder. Once you have opened it, click '''Printers & Scanners'''.

[[Image:osx-print01.png|right|100px]]

=Print & Fax=
When the '''Printers & Scanners''' window appears, create a new local printer by clicking the '''+''' icon in the lower left corner of the first pane in the window.

=Add Printer=
This will bring up a Add Printer dialog. Please ensure that you have selected IP.

'''Note:''' If you just want basic printing, use the steps below. If you would like to enable all the advanced options for the printer, jump over this section to '''"Enabling Advanced Printer Options"'''.

* Set Protocol to '''Internet Printing Protocol - IPP'''
* Set Address to '''print.umiacs.umd.edu'''
* Set the Queue to printers/queue; in this example for cps3142 it would be '''printers/cps3142'''. You have to make sure the queue is prefixed by '''printers/'''. For clarification, the queue is typically the printer name.
* Set Name to the name of the printer you are trying to use. This makes it easily Identifiable in your list of printers.
* It will always select '''Generic Postscript Printer'''. If you need to access the more advanced features of a queue/printer you will need take extra steps, please see the Advanced section at the bottom of this page.
* Select Add
* You will be asked about enabling duplex. If you know the printer has the option, which is true for most of our printers, go ahead and enable it. Then hit OK. If you're not sure, just leave it disabled. You can always enable it after the queue is added.

[[Image:osx-print02.png]]

You should now be able to print to this printer/queue from any Mac OS X print menu.

=Enabling Advanced Printer Features=
Some printers may have features not accessible with the default drivers provided above. If this is the case, follow the guide below to identify, and install your print drivers from their manufacturer.

'''Note:''' If you already installed the printer with generic drivers, you will need to highlight the printer and click '''-''', before attempting to add it again. You may also need a system update to get the latest drivers from Apple, if your printer does not have software drivers listed in the next steps.

'''Step 1:''' Locate your printers name and search for its Make and Model here: http://print.umiacs.umd.edu/printers/

'''Step 2:''' Follow the '''Add Printer''' steps above until you get to '''Generic Postscript Printer'''. Select '''Software''', then '''Add'''.

[[Image:PrinterSoftwareSelection.png]]

'''Step 3:''' A window labeled "Printer Software" will now pop up. Scroll thru the list to find your specific make and model of printer. Click on it, and hit Ok.

[[Image:PrinterSoftwareList.png]]

'''Step 4:''' Click Add on the next window and it should install your printers software suite. You should have a list of options (if they are available) that looks similar this:

[[Image:AdvPrinterOptions.png]]

'''Final Step:''' Enable the Options you wish to use, Click '''OK'''. You should now be able to print to this printer/queue from any Mac OS X print menu.

SecureShell

2015-07-17T18:52:18Z

Dustinb: /* X11 Forwarding */

Secure Shell (or [http://en.wikipedia.org/wiki/Secure_Shell SSH]) is a network protocol allowing two computers to exchange data securely over an insecure network. By default, use of SSH brings the user to a terminal, but the protocol can be used for other types of data transfer such as [[SFTP]] and [[SCP]].

==Connecting to an SSH Server==
Under Linux and Mac OS X, the following command from a terminal will connect a client computer to the UMIACS [[OpenLAB]].
# ssh bkirz@openlab.umiacs.umd.edu
This will give you access to a terminal on any one of the [[OpenLAB]] servers. Note that by default you will not have access to applications that require X11 to run.

All UMIACS Windows hosts are installed with SSH Secure Shell Client. Alternatively, users can install these software on their personal machines:

* [http://www.chiark.greenend.org.uk/~sgtatham/putty/ PuTTY]
* [http://ttssh2.sourceforge.jp/ ttssh2]

Alternatively, all users can launch terminal sessions [[JuniperVPNTerminalSession| through the Juniper VPN web interface.]]

==X11 Forwarding==
By default, SSH only gives the user shell access to a host. Enabling X11 Forwarding allows users to run applications with Graphical User Interfaces.

Under Linux and Mac OS X, the following command from a terminal will connect a client computer to the UMIACS [[OpenLAB]] using X11 Forwarding.
# ssh '''-Y''' bkirz@openlab.umiacs.umd.edu

Under Mac OS X, [http://xquartz.macosforge.org/landing/ xQuartz] is required on the client machine to forward X sessions from the remote session.

If you do not have Cygwin, you will need to forward X through
[http://sourceforge.net/projects/vcxsrv/ VcXsrv] or
[http://www.straightrunning.com/XmingNotes/ Xming].
First, enable X forwarding on your secure ssh client. The option is under tunneling in the ssh client settings, shown below. This only has to be done once.

[[Image:sshXForward.jpg]]

Next, click save in the main ssh appication window to save this setting.

After this has been done, every time you want to use X forwarding, you need to make sure VcXsrv or Xming has been started (it will appear in your task tray) through the start menu programs.
Now, you will be able to use Xwindow programs from your ssh client.

==SSH Tunneling==

You can tunnel one or more ports through an SSH connection such that your packets will look like they are coming from the host you are tunneling to. This is helpful for services that you would be normally blocked by a firewall.

Please see the [[SecureShellTunneling]] page for more information.

==SSH Keys (and Passwordless SSH)==

There are some situations where it is important to be able to ssh without entering a password. This is mostly required when working in clusters. This is done using ssh keys. Instead of authenticating with a password, ssh can use a pre-defined set of encryption keys to establish an authorized connection.
To setup passwordless ssh, do the following.

First, you will need to create a ssh [http://en.wikipedia.org/wiki/Key_pair key pair]. It is possible to use a password that you will need to enter at the beginning of your work session. This is preferable as it is more secure but may cause problems for some clustered work, particularly our TORQUE/MAUI clusters. If you simply hit '''[enter]''', you will never be prompted for a password when ssh'ing which can lead to security problems.

# To create a '''''passwordless''''' key, type the following, and then hit enter to place the keys in the default directory. '''NOTE: This is ''REQUIRED'' for our [[ClusterGuide|TORQUE/MAUI]]-based clusters!''' <pre> # ssh-keygen -N ""</pre>
#: Alternatively, to create a '''''passphrase-protected''''' (more-secure) key, type the following. Do not use this option if you plan to use any of our [[ClusterGuide|TORQUE/MAUI]]-based clusters.<pre> # ssh-keygen</pre>
#This will produce two files, '''id_rsa''' and '''id_rsa.pub''', the private and public keys, respectively. The default location will be ~/.ssh/. For the purposes of this tutorial we'll assume this default. Once you've created the keys, you will need to put them into place as follows:
# chmod 700 ~/.ssh
# chmod 600 ~/.ssh/id_rsa
# touch ~/.ssh/authorized_keys2
# chmod 600 ~/.ssh/authorized_keys2
# cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys2
# rm ~/.ssh/id_rsa.pub

*It is '''very''' important that you keep your private key secure! Ensure that it is chmod'd to 600 and that you do not put it anywhere visible to other users!
*You must also make sure that no other users may write to your .ssh directory. This includes making sure that your home directory is not writable by group. Your home directory should be chmod'd to 750 or 700 to make sure of this. If the group write bit is set, your ssh keys '''WILL NOT WORK'''

If you did not select a passphrase when you generated your keys, you can now ssh without a password. If you did select a passphrase, you will need to activate the keys as follows:

# ssh-agent [SHELL]
# ssh-add -t [TIME]

In this case, "[SHELL]" is your preferred shell and "[TIME]" is the amount of time you'd like the key to be active in seconds. So, the following would start a bash shell with passwordless ssh active for 30 minutes:

# ssh-agent bash
# ssh-add -t 1800

You will be prompted for your passphrase and, when entered correctly, you will be able to ssh without entering a password.

To disable this functionality, simply delete your private key file ('''~/.ssh/id_rsa''') and remove the public key from your '''~/.ssh/authorized_keys2''' file.

==Unstable Connections==
If you are dealing with an unstable connection you may want to run your processes inside a screen on the host that you're connecting to. This way, if the connection is dropped for any reason the screen session will automatically detach on the host and will continue running so that you can reattach it at a later time when you've connected again. Please see our documentation on [[Screen | GNU Screen]] for more information.

==Further Information==
[http://www.openssh.org/ OpenSSH]

[http://www.openssh.com/windows.html Windows Clients]

SecureShell

2015-07-17T18:50:50Z

Dustinb: /* X11 Forwarding */

Secure Shell (or [http://en.wikipedia.org/wiki/Secure_Shell SSH]) is a network protocol allowing two computers to exchange data securely over an insecure network. By default, use of SSH brings the user to a terminal, but the protocol can be used for other types of data transfer such as [[SFTP]] and [[SCP]].

==Connecting to an SSH Server==
Under Linux and Mac OS X, the following command from a terminal will connect a client computer to the UMIACS [[OpenLAB]].
# ssh bkirz@openlab.umiacs.umd.edu
This will give you access to a terminal on any one of the [[OpenLAB]] servers. Note that by default you will not have access to applications that require X11 to run.

All UMIACS Windows hosts are installed with SSH Secure Shell Client. Alternatively, users can install these software on their personal machines:

* [http://www.chiark.greenend.org.uk/~sgtatham/putty/ PuTTY]
* [http://ttssh2.sourceforge.jp/ ttssh2]

Alternatively, all users can launch terminal sessions [[JuniperVPNTerminalSession| through the Juniper VPN web interface.]]

==X11 Forwarding==
By default, SSH only gives the user shell access to a host. Enabling X11 Forwarding allows users to run applications with Graphical User Interfaces.

Under Linux and Mac OS X, the following command from a terminal will connect a client computer to the UMIACS [[OpenLAB]] using X11 Forwarding.
# ssh '''-Y''' bkirz@openlab.umiacs.umd.edu

Under Mac Os X, [[http://xquartz.macosforge.org/landing/|xQuartz]] is required on the client machine to forward X sessions from the remote session.

If you do not have Cygwin, you will need to forward X through
[http://sourceforge.net/projects/vcxsrv/ VcXsrv] or
[http://www.straightrunning.com/XmingNotes/ Xming].
First, enable X forwarding on your secure ssh client. The option is under tunneling in the ssh client settings, shown below. This only has to be done once.

[[Image:sshXForward.jpg]]

Next, click save in the main ssh appication window to save this setting.

After this has been done, every time you want to use X forwarding, you need to make sure VcXsrv or Xming has been started (it will appear in your task tray) through the start menu programs.
Now, you will be able to use Xwindow programs from your ssh client.

==SSH Tunneling==

You can tunnel one or more ports through an SSH connection such that your packets will look like they are coming from the host you are tunneling to. This is helpful for services that you would be normally blocked by a firewall.

Please see the [[SecureShellTunneling]] page for more information.

==SSH Keys (and Passwordless SSH)==

There are some situations where it is important to be able to ssh without entering a password. This is mostly required when working in clusters. This is done using ssh keys. Instead of authenticating with a password, ssh can use a pre-defined set of encryption keys to establish an authorized connection.
To setup passwordless ssh, do the following.

First, you will need to create a ssh [http://en.wikipedia.org/wiki/Key_pair key pair]. It is possible to use a password that you will need to enter at the beginning of your work session. This is preferable as it is more secure but may cause problems for some clustered work, particularly our TORQUE/MAUI clusters. If you simply hit '''[enter]''', you will never be prompted for a password when ssh'ing which can lead to security problems.

# To create a '''''passwordless''''' key, type the following, and then hit enter to place the keys in the default directory. '''NOTE: This is ''REQUIRED'' for our [[ClusterGuide|TORQUE/MAUI]]-based clusters!''' <pre> # ssh-keygen -N ""</pre>
#: Alternatively, to create a '''''passphrase-protected''''' (more-secure) key, type the following. Do not use this option if you plan to use any of our [[ClusterGuide|TORQUE/MAUI]]-based clusters.<pre> # ssh-keygen</pre>
#This will produce two files, '''id_rsa''' and '''id_rsa.pub''', the private and public keys, respectively. The default location will be ~/.ssh/. For the purposes of this tutorial we'll assume this default. Once you've created the keys, you will need to put them into place as follows:
# chmod 700 ~/.ssh
# chmod 600 ~/.ssh/id_rsa
# touch ~/.ssh/authorized_keys2
# chmod 600 ~/.ssh/authorized_keys2
# cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys2
# rm ~/.ssh/id_rsa.pub

*It is '''very''' important that you keep your private key secure! Ensure that it is chmod'd to 600 and that you do not put it anywhere visible to other users!
*You must also make sure that no other users may write to your .ssh directory. This includes making sure that your home directory is not writable by group. Your home directory should be chmod'd to 750 or 700 to make sure of this. If the group write bit is set, your ssh keys '''WILL NOT WORK'''

If you did not select a passphrase when you generated your keys, you can now ssh without a password. If you did select a passphrase, you will need to activate the keys as follows:

# ssh-agent [SHELL]
# ssh-add -t [TIME]

In this case, "[SHELL]" is your preferred shell and "[TIME]" is the amount of time you'd like the key to be active in seconds. So, the following would start a bash shell with passwordless ssh active for 30 minutes:

# ssh-agent bash
# ssh-add -t 1800

You will be prompted for your passphrase and, when entered correctly, you will be able to ssh without entering a password.

To disable this functionality, simply delete your private key file ('''~/.ssh/id_rsa''') and remove the public key from your '''~/.ssh/authorized_keys2''' file.

==Unstable Connections==
If you are dealing with an unstable connection you may want to run your processes inside a screen on the host that you're connecting to. This way, if the connection is dropped for any reason the screen session will automatically detach on the host and will continue running so that you can reattach it at a later time when you've connected again. Please see our documentation on [[Screen | GNU Screen]] for more information.

==Further Information==
[http://www.openssh.org/ OpenSSH]

[http://www.openssh.com/windows.html Windows Clients]

Subversion

2015-07-07T14:33:33Z

Dustinb:

This page is maintained for legacy reasons and it is suggested to use [[GitLab]] for version control.

UMIACS provides a centrally managed [[Subversion]] service.

To have a [[Subversion]] repository created you need to just email [mailto:staff@umiacs.umd.edu staff] and provide the name of your repository and how much initial space you think you will need.

We will give you a [[URL]] back with the server https://subversion.umiacs.umd.edu in it.

By default we will configure all repositories to be private and require authentication for both reading and writing to the [[Subversion]] repository. Authentication is done against our [[LDAP]] and if requested we can enable a UMIACS user to manage the [[ApplicationResource|AR]] with our [[ApplicationResourceUtil]] found at https://intranet.umiacs.umd.edu/arutil.

=Getting Started with Subversion=

You will first need to check out your repository,

svn co https://subversion.umiacs.umd.edu/my_url

This will create a directory in your current working directory with the name of the last part of the URL you just checked out.

cd my_url

You can now add files by the '''svn import''' command, '''svn add''' can be used to add file that you have created but is not under revision control yet.

For more information please see the defacto book on [[Subversion]] in [http://svnbook.red-bean.com/en/1.4/svn-book.html HTML] or [http://svnbook.red-bean.com/en/1.4/svn-book.pdf PDF]

=Clients=

Most Linux distributions include subversion clients in the distribution including all our [[OSSupport|Red Hat Enterprise Linux]] clients.

==Collab.net Subversion Packages==

These are well packaged subversion command line packages. You can find ones for Windows, Mac OS X and Solaris. Please see the community downloads for Mac OS X.

http://www.open.collab.net/downloads

==Security Considerations==
Command line subversions store your password be default on linux, so you should be careful. In order to disable password caching completely, add the line: "store-passwords = no" to the subversion configuration file on your machine. In order to disable caching for a one time command you can pass the --no-auth-cache option.

==Server Certificate Verification on OSX==
The command-line svn tool that is bundled with OSX through Xcode does not correctly handle the UMIACS subversion server certificate. In order to verify that you are actually connecting to UMIACS, verify that the following fingerprint matches:

Fingerprint: cb:4f:c6:74:3e:1a:27:d3:55:e7:4b:5a:89:af:e4:c4:95:ce:fe:32

If this fingerprint matches, you can safely accept the certificate.

==Graphical Clients==

===OS Integration===

* Windows - http://tortoisesvn.tigris.org
* Mac OS X - http://scplugin.tigris.org

===Other Clients===

http://subversion.tigris.org/links.html#clients

RevisionControl

2015-07-07T14:31:28Z

Dustinb:

Users with no preference should use GitLab, which provides the most complete set of features. Subversion repositories are also available.
* [[GitLab]] (reccommended) - use for personal projects and collaboration with UMIACS users and Offsite users.
* [[Subversion]] (Legacy, no longer recommended)