View
  By section
  As outline
  Fully expanded

FAQ sections
  Getting Started
  General Questions
  Forum and FAQs
  Group Mailing Lists
  Hardware/Software
  Editing group pages
The Embedded Website Workgroup

FAQ

Welcome to the embedded FAQ.

Getting Started on the web-site
Information on how to get familiar with the site and start using its features.

What is this site?
This site consists of workgroups that are associated with the Donald O. Pederson Center for Electronic System Design.

You may also be interested in the following sites:

Who can get a login?
Currently, membership in each individual workgroup is determined by the administrators of each workgroup.

Membership in the embedded workgroup of the website is open to current UC Berkeley students, faculty and staff.

General questions about the website.

How does the main page get updated?
The best way to update the main page is to send email to the website administrators. The main page can be updated by key personnel who are administrators of the workgroup that corresponds to the site.
To become an administrator for the workgroup, send email to: webmgr at serverObfuscatedEmailName. If you are a member of the administrator workgroup, then there will be a 'CVS update' link at the bottom of the page that will update the page and a 'Help' link that discusses how to check out the website.

Once you have been granted administrative privileges in the chess workgroup, you can check out your own working copy of the chess site by doing:

cvs -d :ext:source.eecs.berkeley.edu:/home/cvs_embedded co embeddedwww

Note that currently the top and bottom of the main page is split in to two files (embeddedwww/index_top.htm and embeddedwww/index_bottom.htm). These two files are read in by php/embedded.eecs.berkeley.edu/index.php, which is in the php repository. To update this file, you must know the www user password on andrews.
Having two files control the main page is likely to change.

For additional information about using CVS, see:

How do I edit pages in a group with the "CVS Authoring" option?

How can I share a FAQ item with one of the other websites?
It is possible to share FAQ items between the GSRC-related websites, GSRC, Embedded and Chess.

To add a FAQ item to your workgroup that has the same content as an existing FAQ on one of the other websites, your website account must have permission to read the existing FAQ on the other website, and permission to create one in its new location.

Simply go to the FAQ section where you want to add the new FAQ, and click the "Add question" link in the left margin. On the resulting page, read the brief instructions, and enter the URL of the existing FAQ item in the box provided for that purpose.

Since the text of the FAQ is shared between two websites, the wording of the FAQ should be general enough to apply to both sites.

Missing menus/Javascript disabled?

Unfortunately, there is a security hole in Internet Explorer that can be exploited by having javascript enabled.

Microsoft suggests setting the security level to high and then adding specific sites to the list of trusted servers:

  1. In Internet Explorer, select Tools -> Internet Options -> Security
  2. Click on Trusted Sites -> Sites
  3. "require server verification" should not be checked
  4. Add the following hosts:
    http://chess.eecs.berkeley.edu
    http://embedded.eecs.berkeley.edu
    http://www.gigascale.org
    http://www.truststc.org
    

Questions about the forums and FAQs
Questions and answers about forums and FAQs: what they are and how to use them.

How do I use Forums and FAQs?
See the GSRC FAQ Section Questions about the forums and FAQs.

How do I attach or upload a file to an article?
There are two types of attachments:
  1. When an article is created, one can upload plain text or html to be used as the body of the article.
  2. After the article is created, one can upload one or more named files of any type, for example, PowerPoint.

When an article is added one can select whether file uploads are allowed.

If you upload a file with the same name as an already existing file, then the contents of the file is replaced with the contents of the upload.

Note that there is currently a 8Mb (actually 8,388,608 bytes) limit to the size of the attachment that can be uploaded. (The size is set in /usr/local/lib/php.ini) If you would like to share larger files, then you may want to set up your workgroup to use CVS authoring. For details, see: How do I edit pages in a group with the "CVS Authoring" option?
Don't forget that if you are checking in binary files, you should use cvs add -kb filename so that CVS knows that the file is a binary file.

For information about sharing files via email, see: Why doesn't the GSRC Mailman system handle large attachments?

