User Tools

Site Tools


the_metaarray

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
the_metaarray [2021/04/04 03:28] – [Acceptable Use Policy] hc9the_metaarray [2023/07/01 00:15] (current) – [Using SDF Nextcloud on ShareX] hc9
Line 9: Line 9:
 ===== Getting Started ===== ===== Getting Started =====
  
-To enable your access to **ma.sdf.org**, run '//metaarray//' at the shell. This will first generate a random login password followed by a random database password sent via local e-mail if you have a DBA membership. To connect, use '//ssh ma.sdf.org//' (port 22 or 8080). Once you are connected, you can change your password with the 'passwd' command. If you ever forget your password, just run '//metaarray//' again from any of the regular nodes of the SDF cluster.+To enable your access to **ma.sdf.org**, run '//metaarray//' at the shell. This will first generate a random login password followed by a random database password sent via local e-mail if you have a DBA membership. To connect, use '//ssh ma.sdf.org//' (port 22 or 8080). Once you are connected, you can change your password with the 'passwd' command. If you ever forget your password, just run '//metaarray//' again from any of the regular nodes of the SDF cluster. If you have problems with passwords and logging in, the official advice is: 
 +>For passwords and access questions, please always email membership@sdf.org  directly rather than using the [[bboard]]. 
 + 
 + 
  
 ===== Disk Layout ===== ===== Disk Layout =====
Line 16: Line 20:
  
 The user directory structure is as follows: The user directory structure is as follows:
- +^ Directory ^ Description ^ 
-|*|/meta/initial/user|(home directory, considered private)+|/meta/initial/user| home directory, considered private | 
-|*|/meta/www/initial/user|(web directory, considered public served via http)| +|/meta/www/initial/user| web directory, considered public served via http(s) | 
-|*|/meta/log|(person website access log)+|meta/log| person website access log| 
-|*|/meta/mail/user|(user's mailbox - see the [[:configuration_changes_needed_when_using_maildir|Maildir tutorial]])|+|/meta/mail/user| user's mailbox - see the [[:configuration_changes_needed_when_using_maildir|Maildir tutorial]] |
  
 ===== Executables and Packages ===== ===== Executables and Packages =====
  
-Packages on the MetaArray are managed with **pkgsrc** and **yum**. Nearly any program or package can be installed by making a request on the regular nodes of the SDF cluster via the '//bboard//' REQUESTS.+Packages on the MetaArray are managed with **pkgsrc** and **dpkg/apt-get**. Nearly any program or package can be installed by making a request on the regular nodes of the SDF cluster via the '//bboard//' REQUESTS.
  
 The package directory structure is as follows: The package directory structure is as follows:
- +^ Path ^ Description ^ 
-|  *  | /bin, /usr/bin | (yum repo destination directories+| /bin, /usr/bin | apt-get repo destination directories | 
-|  *  | /usr/pkg/bin | (pkgsrc destination directories+| /usr/pkg/bin | pkgsrc destination directories | 
-|  *  | /usr/local/bin | (MetaArray specific utilities|+| /usr/local/bin | MetaArray specific utilities 
 +| /meta/sdf/bin | compiled binaries installed by MetaARPA members |
  
 ===== Services and features ===== ===== Services and features =====
Line 36: Line 41:
 The MetaArray includes all features of the MetaARPA membership. However, some SDF specific utilities may not be available on the MetaArray because it is designed to be isolated from the SDF cluster. Some MetaArray specific services must be manually configured by the user. The MetaArray includes all features of the MetaARPA membership. However, some SDF specific utilities may not be available on the MetaArray because it is designed to be isolated from the SDF cluster. Some MetaArray specific services must be manually configured by the user.
  
-|*|screen, tmux|Terminal managers| +^ Service/Feature ^ Description ^ 
-|*|mkcron|Use '//crontab -e//' to edit your crontab| +|screen, tmux|Terminal managers| 
-|*|mkhomepg|Use '//mkhomepg -t//' on the SDF Cluster to toggle website hosting 'mkhomepg' on the MetaArray will set secure perms for /meta/www|   +|mkcron|Use '//crontab -e//' to edit your crontab| 
-|*|setvmail|Put '**$LOGNAME@ma.sdf.org**' in your .forward on the SDF Cluster Your default email address is **$LOGNAME@SDF.ORG**| +|mkhomepg|Use '//mkhomepg -t//' on the SDF Cluster to toggle website hosting 'mkhomepg' on the MetaArray will set secure perms for /meta/www|   
-|*|webmail|Be sure to forward your mail, login via https://ma.sdf.org| +|setvmail|Put '**$LOGNAME@ma.sdf.org**' in your .forward on the SDF ClusterYour default email address is **$LOGNAME@SDF.ORG**| 
-|*|IMAP|imap(143) and imaps(993) address is ma.sdf.org| +|webmail|Be sure to forward your mail, login via https://ma.sdf.org| 
-|*|X11|Connect with either ssh -X or ssh -Y to ma.sdf.org| +|IMAP|imap(143) and imaps(993) address is ma.sdf.org| 
-|*|Port forwarding|(via SSH)| +|X11|Connect with either ssh -X or ssh -Y to ma.sdf.org| 
-|*|startsql|MySQL database (with DBA membership)|+|Port forwarding|(via SSH)| 
 +|startsql|MySQL database (with DBA membership)|
  
 ===== Personal Website Hosting ===== ===== Personal Website Hosting =====
Line 50: Line 56:
 To host your personal website on the MetaArray, please do the following: To host your personal website on the MetaArray, please do the following:
  
-  run 'mkhomepg' on the MetaArray. This creates the $HOME/html symlink and sets initial permissions. +  run 'mkhomepg' on the MetaArray. This creates the $HOME/html symlink and sets initial permissions. 
-  upload your site to $HOME/html on the MetaArray. +  upload your site to $HOME/html on the MetaArray. 
-  run 'mkhomepg' again on the MetaArray. This sets proper permissions on your content. +  run 'mkhomepg' again on the MetaArray. This sets proper permissions on your content. 
-  run 'mkhomepg -t' on the SDF cluster to toggle your site to the MetaArray+  run 'mkhomepg -t' on the SDF cluster to toggle your site to the MetaArray
  
 It may take up to 10 minutes for DNS to update locally; however your ISP DNS server may cache this data for up to 12 hours so you won't see the change immediately. Use the "host" command on the cluster to see if DNS has changed, and "lynx" on the cluster to verify that the site loads: then be patient as DNS changes propagate. It may take up to 10 minutes for DNS to update locally; however your ISP DNS server may cache this data for up to 12 hours so you won't see the change immediately. Use the "host" command on the cluster to see if DNS has changed, and "lynx" on the cluster to verify that the site loads: then be patient as DNS changes propagate.
  
-* The DOCROOT for your directory defaults to no-read access, so you must have an index.html. Directory listings will work on subdirs within the DOCROOT. You can defeat this by running 'chmod g+r $HOME/html'+  * The ''DOCROOT'' for your directory defaults to no-read access, so you must have an index.html. Directory listings will work on subdirs within the ''DOCROOT''. You can defeat this by running 'chmod g+r $HOME/html'
  
-* https through a self signed certificate is only available to personal URLs under *.sdf.org+  * https through a self signed certificate is only available to personal URLs under *.sdf.org
  
-===== SDF Nextcloud =====+  * Migrating your CGI scripts from the cluster to the MetaArray? You'll need to pay attention to the filename (only '.cgi' seems to work) and the path to the interpreter. For example, the following script will generate an actual webpage when served from the cluster, but when served from the MetaArray will prompt your browser for a location to save the script itself (first because the path to the interpreter is wrong, and second because the file extension is not recognized by nginx as needing the fastcgi module for its processing).
  
-SDF makes available a //Nextcloud (([[https://nextcloud.com/|Nextcloud -- Share and collaborate on documents, send and receive email, manage your calendar and have video chats without data leaks]]))// instance at [[https://ma.sdf.org/nc/|https://ma.sdf.org/nc/]].+  #!/usr/pkg/bin/python3.
 +  # saved as $HOME/html/my_powerful.py 
 +  import cgi 
 +   
 +  print('Content-Type:text/html'
 +  print() 
 +  print('<!DOCTYPE html>'
 +  print('<html lang="en">'
 +  print('<head>'
 +  print('<title>My powerful script</title>'
 +  print('</head>'
 +  print('<body>'
 +  print('Hello, World!'
 +  print('</body>'
 +  print('</html>')
  
-To initialize your logingo to [[https://ma.sdf.org/nc/|https://ma.sdf.org/nc/]], click "Forgot password?", and enter your SDF username.+To get this script to behave properly on the MetaArraychange the first line to ''#!/usr/bin/env python3.9'', and rename the file as ''my_powerful.cgi'' .
  
-In order to connect to your instance from a client, the "server" should be set to "**<nowiki>https://ma.sdf.org/nc/</nowiki>**". (The client might complain about the *.sdf.org SSL certificate, but that's fine) 
  
-===== Using SDF Nextcloud on ShareX =====+===== Simple Personal Server Hosting ===== 
 + META users can run simple servers using the port that matches their user id. You may run a simple server process on the metaarray as long as it does not circumvent a membership and is a small server "of reasonable or less foot-print". Find more detail and instructions in [[Meta Port Allocation]] 
 + 
  
-If you'd like to use SDF'Nextcloud as a destination for ShareX then follow the steps below:+===== SDF Nextcloud =====
  
-noteThis tutorial was written for 10.1+SDF makes available a //Nextcloud (([[https://nextcloud.com/|Nextcloud -- Share and collaborate on documents, send and receive email, manage your calendar and have video chats without data leaks]]))// instance at [[https://ma.sdf.org/nc/|https://ma.sdf.org/nc/]].
  
-  * Configure ShareX Destination for SDF Nextcloud +To initialize your loginplease email membership@sdf.org to receive your username and password.
-  * Open the ShareX application window +
-  * Click on Destinations +
-  * Click on Destination Settings +
-  * Select on the left paneNextcloud (under File uploaders) +
-   +
-  * Enter: +
-  * Host: https://ma.sdf.org/nc +
-  * Username: your sdf_nc login +
-  * Password: your sdf_nc password +
-  * Path: /foo+
  
-Place check next to:+In order to connect to your instance from client, the "server" should be set to "**<nowiki>https://ma.sdf.org/nc/</nowiki>**". (The client might complain about the *.sdf.org SSL certificate, but that's fine)
  
-  * Create shareable URL (Optional) +===== Using SDF Nextcloud on ShareX =====
-  * Ignore invalid SSL certificate (Required)+
  
-Close the settings window +If you'd like to use SDF's Nextcloud as a destination for ShareX then follow the steps below: 
- +//note: This tutorial was written for 10.1// 
-Select from the menu Image Uploader - File Uploader - Nextcloud+      * Configure ShareX Destination for SDF Nextcloud 
 +      * Open the ShareX application window 
 +      * Click on Destinations 
 +      * Click on Destination Settings 
 +      * Select on the left pane, Nextcloud (under File uploaders) 
 +      *  Enter: 
 +        * Host: https://ma.sdf.org/nc 
 +        * Username: your sdf_nc login 
 +        * Password: your sdf_nc password 
 +        * Path: /foo  
 +      * Place a check next to: 
 +          * Create shareable URL (Optional) 
 +          * Ignore invalid SSL certificate (Required)  
 +      * Close the settings window 
 +      Select from the menu: **Image Uploader - File Uploader - Nextcloud**
  
 $Id: metaarray.html,v 1.38 2018/08/15 02:09:33 echosa Exp $ [[http://sdf.org/?tutorials/metaarray|The MetaArray]] - traditional link (using [[wp>Revision_Control_System|RCS]]) $Id: metaarray.html,v 1.38 2018/08/15 02:09:33 echosa Exp $ [[http://sdf.org/?tutorials/metaarray|The MetaArray]] - traditional link (using [[wp>Revision_Control_System|RCS]])
  
the_metaarray.1617506881.txt.gz · Last modified: 2021/04/04 03:28 by hc9