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.

How do I share files?
There are several ways to share files within a workgroup:
Wiki
The group administrator can enable a wiki for your workgroup and then presentations can be uploaded as attachments. Access to the wiki can be controlled via the workgroup admin page. Wikis are a good way to share information in a way that allows multiple people to edit how-to guides. In addition, presentations for internal use only can be uploaded.
Publications
The publications facility is available to all logged in users, though access can be narrowed down. Presentations can be added to the Publications facility. Publications may be read either by the world, by anyone who is logged in, by anyone in a particular workgroup, or by only the creator of the publication. This is a good way to share semi-public information that can be easily found, though the material itself can have restricted access.
CVS
The workgroup administrator can request that a Concurrent Version System (CVS) repository be created. CVS allows multiple users to a set of files. To use CVS, each user must have a CVS client such as TortoiseCVS and each user must Request A CVS Account. CVS is excellent for collaborating on papers.
Forums
The workgroup administrator can request that a forum, and/or a private forum be enabled. Forums have topics and topics have sections. A section can have uploads. This is a good way to quickly collect material for a particular topic. Each workgroup has two types of forums, a regular forum and a private forum. The access for each type of forum can be controlled by the workgroup administrator.
FAQ (Frequently Asked Question)
The workgroup administrator can request that a FAQ be enabled. FAQs have sections and sections have questions. FAQs do not have uploads, so to share a file, you would need to provide a link to a separate location. The access for a FAQ can be controlled by the workgroup administrator.

Comparison of technologies

FacilityEase of use for new users Most suitable for Access Control Drawbacks
WikisVery Easy Excellent for how-to guides Selected on a per workgroup basis by the workgroup admin. Can be public, logged in users only, group guests and members or group members only Requires a little knowledge about wikis.
PublicationsEasy Excellent for presentations that are publicly available, though access may be restricted Selected on a per publication basis. Can be public, logged in users only, group guests and members or creator only Reference to the publication is world readable, though the publication itself is protected
CVSInitial set up is complex Excellent for collaborating on non-binary documents such as software or LaTeX papers. Provides access to previous versions. No size limit. Repositories are usually readable by anyone who has a CVS account, though upon special request, this can be changed. On the website, the repository is selected on a per workgroup basis by the workgroup admin. Can be public, logged in users only, group guests and members or group members only Works best with non-binary documents. Binary documents can be shared, but multiple users editing a binary document does not work.
ForumsEasiest Excellent way to collect presentations Selected on a per workgroup basis by the workgroup admin. Can be public, logged in users only, group guests and members or group members only Older interface
FAQEasiest Does not have uploads, more useful for answering questions. Selected on a per workgroup basis by the workgroup admin. Can be public, logged in users only, group guests and members or group members only Older interface

Except for CVS, the different facilities have upload size limits of 20 Mb (as of 12/2010).

Except for CVS, the different facilities have no versioning. To update a file, update a file with the same name as the previous file.

General questions about the website.

How do I check out my own copy of the main page with SVN?
The main page is in a Subversion (SVN) repository. To update the main page, you need administrative privileges in the embedded workgroup. To request permission, go to Options and request administrative access in the embedded workgroup.

Once you have been granted administrative privileges in the embedded workgroup, obtain Version Control access to request creation of your svn account. Once you have your svn account, follow the instructions at How do I update work group pages using SVN?

The URL for the repository containing the main page of the Embedded website will be:
svn co https://repo.eecs.berkeley.edu/svn/projects/embedded/embeddedwww/trunk/embeddedwww

How do I update workgroup pages using SVN?

This page is about updating the workgroups of the website. To update the main page, see How do I check out my own copy of the main page with SVN?

Getting started quickly

Many of the workgroups have a SVN Repository associated with them.

The idea behind SVN is that SVN copies a version of a source repository on repo.eecs to your local machine. The svn commands are run on your local machine, edits are made, the changes are committed and then the website is update.