Managing Group Mailing Lists
Questions and answers about group mailing lists.

Every time a user sends email, I need to approve it. Why?
The workgroup email lists are set up so that for a user to send email, they must be sending email from the email address that they have associated with their website account. If someone in the workgroup sends email from a different email address, then the workgroup admin needs to approve the message by hand. If you would like someone to be able to post from a different email account, go to the admin page for the mailing list, follow the privacy link and add them to the following section:
Addresses of members accepted for posting to this list
without implicit approval requirement. 
(See "Restrict ... to list members" for whether or 
not this is in addition to allowing posting by list members

Hardware/Software issues
Notes about hardware and software.

Using Eudora in the department

Eudora

This was copied from https://iris.eecs.berkeley.edu/15-faq/35-unsupported/20-eudora.html
Relevant to Microsoft Windows clients only
How do I setup Eudora IMAP Email?

1. Install Eudora 5.1 using Control Panel -> Add/Remove Programs -> Add new programs -> Eudora 5.1 (Add)
    (NOTE: The version available from 'Add new programs' been customized to have the correct information already added. For 'Add new programs' to work, you must have access to servers behind the EECS firewall via either VPN or be physically connected to the wired network)

An alternative is to download Eudora from http://software.berkeley.edu/, which requires a CalNet ID.

 

 

 

2. Start Eudora (Start -> Programs -> Eudora)

3. Select Tools -> Options -> Getting started
    Add your name, return address and login name. The rest of the information has been pre-configured.

Be sure that 'Allow Authentication' is checked

d. 'Secure sockets when Sending' should be set to
'Required, START TLS'

e. Hit Ok, send a test message, which will fail the first time
f. (Eudora 5.x): Go back to Tools/Options/Sending Mail and click on
'Last SSL Info' and then 'Certificate Information Manager'
(Eudora 6.2): You might be prompted to add a certificate, in which case you can skip g and h below.
g. Find the Server Certificate for
US, California, EECS.Berkeley.edu, IDSG gateway.EECS.Berkeley.EDU
and click on 'Add to Trusted'

h. click Done, Ok and Ok to close the windows
i. Resend the message by right clicking on it, selecting
'Send Again', Queue the message and then File/Send Queued Messages
j. You will be prompted for your LDAP Password and the email should go through

Using Gateway in Eudora 5.2

Eudora 5.2 does not appear to function with the current configuration of gateway.eecs.berkeley.edu. A few modifications in eudora.ini, which is located in your Eudora folder (usually \program files\qualcomm\eudora\), should solve the problem. Make sure to backup your eudora.ini file before proceeding.

Add these lines to the "[Settings]" section of eudora.ini: (makes it look cleaner!)

SSLReceiveVersion=6
SSLSendVersion=6
SSLAltPortReceiveVersion=6
SSLAltPortSendVersion=6

This basically tells Eudora 5.2 to behave like 5.1 in it's SSL behavior.


Note that if you are using a mail server other than imap.eecs then your LDAP password and the password you use on the mail server should probably be the same.

If you are having problems with your password, see Changing your LDAP Password

For more information, see Secure authentication on gateway.EECS.Berkeley.EDU

4. Select Tools -> Mailboxes (this shows your IMAP folders)

Back to top


How do I import my old Eudora folders?

1) Copy and Paste your old Eudora folder (very important to backup first)

2) Uninstall The old Eudora (make sure you made a backup copy first)

 

3) Remove the c:\Eudora folder

4) Follow steps at top to install a new version of Eudora

5) Rename you mailbox folders with .mbx extension (e.g. in-old, out-old, poptest-old)

6) Paste those folders from your "Copy of Eudora" folder to your new "c:\Eudora" folder

7) Start Eudora, configure for IMAP mail, notice your old folders are there, 

------------------------------------------------------------------------------------------

You can also import from other mail programs (e.g. Outlook Express, Netscape)

Back to top


How to set up a pre-installed copy of Eudora 5.1 with IMAP

