Deploy and Customize Ushahidi

(Difference between revisions)
Jump to: navigation, search
(Directions:)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
{| border="1"
+
 
 +
{| class="wikitable"
 
|-  
 
|-  
|'''Title''' || Deploy & Customize Ushahidi
+
| '''Title''' || Deploy & Customize Ushahidi
 
|-
 
|-
|'''Overview''' || Students will download Ushaidi and install it on either the cloud (using Heroku) or on a VM or on an actual Linux machine.
+
| '''Overview''' || Students will download Ushaidi and install it on either the cloud (using Heroku) or on a VM or on an actual Linux machine.
 
|-  
 
|-  
|'''Prerequisite Knowledge''' || Understand client/server concept, how to install software, how to use command line interfaces, basic XML concepts.
+
| '''Prerequisite Knowledge''' || Understand client/server concept, how to install software, how to use command line interfaces, basic XML concepts.
 
|-
 
|-
|'''Learning Objectives''' || 1.  Implement and deploy a basic working Ushahidi server 2.  configure Ushahidi server 3.  Deploy a Ushaihid client
+
| '''Learning Objectives''' || 1.  Implement and deploy a basic working Ushahidi server 2.  configure Ushahidi server 3.  Deploy a Ushaihid client
 
|}
 
|}
  
=== Background: ===
+
=== Background ===
'''Is there background reading material?'''
+
 
 +
''Is there background reading material?''
  
 
Students should be read Ushahidi install documentation:  https://www.ushahidi.com/support/install-ushahidi
 
Students should be read Ushahidi install documentation:  https://www.ushahidi.com/support/install-ushahidi
Line 20: Line 22:
 
Readings on the platform used.
 
Readings on the platform used.
  
'''Are there other activities the student should have done first?'''
+
''Are there other activities the student should have done first?''
  
 
Students should be familiar with Ushahidi and have examined or done an Ushahidi deployment.  Example deployments can be found at https://wiki.ushahidi.com/display/WIKI/Types+of+Maps
 
Students should be familiar with Ushahidi and have examined or done an Ushahidi deployment.  Example deployments can be found at https://wiki.ushahidi.com/display/WIKI/Types+of+Maps
  
'''What is the rationale for this activity?'''
+
''What is the rationale for this activity?''
  
 
This activity will give students a hands-on understanding of the Ushahidi server.
 
This activity will give students a hands-on understanding of the Ushahidi server.
  
'''Include helpful hints to faculty here.'''
+
''Include helpful hints to faculty here.''
  
 
Installing on Heroku is very simple and can be done without configuration or through a terminal with configuration.
 
Installing on Heroku is very simple and can be done without configuration or through a terminal with configuration.
Line 34: Line 36:
 
Installing on an actual Linux box can be challenging (or impossible) without previous Linux experience.
 
Installing on an actual Linux box can be challenging (or impossible) without previous Linux experience.
  
=== Directions: ===
+
=== Directions ===
'''What should the student do?'''
+
 
 +