To update the workgroup pages, do the following

  1. Request a Version Control (VC) account or access. Note that your login on repo.eecs.berkeley.edu may be different than your login on the website.
    If you have a UCB EECS account, then your login on repo.eecs will be the same as your UCB EECS login. Note that even if you have a UCB EECS account, you will still need to request access to the repository.
    If you do not have a UCB EECS account, then your login on repo.eecs will be your email address.
    If your username on repo is different than your local account, then in the commands below you can use --username yourusername@youremail.com, for example, --username elvis@graceland.com
  2. Install Subversion. If you are using Windows, try TortoiseSVN. See below for detailed instructions.
  3. All the repositories for the CHESS, CPS-FORCES, E3S, Embedded, iCyPhy, Robotics, TerraSarm and TRUST websites are on repo.eecs.berkeley.edu.
    Each of the above websites has multiple workgroups (and a repository for the main site)
    To check out the SVN repository associated with a workgroup, you need to know where the repository is located.
    SVN uses a URL to refer to the repository.
    On repo.eecs.berkeley.edu, each of the website is associated with a project. The location of project forms the first part of the URL, for example https://repo.eecs.berkeley.edu/svn/projects/trust/.
    The second part of the URL refers to the workspace, for example, the wise workgroup would be wise/trunk/wise.
    So, the complete URL would be https://repo.eecs.berkeley.edu/svn/projects/trust/wise/trunk/wise.
    The table below lists the websites and the first part of the URL
    Website First part of the Repository URL
    CHESS https://repo.eecs.berkeley.edu/svn/projects/chess/
    E3S https://repo.eecs.berkeley.edu/svn/projects/e3s/
    Embedded https://repo.eecs.berkeley.edu/svn/projects/embedded/
    iCyPhy https://repo.eecs.berkeley.edu/svn/projects/icyphy/
    Robotics https://repo.eecs.berkeley.edu/svn/projects/robotics/
    TerraSwarm https://repo.eecs.berkeley.edu/svn/projects/terraswarm/
    TRUST https://repo.eecs.berkeley.edu/svn/projects/trust/

     

    The second part of the URL is workgroupName/trunk/workgroupName, for example wise/trunk/wise.
  4. If you have a UCB EECS account: To check out the TRUST wise workgroup, the command lines would be
          svn co https://repo.eecs.berkeley.edu/svn/projects/trust/wise/trunk/wise
        
    If you do not have a UCB EECS account: and your email address was elvis@graceland.com
          svn co --username elvis@graceland.com https://repo.eecs.berkeley.edu/svn/projects/trust/wise/trunk/wise
        
    This will create a directory "execboard" with a subdirectory "web" with at least one file, "index.html". After this directory is created, you never need to run svn co ... again.
    Next time you want to edit files for the workgroup, just go to this wise/ directory and type:
       svn update
       
    It will update your local copies of the files.
  5. You can edit the index.html file, or any other file in the directory.
  6. You can add a new file or directory by putting it in the same directory and doing:
       svn add filename.html
       
  7. To commit your changes, do:
        svn commit -m "Added myself" web/index.html
       
  8. Once you have committed the changes, you can make them visible on the website by going to the website and clicking on Update at the bottom of any page.

Detailed instructions about Checking Out a Repository

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

Bear in mind that SVN authoring is generally useful for software projects, in which case we assume that you know the basics of SVN. For information about the repository, see the EECSRepo FAQ.

  1. If you are a group administrator of a website workgroup, 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. FIXME: We are still transitioning from CVS to SVN, so the choice is CVS Checkin
    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 Version Control account on repo.eecs.berkeley.edu, and access get one. You can request a VC account. Even if you already have a UCB EECS account, your account will need to be granted read/write access to the repository.
  3. If Subversion is not yet installed, then install the Subversion.
    For Linux and Mac OS X, try running svn --version from the command line. If that command is not present, then you must install Subversion. For Windows, the command line might work from Cygwin Bash, if Cygwin Bash has been installed. However, most Windows users will install TortoiseSVN.
    • For Unix, to download Subversion, see: https://subversion.apache.org/packages.html
    • For Mac OS X:
      Find a Subversion Mac OS X application such as SvnX. SvnX requires that you install svn by hand, but helpfully includes instructions. If you are using svnX, please see the website-specific instructions.
      OR
      Install from the Subversion site.
      OR
      1. Install Xcode from Apple, which includes gcc and other tools. Xcode is usually free, but can only be installed via the Mac App store, which requires an Apple Store login and a credit card.
      2. Download and installed the Command Line Tools for your version of Mac OS X by going to https://developer.apple.com/downloads/index.action and searching for Command Line Tools.
      3. If the installation is successful, then svn --version will now work in the Terminal window.
    • For Windows, you can use TortoiseSVN or download svn and OpenSSH as part of Cygwin.