1. Select the "Tools" File Menu and Select "Personalities"
2. Right click on the personality you want to change (probably < Dominant >) and select properties
3. Select "incoming mail" tab
4. Set configuration to "IMAP"
5. enter server name "imap.eecs.berkeley.edu"
6. Leave mailbox location prefix blank
7. select Full message download
8. select Authentication style "Passwords"
9. Set Secure Sockets when Receiving to "Required, Alternate Port"
10. Hit OK to close the properties
11. Follow How to add/update a certificate in Eudora instructions below.


How to add/update a certificate in Eudora

Note: a number of similar looking Eudora menus give different results, please follow closely.

1. Check your mail - It will ask you for a password (enter it) and complain about updating the IMAP index (hit yes)
2. The first connection will fail due to a certificate problem
3. Follow instructions below to add a new certificate.
4. After it fails: Select the Tools File Menu and Select "Personalities"

5. Right-Click "Dominant" and choose "Properties"


6. Select the "incoming" tab

7. Select the Last SSL information button

8. Hit "Certificate Information Manager"

9. Select "+" sign to expand the server certificate for imap.EECS and hit the "Add to Trusted" button for the middle "Entrust" Certifcate.

10. Hit "Done", "OK", "OK" and you should be able to check IMAP email now.

Back to top


How to add/update the Gatway certificate in Eudora

Note: a number of similar looking Eudora menus give different results, please follow closely.

  1. download the new certificate from http://idsg.eecs.berkeley.edu/gte.cer and save it to somewhere accessible on your harddrive (like your desktop).
  2. try to send a test email - it will fail.
  3. go to tools => options => sending mail
  4. click "Last SSL Info"
  5. click "certificate information manager"
  6. click "import certificate", select the downloaded certificate, and select open.
  7. click "done", "ok", "ok" (close all the open dialog boxes)
  8. try sending another Email. it should work now.

Back to top


How to hide Eudora Headers

------

Under Eudora, the TabooHeaders setting in your Eudora.ini file determines what headers are displayed.

The easiest way to modify TabooHeaders is to use the Eudora help system and search for 'TabooHeaders', and follow the instructions for editing Eudora.ini.

Under Eudora 5.1, the Eudora.ini file can sometimes be found as C:\Eudora\Eudora.ini.

It looks like there is not a default TabooHeaders line, but the Eudora Help system says that the defaults are:
X-UID,Received,Status,X-UIDL,Message,In-Reply,X-Priority,Mime-Version,Content-,X -Persona,Resent-Message,Referenes,Return,X400,X-400,Mail-System,Errors-To,X-List ,Delivery,Disposition,X-Juno,Precedence,X-Attachments,X-MSMail,X-MimeOLE

The thing to do is to add to add X-Spam-Report to the above list.

To do this,

  1. Exit Eudora
  2. Edit c:\Eudora\Eudora.ini
  3. Add the following line as the second line, right after the [Settings] line
    TabooHeaders=X-UID,Received,Status,X-UIDL,Message,In-Reply,X-Priority,Mime-Versi on,Content-,X-Persona,Resent-Message,Referenes,Return,X400,X-400,Mail-System,Err ors-To,X-List,Delivery,Disposition,X-Juno,Precedence,X-Attachments,X-MSMail,X-Mi meOLE,X-Spam-Report
  4. Restart Eudora.

Back to top


How to use filters

in progress

  1. Launch Eudora
  2. Select Tools and then Filters
  3. Click New (located in the lower left corner..)
An outside link with filter instructions: http://www.mindspring.com/~aegreene/eudora/no-spam.htm

Back to top

Editing group pages, and other forms of rocket science
Information on how to set up and edit group home pages, and other advanced features of the site.

How do I edit pages in a group with the CVS Authoring option?
Based on text by John Reekie from the GSRC FAQ

Getting started quickly