''What should the student do?''
  
 
Instructions for installing Ushahidi can be found at [https://www.ushahidi.com/support/install-ushahidi https://www.ushahidi.com/support/install-ushahidi]
 
Instructions for installing Ushahidi can be found at [https://www.ushahidi.com/support/install-ushahidi https://www.ushahidi.com/support/install-ushahidi]
  
=== Deliverables: ===
+
=== Deliverables ===
'''What will the student hand in?'''
+
  
1.  Students will provide the URL of their server.
+
''What will the student hand in?''
  
2. Students will provide a 3 page reflection that includes
+
# Students will provide the URL of their server.
    a.  challenges encountered
+
# Students will provide a 3 page reflection that includes
    b.  reference to the instructions that they followed and comments on these
+
## challenges encountered
    c.  suggestions for others installing
+
## reference to the instructions that they followed and comments on these
    d.  configuration options that they used
+
## suggestions for others installing
 +
## configuration options that they used
  
=== Assessment: ===
+
=== Assessment ===
'''How will the activity be graded?'''
+
 
 +
''How will the activity be graded?''
  
 
Instructor will go to the URL and test the deployment.
 
Instructor will go to the URL and test the deployment.
Line 57: Line 61:
 
Students will perform an installation by following other student's instructions.
 
Students will perform an installation by following other student's instructions.
 
   
 
   
'''How will learning will be measured?'''
+
''How will learning will be measured?''
  
 
Learning will be measured through a reflective paper.
 
Learning will be measured through a reflective paper.
  
'''Include sample assessment questions/rubrics.'''
+
''Include sample assessment questions/rubrics.''
  
{| border="1" class="wikitable"
+
{| class="wikitable"
 
! Criteria
 
! Criteria
 
! Level 1 (fail)
 
! Level 1 (fail)
Line 81: Line 85:
 
| Paper just provides available instructions and contains no hints or reflection
 
| Paper just provides available instructions and contains no hints or reflection
 
| Paper provides enough information for a new user to perform a successful installation
 
| Paper provides enough information for a new user to perform a successful installation
| Paper provides rich information and hints and reflections on the process that the student followed  
+
| Paper provides rich information and hints and reflections on the process that the student followed
 
+
 
|}
 
|}
  
=== Comments: ===
+
=== Comments ===
'''What should the instructor know before using this activity?'''
+
''What should the instructor know before using this activity?''
  
 
Instructor should perform the installation prior to the start of the class.
 
Instructor should perform the installation prior to the start of the class.
  
'''What are some likely difficulties that an instructor may encounter using this activity?'''
+
''What are some likely difficulties that an instructor may encounter using this activity?''
  
 
Instructors must be aware of versions; these can change during the course.   
 
Instructors must be aware of versions; these can change during the course.   
Line 98: Line 101:
 
There are many dependencies which must be installed before Ushahidi can be installed.  These dependencies can change during the project.
 
There are many dependencies which must be installed before Ushahidi can be installed.  These dependencies can change during the project.
  
=== Additional Information: ===
+
=== Additional Information ===
{| border="1"
+
 
 +
{| class="wikitable"
 
|-  
 
|-  
|'''ACM Knowledge Area/Knowledge Unit''' || IM, information management, NC networking and communication  [[ACM_Body_of_Knowledge]]
+
| '''ACM Knowledge Area/Knowledge Unit''' || IM, information management, NC networking and communication  [[ACM_Body_of_Knowledge]]
 
|-
 
|-
|'''ACM Topic''' || Information Management Concepts, Networked Applications/client-server applications - https://www.acm.org/education/CS2013-final-report.pdf
+
| '''ACM Topic''' || Information Management Concepts, Networked Applications/client-server applications - https://www.acm.org/education/CS2013-final-report.pdf
 
|-
 
|-
|'''Level of Difficulty''' || Basic configuration is easy, advanced configuration is medium.
+
| '''Level of Difficulty''' || Basic configuration is easy, advanced configuration is medium.
 
|-
 
|-
|'''Estimated Time to Completion''' ||  2 hours
+
| '''Estimated Time to Completion''' ||  2 hours
 
|-
 
|-
|'''Materials/Environment''' || Students need a github account and access to either Heroku or a Linux box that can be configured.
+
| '''Materials/Environment''' || Students need a github account and access to either Heroku or a Linux box that can be configured.
 
|-
 
|-
|'''Author''' || Alan Rea, John Barr, Ying Liu, Jiang Li, Jonathan Poritz
+
| '''Author''' || Alan Rea, John Barr, Ying Liu, Jiang Li, Jonathan Poritz
 
|-
 
|-
|'''Source''' || None
+
| '''Source''' || None
 
|-
 
|-
|'''License''' || http://creativecommons.org/licenses/
+
| '''License''' || http://creativecommons.org/licenses/
 
|}
 
|}
  
=== Suggestions for Open Source Community: ===
+
=== Suggestions for Open Source Community ===
 +
 
 
Suggestions for an open source community member who is working in conjunction with the instructor.
 
Suggestions for an open source community member who is working in conjunction with the instructor.
  
Line 128: Line 133:
 
[[File:CC_license.png]]
 
[[File:CC_license.png]]
  
[[Category: Learning_Activity]]
+
[[Category:Learning Activity]]
[[Category: LEARNING_ACTIVITY_SUBCATEGORY]]
+
[[Category:Use and Evaluate]]
 +
[[Category:Ushahidi]]

Revision as of 13:49, 30 January 2017


Title Deploy & Customize Ushahidi
Overview Students will download Ushaidi and install it on either the cloud (using Heroku) or on a VM or on an actual Linux machine.
Prerequisite Knowledge Understand client/server concept, how to install software, how to use command line interfaces, basic XML concepts.
Learning Objectives 1. Implement and deploy a basic working Ushahidi server 2. configure Ushahidi server 3. Deploy a Ushaihid client

Background

Is there background reading material?

Students should be read Ushahidi install documentation: https://www.ushahidi.com/support/install-ushahidi

Readings on client/server architecture.

Readings on the platform used.

Are there other activities the student should have done first?

Students should be familiar with Ushahidi and have examined or done an Ushahidi deployment. Example deployments can be found at https://wiki.ushahidi.com/display/WIKI/Types+of+Maps

What is the rationale for this activity?

This activity will give students a hands-on understanding of the Ushahidi server.

Include helpful hints to faculty here.

Installing on Heroku is very simple and can be done without configuration or through a terminal with configuration.

Installing on an actual Linux box can be challenging (or impossible) without previous Linux experience.

Directions

What should the student do?

Instructions for installing Ushahidi can be found at https://www.ushahidi.com/support/install-ushahidi

Deliverables

What will the student hand in?

  1. Students will provide the URL of their server.
  2. Students will provide a 3 page reflection that includes
    1. challenges encountered
    2. reference to the instructions that they followed and comments on these
    3. suggestions for others installing
    4. configuration options that they used

Assessment

How will the activity be graded?

Instructor will go to the URL and test the deployment.

Students will perform an installation by following other student's instructions.

How will learning will be measured?

Learning will be measured through a reflective paper.

Include sample assessment questions/rubrics.

Criteria Level 1 (fail) Level 2 (pass) Level 3 (good) Level 4 (exceptional)
Ushahidi installed Does not run Runs with stock configuration Runs with some configurations Runs and is completely configured
Reflection No information provided Paper just provides available instructions and contains no hints or reflection Paper provides enough information for a new user to perform a successful installation Paper provides rich information and hints and reflections on the process that the student followed

Comments

What should the instructor know before using this activity?

Instructor should perform the installation prior to the start of the class.

What are some likely difficulties that an instructor may encounter using this activity?

Instructors must be aware of versions; these can change during the course.

Installation procedures change often.

There are many dependencies which must be installed before Ushahidi can be installed. These dependencies can change during the project.

Additional Information

ACM Knowledge Area/Knowledge Unit IM, information management, NC networking and communication ACM_Body_of_Knowledge
ACM Topic Information Management Concepts, Networked Applications/client-server applications - https://www.acm.org/education/CS2013-final-report.pdf
Level of Difficulty Basic configuration is easy, advanced configuration is medium.
Estimated Time to Completion 2 hours
Materials/Environment Students need a github account and access to either Heroku or a Linux box that can be configured.
Author Alan Rea, John Barr, Ying Liu, Jiang Li, Jonathan Poritz
Source None
License http://creativecommons.org/licenses/

Suggestions for Open Source Community

Suggestions for an open source community member who is working in conjunction with the instructor.



This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License

CC license.png

Personal tools
Namespaces
Variants
Actions
Events
Learning Resources
HFOSS Projects
Evaluation
Navigation
Toolbox