Using TortoiseSVN

  • Download and install TortoiseSVN
  • Go to the directory where you want to check out the repository, right click and select SVN Checkout
  • All the repositories for the CHESS, E3S, Embedded, iCyPhy, TerraSarm and TRUST websites are on repo.eecs.berkeley.edu.
    Each of the above websites has multiple workgroups (and a repository for the main site)
    To check out the SVN repository associated with a workgroup, you need to know where the repository is located.
    SVN uses a URL to refer to the repository.
    On repo.eecs.berkeley.edu, each of the website is associated with a project. The location of project forms the first part of the URL, for example https://repo.eecs.berkeley.edu/svn/projects/trust/.
    The second part of the URL refers to the workspace, for example, the wise workgroup would be wise/trunk/wise.
    So, the complete URL would be https://repo.eecs.berkeley.edu/svn/projects/trust/wise/trunk/wise.

    Make these changes to the dialog:
    URL of Repository
    Choose according to the Website
    The table below lists the websites and the first part of the URL
    Website URL of Repository
    CHESS https://repo.eecs.berkeley.edu/svn/projects/chess/
    E3S https://repo.eecs.berkeley.edu/svn/projects/e3s/
    Embedded https://repo.eecs.berkeley.edu/svn/projects/embedded/
    iCyPhy https://repo.eecs.berkeley.edu/svn/projects/icyphy/
    TerraSwarm https://repo.eecs.berkeley.edu/svn/projects/terraswarm/
    TRUST https://repo.eecs.berkeley.edu/svn/projects/trust/
    The second part of the URL is workgroupName/trunk/workgroupName, for example wise/trunk/wise.

    Below is a sample screen shot that would be used to check out the TRUST website:

    Screenshot of TortoiseSVN

    When you hit OK, you will be prompted for your password twice.
    If your account on repo.eecs has been set up with access to the repository, then after you 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. To associate the file with a specific editor, e.g. WordPad, right click on the file and choose Explore from the menu. Right click again on your file and select <Open with...> Wordpad. When you are through editing, then right click and select CVS Commit, enter a log message and select OK.

    To update the website, go to the main site, log in to the website scroll to the bottom of the page and select Update.

    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
      

    Who do I contact about this site?

    The site is maintained by Mary Stewart and Christopher Brooks.

    There is also the dopadmin (at) embedded dot eecs berkeley edu email address.

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 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.

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 update workgroup pages using SVN?

This page is about updating the workgroups of the website. To update the main page, see How do I check out my own copy of the main page with SVN?

Getting started quickly

Many of the workgroups have a SVN Repository associated with them.

The idea behind SVN is that SVN copies a version of a source repository on repo.eecs to your local machine. The svn commands are run on your local machine, edits are made, the changes are committed and then the website is update.