Many of the workgroups have a CVS Repository associated with them. To update the pages, do the following
  1. Request a CVS account. Note that your login on source.eecs.berkeley.edu may be different than your login on the website. If you have a UCB EECS account, then your login on source will be the same as your UCB EECS login. If your username on source is different than your local account, then in the commands below you can use username@source.eecs.berkeley.edu instead of source.eecs.berkeley.edu, for example, ptolemy@source.eecs.berkeley.edu
  2. When you get email back notifying you that your account on source is created, use ssh to log in to source.eecs.berkeley.edu and run passwd to change your password.
  3. Install CVS and SSH. If you are using Windows, try TortoiseCVS,
  4. If you are using the command line, be sure that the CVS_RSH environment variable is set to ssh.
  5. To check out the CVS repository associated with a workgroup, you need to know where the repository is located. All the repositories for the CHESS, Embedded and TRUST sites are on source.eecs.berkeley.edu.
    CHESS
    :ext:source.eecs.berkeley.edu:/home/cvs_chess
    Embedded
    :ext:source.eecs.berkeley.edu:/home/cvs_embedded
    TRUST
    :ext:source.eecs.berkeley.edu:/home/cvs_trust
  6. If you are using a cvs command line client, then set the CVS_RSH environment variable to ssh. So, for example to check out the foo website, on CHESS, the command lines would be
    export CVS_RSH=ssh
    cvs -d :ext:source.eecs.berkeley.edu:/home/cvs_chess co foo
    
    Or, if your login on source.eecs.berkeley.edu was ptolemy, the command lines would be:
    export CVS_RSH=ssh
    cvs -d :ext:ptolemy@source.eecs.berkeley.edu:/home/cvs_chess co foo
    
  7. Make your changes to your local copy of the repository.
  8. Commit your changes by providing a useful message:
    cd foo
    cvs commit -m "message describing your changes"
    
  9. Go to the website and click on "CVS Update" at the bottom of the page.

Detailed instructions about Checking Out a Repository

Concurrent Version System (CVS) is a version control system that allows multiple users to edit the same source tree. We use CVS to manage the content of group web pages.

Subversion (SVN) is newer than CVS and is used to manage some software packages. Your Unix account on source.eecs.berkeley.edu can be used with both CVS and SVN repositories.

