Difference between revisions of "New Users"

From CHG-Wiki
Jump to navigationJump to search
(Created basic unix user guide.)
 
 
(25 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This page is intended to introduce to a new user or clarify to an existing user some key facts about the CHG unix environment.
+
This page is intended to introduce to a new user or clarify to an existing user some key facts about the CHC unix environment.
  
==How to Get an Account==
+
==How to Get a Unix Account==
To acquire an account, please contact [[User:Pete|Pete]] or [[User:Libby|Libby]]. Please be sure to provide your full name. Your unix username should be your first name, unless that is already taken.
+
To request a computer account please send email to help @ eri.ucsb.edu and the ERI IT Team will mail you a Google Form to fill out and return electronically. Normal account turn around time is 1-2 business days, pending volume.
  
 +
some tutorials you might find useful,
 +
 +
  https://people.ischool.berkeley.edu/~kevin/unix-tutorial/toc.html
 +
 +
  https://fresh2refresh.com/unix-tutorial/
 +
 +
  List of Unix commands https://en.wikipedia.org/wiki/List_of_Unix_commands
 +
 +
  basic unix  https://www.guru99.com/must-know-linux-commands.html
  
 
==Standard Directories==
 
==Standard Directories==
As a general rule, the following directories should be created and owned by [user]:chg
+
As a general rule, the following directories should be created and owned by [user]:chc
 
+
===/home/ftp_out/people/[user]===
+
===/home/[user]===
This is the user's personal directory on our ftp server (see [[#FTP|FTP]] below).
+
This is your home directory. It is backed up once per day. <u>It is '''not''' a place to put any data, ''even for a short time''!</u>
===/home/sandbox/people/[user]===
 
This directory is for large data sets that never need to be backed up and/or that you can get again. Make sure that the code to re-get the data you put here lives in /home/source/[user].
 
  
===/home/source/[user]===
+
===/home/chc-source/[user]===
 
This is where we encourage users to put codes, scripts, and/or intellectual property. Please note, this directory is accessible to most other users so it is reasonable to expect them to look around to see how you're doing things. This separates your code from any other files you may keep in your home directory.
 
This is where we encourage users to put codes, scripts, and/or intellectual property. Please note, this directory is accessible to most other users so it is reasonable to expect them to look around to see how you're doing things. This separates your code from any other files you may keep in your home directory.
  
 
This is backed up often. <u>It is '''not''' a place to put any data!</u>
 
This is backed up often. <u>It is '''not''' a place to put any data!</u>
  
===/home/chg-[user]===
+
===/home/chc-[user]===
This is a directory for your user-specific data that does not yet have another logical place to be in our /home/databits universe. Talk to [[User:Pete|Pete]] if you are not sure. /home/chg-[user] is backed up once per week.
+
This is a directory for your user-specific data that does not yet have another logical place to be in our /home/databits universe. Talk to [[User:Pete|Pete]] if you are not sure. /home/chc-[user] is backed up once per week.
  
 
As your data becomes more significant/relevant, consider migrating it to a /home/databits directory.
 
As your data becomes more significant/relevant, consider migrating it to a /home/databits directory.
+
 
===/home/chg-users/[user]===
+
===/home/chc-sandbox/people/[user]===
This is your home directory. It is backed up once per day. <u>It is '''not''' a place to put any data, ''even for a short time''!</u>
+
This directory is for large data sets that never need to be backed up and/or that you can get again. Make sure that the code to re-get the data you put here lives in /home/source/[user].
 +
 
 +
===/home/chc-data-out/people/[user]===
 +
This is the user's personal directory on our ftp server (see [[#FTP|FTP]] below).
 +
 
 +
===/home/hub ===
 +
This is an ad hoc directory with symbolic links to (almost) all of our automounted directories.
 +
So try,  (may take a while while it resolves ~160 symbolic links)
 +
 
 +
cd /home/hub
 +
ls
 +
 
 +
==Adding directories to your /home environment==
 +
If you often go to a certain directory and want access it more conveniently, simply cd into that directory and a link to that directory will now appear in your /home environment. For example:
 +
 
 +
[user@server ~] ls
 +
chc-data-out/  chc-sandbox/    source/    user/    world/
 +
[user@server ~] cd /home/code
 +
[user@server ~] cd /home ; ls
 +
code/ chc-data-out/  chc-sandbox/    source/    user/    world/
 +
 
 +
As you can see, you only have to cd into /home/code once for it to always thereafter appear in your /home directory. To find a complete listing of directories that you can mount in this fashion, please see [[Auto_mounts]].
  
 
==FTP==
 
==FTP==
To add data to our ftp site, use the directory located at /home/ftp-out. This directory is write only, meaning that the outside world can't access it.
+
To add data to our ftp site, use the auto-mounted /home/chc-data-out directory and navigate from there. For example, if "user" wanted to add something to their personal ftp:
 +
[user@server ~]$ cd /home/chc-data-out/people/user
 +
[user@server user]$ ls
 +
some_files other_files
 +
[user@server user]$ vi another_file
 +
[user@server user]$ ls
 +
another_file other_files some_files
 +
 
 +
When you want to point others to the data on our ftp site, you can direct them to ftp://ftp.chc.ucsb.edu/pub/org/chc/. So, if "user" wanted someone to see the files in their ftp directory, they would direct them to
 +
ftp://ftp.chc.ucsb.edu/pub/org/chc/people/user
 +
 
 +
===ftp_in===
 +
When users outside CHC want to place documents or data into our ftp site, they do so via chc-data-in. Everything that comes into /home/chc-data-in gets pushed to
 +
ftp://ftpin.chc.ucsb.edu/pub/org/chc/your_directory/
 +
 
 +
There is a cron job that runs once a day to catch anything new that comes in.
 +
 
 +
The copy lives in chc-sandbox, since the original /home/chc-data-in is there (just not easy to see) and its backed up.
 +
 
 +
 
 +
===CHC data for the outside world===
 +
A good starting point to point folks at for all things CHC public data is,     
 +
 
 +
    https://data.chc.ucsb.edu/
 +
 
  
When you want to point others to the data on our ftp site, you can direct them to ftp://chg-dub.geog.ucsb.edu/pub/org/chg/.
+
From here folks can choose their favorite protocol, https, ftp or rsync and access all our public data.

Latest revision as of 07:58, 29 October 2021

This page is intended to introduce to a new user or clarify to an existing user some key facts about the CHC unix environment.

How to Get a Unix Account

To request a computer account please send email to help @ eri.ucsb.edu and the ERI IT Team will mail you a Google Form to fill out and return electronically. Normal account turn around time is 1-2 business days, pending volume.

some tutorials you might find useful,

 https://people.ischool.berkeley.edu/~kevin/unix-tutorial/toc.html
 https://fresh2refresh.com/unix-tutorial/
 List of Unix commands https://en.wikipedia.org/wiki/List_of_Unix_commands
 basic unix  https://www.guru99.com/must-know-linux-commands.html

Standard Directories

As a general rule, the following directories should be created and owned by [user]:chc

/home/[user]

This is your home directory. It is backed up once per day. It is not a place to put any data, even for a short time!

/home/chc-source/[user]

This is where we encourage users to put codes, scripts, and/or intellectual property. Please note, this directory is accessible to most other users so it is reasonable to expect them to look around to see how you're doing things. This separates your code from any other files you may keep in your home directory.

This is backed up often. It is not a place to put any data!

/home/chc-[user]

This is a directory for your user-specific data that does not yet have another logical place to be in our /home/databits universe. Talk to Pete if you are not sure. /home/chc-[user] is backed up once per week.

As your data becomes more significant/relevant, consider migrating it to a /home/databits directory.

/home/chc-sandbox/people/[user]

This directory is for large data sets that never need to be backed up and/or that you can get again. Make sure that the code to re-get the data you put here lives in /home/source/[user].

/home/chc-data-out/people/[user]

This is the user's personal directory on our ftp server (see FTP below).

/home/hub

This is an ad hoc directory with symbolic links to (almost) all of our automounted directories. So try, (may take a while while it resolves ~160 symbolic links)

cd /home/hub
ls

Adding directories to your /home environment

If you often go to a certain directory and want access it more conveniently, simply cd into that directory and a link to that directory will now appear in your /home environment. For example:

[user@server ~] ls
chc-data-out/   chc-sandbox/    source/    user/    world/
[user@server ~] cd /home/code
[user@server ~] cd /home ; ls
code/ chc-data-out/   chc-sandbox/    source/    user/    world/

As you can see, you only have to cd into /home/code once for it to always thereafter appear in your /home directory. To find a complete listing of directories that you can mount in this fashion, please see Auto_mounts.

FTP

To add data to our ftp site, use the auto-mounted /home/chc-data-out directory and navigate from there. For example, if "user" wanted to add something to their personal ftp:

[user@server ~]$ cd /home/chc-data-out/people/user
[user@server user]$ ls
some_files other_files
[user@server user]$ vi another_file
[user@server user]$ ls
another_file other_files some_files

When you want to point others to the data on our ftp site, you can direct them to ftp://ftp.chc.ucsb.edu/pub/org/chc/. So, if "user" wanted someone to see the files in their ftp directory, they would direct them to

ftp://ftp.chc.ucsb.edu/pub/org/chc/people/user

ftp_in

When users outside CHC want to place documents or data into our ftp site, they do so via chc-data-in. Everything that comes into /home/chc-data-in gets pushed to

ftp://ftpin.chc.ucsb.edu/pub/org/chc/your_directory/

There is a cron job that runs once a day to catch anything new that comes in.

The copy lives in chc-sandbox, since the original /home/chc-data-in is there (just not easy to see) and its backed up.


CHC data for the outside world

A good starting point to point folks at for all things CHC public data is,

    https://data.chc.ucsb.edu/


From here folks can choose their favorite protocol, https, ftp or rsync and access all our public data.