To update the workgroup pages, do the following

  1. Request a Version Control (VC) account or access. Note that your login on repo.eecs.berkeley.edu may be different than your login on the website.
    If you have a UCB EECS account, then your login on repo.eecs will be the same as your UCB EECS login. Note that even if you have a UCB EECS account, you will still need to request access to the repository.
    If you do not have a UCB EECS account, then your login on repo.eecs will be your email address.
    If your username on repo is different than your local account, then in the commands below you can use --username yourusername@youremail.com, for example, --username elvis@graceland.com
  2. Install Subversion. If you are using Windows, try TortoiseSVN. See below for detailed instructions.
  3. All the repositories for the CHESS, CPS-FORCES, E3S, Embedded, iCyPhy, Robotics, TerraSarm and TRUST websites are on repo.eecs.berkeley.edu.
    Each of the above websites has multiple workgroups (and a repository for the main site)
    To check out the SVN repository associated with a workgroup, you need to know where the repository is located.
    SVN uses a URL to refer to the repository.
    On repo.eecs.berkeley.edu, each of the website is associated with a project. The location of project forms the first part of the URL, for example https://repo.eecs.berkeley.edu/svn/projects/trust/.
    The second part of the URL refers to the workspace, for example, the wise workgroup would be wise/trunk/wise.
    So, the complete URL would be https://repo.eecs.berkeley.edu/svn/projects/trust/wise/trunk/wise.
    The table below lists the websites and the first part of the URL
    Website First part of the Repository URL
    CHESS https://repo.eecs.berkeley.edu/svn/projects/chess/
    E3S https://repo.eecs.berkeley.edu/svn/projects/e3s/
    Embedded https://repo.eecs.berkeley.edu/svn/projects/embedded/
    iCyPhy https://repo.eecs.berkeley.edu/svn/projects/icyphy/
    Robotics https://repo.eecs.berkeley.edu/svn/projects/robotics/
    TerraSwarm https://repo.eecs.berkeley.edu/svn/projects/terraswarm/
    TRUST https://repo.eecs.berkeley.edu/svn/projects/trust/

     

    The second part of the URL is workgroupName/trunk/workgroupName, for example wise/trunk/wise.
  4. If you have a UCB EECS account: To check out the TRUST wise workgroup, the command lines would be
          svn co https://repo.eecs.berkeley.edu/svn/projects/trust/wise/trunk/wise
        
    If you do not have a UCB EECS account: and your email address was elvis@graceland.com
          svn co --username elvis@graceland.com https://repo.eecs.berkeley.edu/svn/projects/trust/wise/trunk/wise
        
    This will create a directory "execboard" with a subdirectory "web" with at least one file, "index.html". After this directory is created, you never need to run svn co ... again.
    Next time you want to edit files for the workgroup, just go to this wise/ directory and type:
       svn update
       
    It will update your local copies of the files.
  5. You can edit the index.html file, or any other file in the directory.
  6. You can add a new file or directory by putting it in the same directory and doing:
       svn add filename.html
       
  7. To commit your changes, do:
        svn commit -m "Added myself" web/index.html
       
  8. Once you have committed the changes, you can make them visible on the website by going to the website and clicking on Update at the bottom of any page.

Detailed instructions about Checking Out a Repository

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

Bear in mind that SVN authoring is generally useful for software projects, in which case we assume that you know the basics of SVN. For information about the repository, see the EECSRepo FAQ.

  1. If you are a group administrator of a website workgroup, 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. FIXME: We are still transitioning from CVS to SVN, so the choice is CVS Checkin
    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 Version Control account on repo.eecs.berkeley.edu, and access get one. You can request a VC account. Even if you already have a UCB EECS account, your account will need to be granted read/write access to the repository.
  3. If Subversion is not yet installed, then install the Subversion.
    For Linux and Mac OS X, try running svn --version from the command line. If that command is not present, then you must install Subversion. For Windows, the command line might work from Cygwin Bash, if Cygwin Bash has been installed. However, most Windows users will install TortoiseSVN.
    • For Unix, to download Subversion, see: https://subversion.apache.org/packages.html
    • For Mac OS X:
      Find a Subversion Mac OS X application such as SvnX. SvnX requires that you install svn by hand, but helpfully includes instructions. If you are using svnX, please see the website-specific instructions.
      OR
      Install from the Subversion site.
      OR
      1. Install Xcode from Apple, which includes gcc and other tools. Xcode is usually free, but can only be installed via the Mac App store, which requires an Apple Store login and a credit card.
      2. Download and installed the Command Line Tools for your version of Mac OS X by going to https://developer.apple.com/downloads/index.action and searching for Command Line Tools.
      3. If the installation is successful, then svn --version will now work in the Terminal window.
    • For Windows, you can use TortoiseSVN or download svn and OpenSSH as part of Cygwin.