Bear in mind that CVS authoring is generally useful for software projects, in which case we assume that you know the basics of CVS and can use SSH. For further information about CVS, see the GSRC CVS FAQ

  1. If you are a group administrator check that your group has CVS authoring turned on by going to your group pages and then clicking on the Admin link and then Configure Group link and verifying that CVS Module and CVS Checkin are selected.
    If these two choices are not selected, then select them and hit the Change Group Configuration button at the bottom. This will send email to webmaster, who will then set up your cvs repository and send email back to you. While you are waiting, you can proceed with the steps below.
  2. If you don't yet have a CVS account on source.eecs.berkeley.edu, get one. You can request a CVS account.
  3. If ssh and cvs are not yet installed, then install the SSH client and CVS
  4. For Unix, download from http://www.openssh.com/
    Build and install. Note that you need not install the server side, you will only be logging out of your machine, not logging into your local machine.
    Download, build and install CVS. To download CVS, see: http://www.nongnu.org/cvs/
  5. For Mac OS X, Install Xcode from Apple, which includes gcc and other tools. Xcode is a 1 GB (!) download, and might not be required. Or, find a CVS Mac OS X application.
  6. For Windows, you can use TortoiseCVS or download cvs and OpenSSH as part of Cygwin.

    Using TortoiseCVS

    • Download TortoiseCVS
    • You may be prompted for a reboot. If you are brave, you can skip the reboot by using the Windows Task Manager to kill the explorer proces and then use Task Manager File -> New Task to start up explorer.
    • Go to the directory where you want to check out the repository, right click and select CVS Checkout
    • Make these changes
      Protocol:
      Secure shell(:ext:)
      Server:
      source.eecs.berkeley.edu
      Repository folder:
      The repository folder varies depending on the website upon which the workgroup resides.
      CHESS
      /home/cvs_chess
      Embedded
      /home/cvs_embedded
      TRUST
      /home/cvs_trust
      User name:
      Your account name on source.eecs.berkeley.edu, which may be different than your website account name
      Module
      The name of the workgroup
      Below is a sample screen shot from Jonathan Sprinkle that would be used to check out the CHESS SUPERB workgroup:

      Screenshot of TortoiseCVS

      When you hit OK, you will be prompted for your password.
      If your CVS account on source has been set up, after your type your password and hit ok, then the workgroup files will be downloaded to your machine.

      The website files will appear in the web subdirectory. Edit the files as you see fit and then right click and select CVS Commit, enter a log message and select OK.

      To update the website, go to your workgroup, log in to the website scroll to the bottom of the page and select CVS Update.

      You are done, the rest of this page does not really apply to TortoiseCVS users.

      Cygwin install under Windows

      There are two methods of installing Cygwin: Downloading from the Ptolemy II website or downloading directly from the Cygwin website.
      The advantage of downloading Cygwin from the Ptolemy II website is that the download is somewhat smaller since only essential parts of Cygwin are included - hence this download would be useful if you are dialed in over a slow modem.
      The advantage of downloading from the Cygwin website is that you will get the most recent versions of the software.
      Download from the Ptolemy II Website You can download the version of Cygwin that is included with the most recent Ptolemy II distribution from http://ptolemy.eecs.berkeley.edu/ptolemyII/ptIIlatest/cygwin.htm
      OR
      Download from the Cygwin website Install the Cygwin toolkit from http://www.cygwin.com/

      The Cygwin installer tends to change over time, but below is a summary of the steps necessary:

      1. Create an empty directory
      2. Download http://www.cygwin.com/setup.exe and save it in the empty directory
      3. Click on setup, then Next
      4. Select Install from Internet, then click on Next
      5. Use the default install root directory, which should be c:/cygwin
      6. Select 'Default Text File Type' of DOS.
        If you select Unix instead of DOS, then you will likely have Cygwin CR/NL problems.
      7. Hit the Next button.
      8. Use the default Local Package Directory, which should be the directory you created above.
      9. If you are not behind a firewall, click on direct connection, then click Next
      10. Select a nearby mirror, then click Next
      11. You will be presented with a list of packages to install.
        A complete installation takes at least 75Mb.

        At the minimum, select the packages below, which is roughly a 3Mb download that expands into an 8.7Mb installation.

        • Base Category
          • ash - For /bin/sh
          • bash
          • cygwin
          • diff - Configure uses cmp
          • fileutils - For ls
          • grep - Used by configure
          • sed - Needed by config.status, which is created by configure
          • sh-utils - For basename
          • textutils - For cat and tr
        • Devel Category
          • cvs
          • make
        • Net Category
          • openssh

        If you are serious about development you may also want:

        • Devel Category: autoconf - requires gawk and m4 from the Interepreters Category
        • Base Category
          • findutils
          • gzip
          • tar
        • Text Category: less
  7. Make sure that the CVS_RSH environment variable is set to ssh.
    To check under Windows, start up a Bash shell (Start->Programs->Cygnus Solutions->Cygwin Bash Shell) and type echo $CVS_RSH. If it is not set, then set it using Start->Settings->Control Panel->System->Advanced->Environment Variables CVS_RSH should be added and set to ssh.
    You may want to check that your path has been set to include Cygwin, which is located at c:cygwinbin

    To check under Unix, start a shell and type echo $CVS_RSH. If CVS_RSH is not set, then edit your shell startup files to set it automatically. If you run C-shell (csh), or some variant like tcsh, edit ~/.cshrc and add

    setenv CVS_RSH ssh
    
    If you run the Bourne shell (sh) or some variant like bash, edit ~/.profile and add
    export CVS_RSH=ssh
    
  8. Create a file in your home directory called .cvsrc that contains:
    update -P -d
    
    This is necessary so that when you run cvs update, then the -P and -d flags are automatically appended. cvs update -P -d will prune any directories that contain no files and create any new directories that someone else has checked in.
    If you do not create a ~/.cvsrc file, then you will need to run cvs update -P -d instead of cvs update
  9. Once you have received email stating that your cvs account is setup, log on to the cvs server with ssh source:
        ssh source.eecs.berkeley.edu
        
    If your source login is different from your local login then you use username@source.eecs.berkeley.edu
        ssh username@source.eecs.berkeley.edu
        
    If you have a UC Berkeley EECS computer account, then your login on source should be the same as your UC Berkeley EECS login. If you don't have a UCB EECS computer account, then your login is probably 8 characters or less and is your first initial followed by your name. If you have questions, respond to the email that you received when you got your password.

    Once successfully logged in change your password with the passwd command to something more reasonable

    claudius@maury 67% ssh ptolemy@source.eecs.berkeley.edu
    ptolemy@source's password:
    
    Last login: Fri Aug 27 17:50:34 1999 from maury.eecs.berke^M
    No mail.
    $ passwd
    passwd:  Changing password for ptolemy
    Enter login password:
    
    New password:
    
    Re-enter new password:
    
    passwd (SYSTEM): passwd successfully changed for ptolemy
    $ exit
    Connection to source closed.
    claudius@maury 68%
    
    
  10. To check out the CVS repository associated with a workgroup, you need to know where the repository is located. All the repositories for the CHESS, Embedded and TRUST sites are on source.eecs.berkeley.edu.
    CHESS
    :ext:source.eecs.berkeley.edu:/home/cvs_chess
    Embedded
    :ext:source.eecs.berkeley.edu:/home/cvs_embedded
    TRUST
    :ext:source.eecs.berkeley.edu:/home/cvs_trust
    So, for example to check out the foo website, on CHESS, the command line would be
    export CVS_RSH=ssh
    cvs -d :ext:source.eecs.berkeley.edu:/home/cvs_chess co foo
    
    If your username on source is different than your local username:
    export CVS_RSH=ssh
    cvs -d :ext:username@source.eecs.berkeley.edu:/home/cvs_chess co foo
    
  11. The CVS repository for each workgroup has a web subdirectory that contains the website. There may also be adjacent directories that contain software projects.
    To change the website, cd into the foo/web directory and edit a file
  12. Commit your changes with
    cvs commit -m "message about your change" fileyouedited
    
    
    You will then be prompted for your password, and the change will be committed.
  13. Go to a page in that workspace. You will see an "CVS Update" link in the toolbar at the bottom of the page. Click on it.
  14. Press on the "Go back" link and make sure that the pages are what you expect.

Common Problems

Can't get the initial download

  • Make sure you have the right username and password. Use ssh username@source.eecs.berkeley.edu to verify you can connect
  • Maybe the CVS_RSH variable is not set to ssh. Try:
    echo $CVS_RSH
    
    you should see
    bash-3.00$ echo $CVS_RSH
    ssh
    bash-3.00$ 
    
  • Try
    ssh username@source.eecs.berkeley.edu cvs --version
    
    You should see something like
    bash-3.00$ ssh ptolemy@source.eecs.berkeley.edu cvs --version
    password: XXXXXX
    Concurrent Versions System (CVS) 1.11.22 (client/server)
    
    Copyright (C) 2006 Free Software Foundation, Inc.
    
    Senior active maintainers include Larry Jones, Derek R. Price,
    and Mark D. Baushke.  Please see the AUTHORS and README files from the CVS
    distribution kit for a complete list of contributors and copyrights.
    
    CVS may be copied only under the terms of the GNU General Public License,
    a copy of which can be found with the CVS distribution kit.
    
    Specify the --help option for further information about CVS
    bash-3.00$ 
    
    If you don't see that results, but you can log in, then there is a problem with your account on source
You are not logged in 
©2002-2009 U.C. Regents