{"id":1573,"date":"2018-12-12T16:37:55","date_gmt":"2018-12-12T16:37:55","guid":{"rendered":"http:\/\/ri.itservices.manchester.ac.uk\/csf3\/?page_id=1573"},"modified":"2026-01-27T11:29:25","modified_gmt":"2026-01-27T11:29:25","slug":"using-from-windows","status":"publish","type":"page","link":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/getting-started\/using-from-windows\/","title":{"rendered":"Using the CSF from MS Windows"},"content":{"rendered":"<h2>Introduction<\/h2>\n<p>The CSF can easily be accessed from your Windows desktop. Here we provide some useful information for Windows users who may be less familiar with Linux.<\/p>\n<h2>Logging in from Windows<\/h2>\n<p>Please following the <a href=\"\/csf3\/getting-started\/connecting\/windows\/\">logging in from windows<\/a> instructions.<\/p>\n<p><a name=\"textfiles\"><\/a><\/p>\n<h2>Important information about batch submission scripts<\/h2>\n<p>If you use an editor on Windows (e.g., Notepad) to create a batch job submission script and transfer it to the CSF, your batch job will fail to run.<\/p>\n<p>This is because Windows and Linux have different ways of indicating end-of-lines in text files (using hidden characters) and the batch system <em>cannot<\/em> understand the Windows line-end convention. We have three recommended ways of dealing with this:<\/p>\n<ol class=\"gaplist\">\n<li>Use <code>gedit<\/code> on the CSF login node to write your jobscript &#8211; although this is a Linux editor it is GUI based and can be run directly on the CSF which means you do not need to transfer files back and forth to your desktop. If you&#8217;ve logged in with MobaXterm then this will work straight away.<\/li>\n<li>If you do create your jobscript text file in Windows and upload it to the CSF, run the following command on the login node <strong>before<\/strong> you submit it to batch:\n<pre>dos2unix <em>filename<\/em><\/pre>\n<p>where <code><em>filename<\/em><\/code> is the name of your jobscript file.<\/p>\n<p><strong>Please note<\/strong>: you should <strong>never<\/strong> run <code>dos2unix<\/code> on other files you may have uploaded to the CSF from Windows. It should only be used to convert text-file jobscripts. If you run <code>dos2unix<\/code> on other files, such as data files, you will corrupt them &#8211; even if you used a Windows application to create the data files. <code>dos2unix<\/code> <em>is for converting jobscripts only<\/em>.<\/li>\n<li>On Windows install and use <a href=\"http:\/\/notepad-plus-plus.org\/\">Notepad++<\/a>. Within Notepad++ select <code>Edit menu -&gt; EOL Conversion -&gt; UNIX\/OSX Format<\/code> when creating\/editing a new text file. When you then upload that file the CSF will understand it.<\/li>\n<li>In the mobaxterm text editor it may be changed through the menu:<br \/>\n<code>Encoding \u21d2 Unix.<\/code><\/li>\n<\/ol>\n<p>Our recommendation is to use <code>gedit<\/code> (or any other Linux editor) directly on the CSF. <a href=\"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/software\/tools\/gedit\/\">Further information about gedit<\/a>.<\/p>\n<h2>File and directory\/folder names<\/h2>\n<p><strong>DO NOT<\/strong> use spaces, and other non-alpha-numeric characters, in filenames and directories on Linux. Doing so can cause problems. In particular, the batch system may not be able to fully resolve the names of directories and cause jobs to error. Command line listing of files will be less clear, and without the use of escape characters, navigation of the filesystem, manipulation and deletion of files can be difficult. Acceptable non-alpha-numeric characters are underscore and dash. For example instead of:<\/p>\n<pre>Chemistry Simulation 1              # <strong>Bad folder name<\/strong> - it contains spaces\r\n<\/pre>\n<p>use:<\/p>\n<pre>Chemistry_Simulation_1              # A better choice - it contains _ instead of space\r\n<\/pre>\n<p>or<\/p>\n<pre>Chemistry-Simulation-1              # An equally good choice - it contains - instead of space\r\n<\/pre>\n<p>You may need to ensure that the folder structure and filenames on your windows PC\/laptop follows these conventions to avoid problems when you upload then to the CSF. On Windows you should not encounter any problems using these conventions, provided you name only your files and folders in that way, i.e. do not change any of the system files or directories on your windows PC\/laptop.<\/p>\n<h2>Basic Linux Commands and Compute Cluster Usage<\/h2>\n<p>We have provided a webpage of the <a href=\"\/csf3\/getting-started\/linux-commands\/\">basic Linux commands<\/a> for your reference. That page also contains links to recommended training\/further reading for Linux.<\/p>\n<p>Approximately three times a year an in person one day <a href=\"https:\/\/app.manchester.ac.uk\/rhpc\">Intro to CSF course<\/a> is run which provides an excellent starting point for users new to compute clusters and parallel computing concepts. The next one will likely be in July\/August 2025.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Introduction The CSF can easily be accessed from your Windows desktop. Here we provide some useful information for Windows users who may be less familiar with Linux. Logging in from Windows Please following the logging in from windows instructions. Important information about batch submission scripts If you use an editor on Windows (e.g., Notepad) to create a batch job submission script and transfer it to the CSF, your batch job will fail to run. This.. <a href=\"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/getting-started\/using-from-windows\/\">Read more &raquo;<\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"parent":12,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-1573","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/1573","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/comments?post=1573"}],"version-history":[{"count":20,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/1573\/revisions"}],"predecessor-version":[{"id":11764,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/1573\/revisions\/11764"}],"up":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/pages\/12"}],"wp:attachment":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/csf3\/wp-json\/wp\/v2\/media?parent=1573"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}