Using TortoiseSVN

  • Download and install TortoiseSVN
  • Go to the directory where you want to check out the repository, right click and select SVN Checkout
  • All the repositories for the CHESS, E3S, Embedded, iCyPhy, TerraSarm and TRUST websites are on repo.eecs.berkeley.edu.
    Each of the above websites has multiple workgroups (and a repository for the main site)
    To check out the SVN repository associated with a workgroup, you need to know where the repository is located.
    SVN uses a URL to refer to the repository.
    On repo.eecs.berkeley.edu, each of the website is associated with a project. The location of project forms the first part of the URL, for example https://repo.eecs.berkeley.edu/svn/projects/trust/.
    The second part of the URL refers to the workspace, for example, the wise workgroup would be wise/trunk/wise.
    So, the complete URL would be https://repo.eecs.berkeley.edu/svn/projects/trust/wise/trunk/wise.

    Make these changes to the dialog:
    URL of Repository
    Choose according to the Website
    The table below lists the websites and the first part of the URL
    Website URL of Repository
    CHESS https://repo.eecs.berkeley.edu/svn/projects/chess/
    E3S https://repo.eecs.berkeley.edu/svn/projects/e3s/
    Embedded https://repo.eecs.berkeley.edu/svn/projects/embedded/
    iCyPhy https://repo.eecs.berkeley.edu/svn/projects/icyphy/
    TerraSwarm https://repo.eecs.berkeley.edu/svn/projects/terraswarm/
    TRUST https://repo.eecs.berkeley.edu/svn/projects/trust/
    The second part of the URL is workgroupName/trunk/workgroupName, for example wise/trunk/wise.

    Below is a sample screen shot that would be used to check out the TRUST website:

    Screenshot of TortoiseSVN

    When you hit OK, you will be prompted for your password twice.
    If your account on repo.eecs has been set up with access to the repository, then after you 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. To associate the file with a specific editor, e.g. WordPad, right click on the file and choose Explore from the menu. Right click again on your file and select <Open with...> Wordpad. When you are through editing, then right click and select CVS Commit, enter a log message and select OK.

    To update the website, go to the main site, log in to the website scroll to the bottom of the page and select Update.

    How do I check out my own copy of the main page with SVN?
    The main page is in a Subversion (SVN) repository. To update the main page, you need administrative privileges in the embedded workgroup. To request permission, go to Options and request administrative access in the embedded workgroup.

    Once you have been granted administrative privileges in the embedded workgroup, obtain Version Control access to request creation of your svn account. Once you have your svn account, follow the instructions at How do I update work group pages using SVN?

    The URL for the repository containing the main page of the Embedded website will be:
    svn co https://repo.eecs.berkeley.edu/svn/projects/embedded/embeddedwww/trunk/embeddedwww

How do I reserve 540 A/B Cory?
Information about reserving 540 A/B Cory.

How do I reserve a DOP Center Room or 540 A/B Cory?

Note: Starting in February, 2013, to reserve 540A/B, you must use bCal. See Cory and Soda Hall Room Reservations.
540A/B is managed by the EECS Department, not by the DOP Center.

For 529 (The library), 540R (The "video conference room") and 540X (The forum), see below.

We use the dopcenter workgroup calendar to schedule 529, 540R and 540X. To edit the calendar, you must be a member of the dopcenter workgroup. Membership in the dopcenter workgroup is open to faculty and staff. Students should use the faculty list to find the name of a staff person associated with their faculty and have the staff person request an account.

529, 540R and 540X Room Reservation Procedure

To reserve 540A/B, see above. To reserve 529, 540R and 540X, see below.

  1. Request membership in the dopcenter workgroup.
    If you do not sit at a desk in the DOP center, then select guest and you will not be added to the DOP Center email list.
      (Note to admins: if someone want to make a reservation, they will need to be a full dopcenter member. The workaround is to upgrade new members to full membership and then remove them from the mailing list by hand)
  2. Go to the DOP Center Calendar and add a reservation by clicking on the number of the day in which you would like to reserve the room.
    • If the room is already reserved for that day and time, it is up to you to resolve the scheduling conflict according to the policy below. In general, reviews have priority over workshops, workshops have priority over seminars and seminars have priority over classes.
    • Your reservation should include the name of the faculty sponsor, the event and the room number. For example
      Prof. Ptolemy. EECS Office Hours, 529 Cory
      
      The reason to include the room number is to make it clear what room is being reserved. The calendar is used to reserve more than just one room.
    • Note that there is a bug that prevents certain characters in the title from being displayed. Characters such as parenthesis ( and ) will be translated into their HTML codes. The workaround is to stick to alphanumerics, commas and dashes. Sorry!
    • If you do a repeating reservation, please only repeat your reservation for one semester. Also, please check for conflicts when you place a repeating reservation - conflicts are not automatically detected.

Rooms in the DOP Center

  • 529 Library, note that DOP faculty have priority for 529. To reserve 529, use the DOP Center Calendar and be sure to mention 529 Library. (FIXME: How many people can it hold?):
  • 545R Video Conference Room, note that DOP faculty have priority for 545R. To reserve 545R, use the DOP Center Calendar and be sure to mention 545R. Note that the conference phone in 545R requires a phone code to dial 800 numbers. DOP Center residents, see Conference Calls. Non-DOP Center residents, have your grant administrator get a voice authorization code by going to http://sagebrush.berkeley.edu/cgi-bin/ws515/sc.r -> Voice Services -> Authorization Code. The incoming line for 545R is 510-642-6322. (FIXME: How many people can it hold?)
  • 545X Forum
  • Other Rooms

    The Chess Software Lab (337A Cory)
    Chess members can schedule 337 Cory, see How do I schedule 337 Cory?
    The TRUST Conference Room (337B)
    TRUST members can schedule 337B Cory, see How do I schedule 337B Cory?
    Other rooms in Cory and Soda
    The EECS Dept. Website Room Reservation Page
    Bechtel and Hearst
    College of Engineering Facilities Reservation System
    Sutardja Dai Hall
    Sutardja Dai Hall Facilities.
    Hass
    Haas UC Facilities page
    UC Berkeley Conference Services
    Conference Services page
    Campus event facilities
    events.berkeley.edu

    Other resources

    Floor plan of the Donald O. Pederson Center and surrounding offices. The DOP Center consists of 528, 529, 540 and 545 Cory.

    Wiki
    Information about the wiki facility.

    How do I set up a Wiki?
    Website workgroups can have a wiki associated with them. To enable the wiki, go to the "admin" page for your workgroup, then select "Configure Group", click on the Wiki box and select "Change Group Configuration".

    Email will be sent to the website staff, who will set up your wiki and email you when the setup is done.

    (website staff, see How do I set up the Wiki infrastructure)

    How do I configure the wiki?

    These notes are based on email from Jonathan Sprinkle (Thanks Jon!)
    These notes are shared between a number of websites, which is why we are not using the wiki

    Wiki Overview

    The way the wiki works is a little bit tricky. (tricky wiki)

    We use PmWiki and wiki farms.

    Each workgroup that has a wiki has a few configuration files checked in to CVS under workgroupName/web/wiki. To access these files, use CVS. For example for workgroups on the Trust website:

    cvs -d :ext:source.eecs.berkeley.edu:/home/cvs_trust co workgroupName
    
    Once you make your changes, check them in and then click on the CVS Update link on the main page. For more information, see How do I edit pages in a group with the "CVS Authoring" option?

    Things that appear at the top of a wiki page

    Changing the title

    To change the title to anything you would like, use:

    (:title Foo Bar:)
    

    Table of Contents

    PageTableOfContents: looks for tags like
    (:toc:)
    
    See PageTableOfContents for details.

    Useful style directives

    Comments

    To create a comment in the wiki, use:
    (:if false:)
    text to omit
    (:ifend:) 
    

    Wiki comments are a good way to tell editors about details such as that lists should be alphabetical.

    sourceblock

    By the way, if you're adding code segments to the wiki, we installed the sourceblock package from the cookbook: http://www.pmwiki.org/wiki/Cookbook/SourceBlock To add/format source, use:

    (:source:)                                                                    
    $ ls -la
    (:sourcend:)                                                                  
    
    To get those nifty little boxes that call out source from readable text. You can give specific languages and it will format that text correctly as well...
    (:source lang=bash header=/etc/bash.bashrc:) export                           
    ICE_HOME=/opt/Ice-3.1.0 export PATH=$ICE_HOME/bin:$PATH                       
    export LD_LIBRARY_PATH=$ICE_HOME/lib:$LD_LIBRARY_PATH                         
    (:sourcend:)                                                                  
    
    As from http://chess.eecs.berkeley.edu/dgc3/wiki/Dgc3/ComputerConfigOrca2Prereq

    Languages that are supported can be found here (GeSHi tool): http://qbnz.com/highlighter/

    emenu

    ExpandingMenu is another possibility. It is used by the Escher Wiki

    Wiki Configuration things to try

    Skins

    PmWiki Skins can be used to change the look and feel.

    If you want to try a new a skin, then the website admins probably need to add it to the wiki-wide skins directory. For example, /export/home/www/php/pmwiki/pub/skins needed to have the monobook directory set up.

    As of 1/7, we have the simple and monobook skins. The monobook skin is now the default. The monobook skin is similar to the skin used by Wikipedia. To select a skin, create wiki/local/config.php and

    <?php
    # Specifies the name of the template file
    # to be used to generate pages.
    $Skin = 'simple';
    ?>
    
    Note: the file must start with <? and end with ?>. The last line must end in a new line

    It is possible to place a copy of the skins directory in your own wiki, but this gets confusing since the paths tend to look for files in the wiki-wide directory. If you find a skin you would like to try, send email to webmgr at embedded eecs berkeley edu and we can add it to ~www/php/pmwiki/pub/skins.

    An example config.php

    A more complex wiki/local/config.php:

    <?php if (!defined('PmWiki')) exit();
    $WikiTitle = "DARPA Grand Challenge 3 (DGC3)";
    $PageLogoUrl = "http://chess.eecs.berkeley.edu/dgc3/images/gdc150.gif";
    
    $DefaultPasswords['admin'] = crypt('notarealpassword');
    
    $EnableUpload = 1;
    $DefaultPasswords['upload'] = crypt('notanotherrealpass');
    
    include_once('cookbook/sourceblock.php');
    
    putenv("TZ=EST5EDT");
    $TimeFmt = '%B %d, %Y, at %I:%M %p EST';
    ?>
    

    JsMenu

    JsMath:Add markup to display and embed mathematical formulas in wiki pages using TeX was set up and could be set up again

    Upload Extensions

    To add an extension to the list of acceptable extensions to be uploaded, add
    $UploadExts['wmv'] = 'video/wmv';
    
    to web/wiki/local/config.php in the cvs repository for the group. Then do a cvs update: http://host/group?Action=cvsupdate.

    Admin

    Systems Administrator level pages (for people who have a login account on the webserver): How do I set up the Wiki System?

    How do I change access to the wiki?
    To change who can access a wiki, go to the admin -> access page for the workgroup.

    See also How do I control access to my workspace?

    How do I change the logo in the corner of the wiki?
    To change the logo, use CVS to edit wiki/local/pgcust.php and add $PageLogoURL:
    <?php if (!defined('PmWiki')) exit();
    $WikiTitle = "DARPA Grand Challenge 3 (DGC3)";
    $PageLogoUrl = "http://chess.eecs.berkeley.edu/dgc3/images/logo-150.png";
    ?>
    

    Once you make your changes, check them in and then click on the CVS Update link on the main page. For more information, see How do I edit pages in a group with the "CVS Authoring" option?

    How do I mirror a wiki?
    http://www.pmwiki.org/wiki/Cookbook/ExportHTML?from=Cookbook.PmWiki2HTML-usingWGET says:
    wget -r -k -np -p -l 0 http://example.org/wiki
    
    That page has other suggestions about how to get html.

    However, we have authentication, so Look up the websitesessionKey cookie in your browser and then use it with wget:

    wget -r -k -np -p -l 0 --no-cookies 
     --header "Cookie: websiteSessionKey=xxxxxxxxxxxxxxxxxxxx" 
     --reject "*action=print","*action=diff","*action=upload","*action=edit"
     http://website_long_name/group/wiki/ 
    

    How do I change the title of the wiki?

    To change the title, edit the wiki page and use

    (:title This is the title:)
    

    Another way is to use CVS to edit wiki/local/pgcust.php and add or edit $WikiTitle:

    <?php if (!defined('PmWiki')) exit();
    $WikiTitle = "DARPA Grand Challenge 3 (DGC3)";
    ?>
    

    Once you make your changes, check them in and then click on the CVS Update link on the main page.

    For more information, see How do I edit pages in a group with the "CVS Authoring" option?

    How do I get rid of 'HomePage'?
    To change the default, use CVS to edit wiki/local/pgcust.php and add $DefaultName or $DefaultGroup:
    <?php if (!defined('PmWiki')) exit();
    $DefaultGroup= "Gsoc";
    $DefaultName= "Gsoc";
    ?>
    

    See PmWiki Basic Variables for details.

    Once you make your changes, check them in and then click on the CVS Update link on the main page.

    For more information, see How do I edit pages in a group with the "CVS Authoring" option?

    Printing
    Information about Printing.

    This FAQ is no longer maintained.

    For up-to-date information, please see the bottom of Day to Day Operations for more information.

    You are not logged in 
    Contact 
    ©2002-2017 U.C. Regents