Filtered by date 2019-09-25, 1 - 7 of 7 Postings (
all,
summary)
Created by Caroline Meeks, last modified by Gustaf Neumann 25 Sep 2019, at 10:20 PM
url stub: /assessment/asm-admin/
url: http://mgh.zill.net/assessment/asm-admin/
Current: 
This is the "top level" it should have links to things that are potentially used in all Assessments.
I suggest the following links in class = button style along the top.
[[New Assessment]] | [[Display Types]] | Categories | Actions | Requests | Permissions | Documentation
- We don't need to repeat the word "Administer" we are on the administration page.
- Remove the QTI upload, it is another way to create a New Assessment so it should be an option after you click New Assessment.
- Remove Export and Permissions from the list of Assessments. Those are options that have to do with one assessment and should be on that assessment's admin page Assessment_one-a.
Assessment Listing
Display the list of assessments as a sortable table. We have moved some actions to the Assessment_one-a page so lets use that real estate to give people information that might help them find the Assessment they are interested in.
Title Last Modified By Last Modified Date Request Permission
Created by OpenACS community, last modified by Gustaf Neumann 25 Sep 2019, at 10:13 PM
This is Approach 4 of the en:Documentation_Project as defined in Documentation_Project_Discussion. Users benefit when they can read docs the way the brain likes to work. Contributions to various OpenACS topics that further the plan are welcome.
Background
See Documentation history
Goal
to write superb documentation, so that users, developers and administrators of OpenACS installations can enjoy working with and using the system (with fewer headaches! =)
Scope
OpenACS documentation, a systems view as a collection of subsystems and their parts.
API Documentation: there are no plans to move the API docs to XoWiki. That should remain as is.
DocBook docs at: https://openacs.org/doc/index.html are evolving separately at en:New_Documentation_Process
Requirements
Requirements is about setting specifications and milestones we can verify, and includes exploration of scenarios, use cases etc.
Here are documentation requirements for:
Available resources
- volunteers dedicated to regularly managing and updating the documentation
- other volunteers who contribute arguably more valuable documentation less frequently (such as magazine articles ;) (and may need some assistance etc. to have their work fit into docs well.)
- openacs.org website, including use of xowiki
- open-source software, text editors, spell checkers, HTML code validators etc.
- Approaches in docs management explored. See en:Documentation_Project_Discussion
Strategy
Strategy is about creating an approach to doing work. It guides behavior and tactical decisions on the work effort.
Shape ongoing documentation efforts by using principles of continual improvement and following general requirements to re-engineer documentation production and management.
OpenACS documentation development is subject to constraints of the software project development and release methods and cycles (the section called “Using CVS with OpenACS”). Essentially, all phases of work may be active to accommodate the asynchronous nature of multiple subprojects evolving by the efforts of a global base of participants with culturally diverse time references and scheduling idiosyncrasies.
The documentation strategy is to use methods that inspire collaborating or obtaining guidance or feedback (peer review) to distribute the workload and increase the overall value of output for the OpenACS project.
subdivide by subsystems and how they are used (context). Why?
"..the human mind can only deal with a relatively small number of independent pieces of data at one time, but if data are chunked together in appropriate ways, the mind can perform higher order abstractions, and these in turn can be chunked together, with successive abstractions, until an entire complex situation is encompassed. The systems approach addresses this property of the human mind by providing strategies for the data gathering, chunking, and abstracting process." George G. Lendaris, On Systemness and the Problem Solver: Tutorial comments 1983.
XoWiki docs can use a systems strategy of multiple perspectives to help identify subsystems and how OpenACS works.
Each XoWiki page discusses a single topic.
These topics are pieced together by any number of other xowiki pages to present an ordered presentation of the topics with a common thread/topic connecting them.
For example, en:openacs-system-install is a page that links together the topics of installing the component software of Openacs. Similarly, each component software, such as en:aolserver, has its own view of some overlapping topics.
XoWiki documents organized by subsystems (and how they are used) are easy to update and maintain since there is only one place to put relevant information for a particular topic.
Pages are not encumbered by a maze of categories that tend to only address one or a few perspectives, since pages link to related pages, and a page that addresses each perspective can link to overlapping topics.
In an ideal world, XoWiki will be able to export a page and all the pages that link to it, to any depth of the linkage tree, to form one document. That way, innumerable documents, each with a valid perspective, can be built for a specific purpose.
Work Breakdown Structure
Or Objectives and Key Results (OKRs) is about explicitly stating the way to implement the strategy as a set of milestones and the methods to use.
Allow document writers to reference package API via api-doc by using package_url, or find the local package_id so a link can be supplied from the local documentation to current, up-to-date API and SQL docs, like: https://openacs.org/api-doc/package-view?version_id=358136 use links like this: /api-doc/index?about_package_key=acs-datetime The feature has been added to cvs head (OpenACS 5.3.x) so will be released soon.[DONE]
Iterate through each topic on each docbook page.
- Port the docbook pages to xowiki manually, because it allows me to look at each part in details and separate to subsystem/object context. Here is the process:
- Browse to docbook url (something in this tree: https://openacs.org/doc/)
- View page source
- Copy the relevant part of source
- Paste that source to your favorite text editor (not word processor).
- Edit the page source, removing DIV tags and TARGET="_blank" attributes. Look for any immediate way to improve the document, make additional edits, check for spelling etc.
- In a browser, open or create the xowiki page. Choose "Source" to view source html. Be sure to make Name starting with "en:"
- Paste edited source into the xowiki page, repeat editing if needed
- Click "ok" to post the xowiki changes.
- That's it! (repeat)
Example documentation outline in wiki
These pages contain links to other pages where items are discussed in context:
These pages describe various OpenACS subsystems, and link to external documents where possible and appropriate. Note that an "OpenACS system" en:openacs-system page that outlines the system and ties these together is part of the end-user docs.
Auxiliary systems
| en:ide-emacs |
gnu emacs as IDE |
| [en:ide-emacs-nxml] |
gnu emacs nXML Mode |
| [en:ide-emacs-psgml] |
gnu emacs PSGML Mode |
| en:ide-vi |
vi/vim as IDE |
Verification
This is where we measure how well this plan was implemented. Success is measured by
- A) verifying if the project has met the established goals and requirements, and
- B) reviewing for ongoing problem areas etc.
Observations then help to modify the plan for the next documentation revision.
OpenACS follows verification through different means on different projects, but in all cases, the OpenACS community verifies the project as a success through feedback including bug reports, user and administrator comments, and code changes.
Related links and sources
https://www.divio.com/blog/documentation/
Created by Dirk Gomez, last modified by Gustaf Neumann 25 Sep 2019, at 10:05 PM
This page is mostly obsolete. Please refer to the newer guides for Ubuntu and Debian or the generic generic installer script.
Goal
Get all required software to run OpenACS into the next release of Ubuntu Server and Debian
Dates
- Debian: Dates are not published. Release cycle ~2 years. The required packages mostly exist already in unstable
- Ubuntu: Next Debian Import Freeze for the Hardy Heron (Ubuntu 8.04) release is December 13th 2007 at which point new versions of packages will be automatically imported from Debian unstable. After this date, packages will only be imported from Debian in this way by explicit request from a developer.
Prior Work
As far as we know to this point, there are several bodies of work, including Dirk Gomez's, Jim Lynch's, and some others. While our goal is to combine, for now I'll just put a list and as we begin to work together, we'll combine how we decide to.
- work of Jim Lynch
- A pair of scripts and some other stuff available as an arch repository (see applicable documentation on gnu arch and below for specifics on this project). Essentially, the plan is to package by taking everything in an openacs tarball except the packages/ dir, put that into a package called openacs-base, put each openacs package into its own package whose name is specified in the .info file and make a metapackage called openacs-core which installs all of the above.
- Overall, I want to be able to:
- feed an openacs tarball to one of these scripts and have it then generate a pile of debian packages which represent the entire tarball, and
- be able to package any openacs package that wouldn't otherwise come in (say) an openacs core tarball.
- Upon installation, there will be a script which builds a service by copying all of core into a dir specified in part by the user and in part based on the service name. In this process, the config file and startup scripts are established as well as the daemontools "run" script. A database for the service is created, and the service is started. From there, the new site admin will visit the site with the browser, fill out the form and hit "install data model" as is normal, and you end up with a running service after aolserver is hammered.
- All non-core packages can be built into debian packages as well, identically to the packaging of core packages.
- To get: (HI! Can someone besides me (jiml at cvs.openacs) see if this works?)
the archive's physical location is
http://jam.sessionsnet.org:7000/~jim/{archives}/jim@jsn.org--2004-pub
the archive name (valid once you register the archive) is
jim@jsn.org--2004-pub
and the category, branch and version is specified as
openacs-deb-packager--mainline--0.1
so you would feed the physical location to "tla register-archive", and then you can "tla get jim@jsn.org--2004-pub/openacs-deb-packager--mainline--0.1".
- combination (eventual goal hopefully)
List of Packages
The following table list the packages, and version, needed to install OpenACS 5.3/5.4 or .LRN 2.3/2.4
| Package |
Version in debian/etch |
Version in debian/sid (unstable) |
Recommended Version |
| aolserver4 |
4.0.10-7 |
4.5.0-14 |
-- |
| aolserver4-nspostgres |
4.0-3 |
4.0-4+b1 |
-- |
| aolserver4-nssha1 |
0.1-1 |
0.1-1.0.1 |
-- |
| aolserver4-nsxml |
1.5-1 |
1.5-1.0.1 |
NONE don't use nsxml |
| aolserver4-nsopenssl |
3.0beta22-3 |
3.0beta22-3+b1 |
-- |
| aolserver4-nscache |
1.5-1 |
1.5-1.0.1 |
-- |
| aolserver4-dev |
4.0.10-7 |
4.5.0-14 |
-- |
| tdom |
0.7.8-5 |
N.A. |
0.8.2 ?? |
| htmldoc |
1.8.27-2 |
1.8.27-2+b1 |
-- |
| tcllib |
1.8-1 |
1.10-dfsg-2 |
1.10 |
| daemontools-installer |
0.76-9.2 |
0.76-9.2 [contrib] |
-- |
| postgresql-8.1 |
8.1.9 |
postgresql-8.1 (8.1.10-1) AND postgresql (8.2.5-4) |
I think Ubuntu has 8.2 now |
| postgresql-client-8.1 |
8.1.9 |
postgresql-client-8.1 (8.1.10-1) AND postgresql-client (8.2.5-4) |
-- |
| postgresql-contrib-8.1 |
8.1.9 |
postgresql-contrib-8.1 (8.1.10-1) AND postgresql-contrib (8.2.5-4) |
-- |
| xotcl |
1.6.0 |
1.6.1 |
1.6.1 |
| tclthread |
20030827-2 |
2.6.5 |
2.6.5 |
Verifying installability on Debian 4rc3 sid/unstable
Basic installation steps for oacs-5-4 based on Debian 4rc3 unstable/sid:
- Existing binary dependencies in Debian 4rc3 unstable/sid repository (Feb 26, 2008)
~$ aptitude install tcllib postgresql-8.2 aolserver4 aolserver4-nscache aolserver4-nssha1 aolserver4-nspostgres tclthread tcllib
- Missing binary dependencies in Debian 4rc3 unstable/sid repository (Feb 26, 2008: tdom 0.8.x, xotcl):
a) tdom
# build dependencies: tdom
aptitude install tcl-dev aolserver4-dev
# fetch tdom 0.8.3
cd /tmp
cvs -z3 -d:pserver:anonymous@cvs.tdom.org:/usr/local/pubcvs co tdom
cd tdom/unix
# build tdom 0.8.3
../configure --enable-threads --disable-tdomalloc --prefix=/usr/lib/aolserver4 --exec-prefix=/usr/lib/aolserver4 --with-aolserver=/usr/include/aolserver4 --with-tcl=/usr/lib
make install
b) xotcl (based on forthcoming Debian distribution)
# fetch temporary i386 builds from http://media.wu-wien.ac.at/download/debian
wget http://media.wu-wien.ac.at/download/debian/xotcl_1.6.0-1_i386.deb
wget http://media.wu-wien.ac.at/download/debian/aolserver4-xotcl_1.6.0-1_i386.deb
# package install
dpkg -i xotcl_1.6.0-1_i386.deb
dpkg -i aolserver4-xotcl_1.6.0-1_i386.deb
- OpenACS as such ...
useradd oacs-5-4 mkdir /home/oacs-5-4 chown -R oacs-5-4.www-data /home/oacs-5-4 usermod -g web oacs-5-4 usermod -d /home/oacs-5-4 oacs-5-4
cd /home/oacs-5-4 cvs -d :pserver:anonymous@cvs.openacs.org:/cvsroot co -r oacs-5-4 openacs-4 mv openacs4/* . su - postgres createuser -U postgres -s oacs-5-4 exit su - oacs-5-4 createdb -E UNICODE -U oacs-5-4 oacs-5-4
4. Set PostgreSQL backward compatibility flags (in postgresql.conf)
5. Whatever remains to be done (aolserver instance, edit config.tcl, ...)
Findings/ Issues related to dependency ensemble
Resurrecting tDOM Debian Package
Access to Debian source package (via svn/svn-buildpackage)
- SVN Browser at Debian Tcl/Tk Repository
- Steps to get your local working copy and build it using svn-buildpackage:
# 1. svn checkout to <current_dir>/tdom svn co svn://svn.debian.org/svn/pkg-tcltk/tdom/ # 2. create a dir for the original tarballs mkdir tarballs (<current_dir>/tarballs) cd tarballs # grab the orig tarball from the link:
wget openacs.org/xowiki/file/tdom_0%2e8%2e3%2eorig%2etar%2egz?m=download
mv tdom_0.8.3.orig.tar.gz?m=download tdom_0.8.3.orig.tar.gz
# 3. make sure you have svn-buildpackage and pbuilder installed and set-up # 4. build binaries from source package on trunk cd ../tdom/trunk
# When building the package, you have to use --svn-ignore when you have local changes that haven't been committed; otherwise you will get an error.
svn-buildpackage --svn-builder="pdebuild --buildresult `pwd`/../build-area" --svn-override=origDir=../../tarballs --svn-ignore
# voilà
# When you're ready to see lintian warning/errors, add --svn-lintian to the build package command:
svn-buildpackage --svn-builder="pdebuild --buildresult `pwd`/../build-area" --svn-override=origDir=../../tarballs --svn-ignore --svn-lintian
# For linda warnings/erros, add --svn-linda to the build package command
svn-buildpackage --svn-builder="pdebuild --buildresult `pwd`/../build-area" --svn-override=origDir=../../tarballs --svn-ignore --svn-linda
- References on svn-buildpackage
http://workaround.org/moin/SvnBuildpackage
http://debianpaket.de/svn-buildpackage
- Auxiliary stuff
The orig file
Issues of legacy source package
- [Fixed] [carl] lintian warnings: "tdom: changelog should mention nmu"
Problem:
W: tdom source: changelog-should-mention-nmu
W: tdom source: source-nmu-has-incorrect-version-number 0.8.3-1
Fix:
The maintainer should be Avni Khatri and Carl Blesius <tdom@blesius.org>. Modify debian/changelog to reflect this. This has been fixed temporarily, but since a few us of will be committing, we will have to review the uploader/maintainer names later.
- [Fixed] [avni] lintian warnings: "tdom: bad distribution in changes file"
Problem:
E: tdom_0.8.3-1_source.changes: bad-distribution-in-changes-file UNRELEASED
Fix:
modify debian/changelog: change UNRELEASED to unstable on line 1
- [Fixed (local issue)][avni] lintian warnings: "tdom: directory pwd/../build-area does not exist"
Problem:
W: Build-result Directory pwd/../build-area does not exist
Fix: To avoid using the --buildresult flag, you might put the following
line into your ~/.pbuilderrc:
BUILDRESULT=.../build-area
(make sure you replace the "..." by your directory walk to the actual
build-area dir)
- [Fixed by geoxito] [avni] lintian warnings: "tdom: package-contains-empty-directory *"
Problem:
W: tdom: package-contains-empty-directory usr/bin/
W: tdom: package-contains-empty-directory usr/sbin/
Fix:
the answer/ solution is simple. you have, simplisticly speaking, two ways of creating the "virtual" directory structures. By virtual, I refer to the the paths created under debian/tdom which then go into the binary (*.deb) packages. Either do it manually in the debian/rules file or use template files under debian. look at debian/dirs ... it contains two entries: usr/bin, usr/sbin ... voilà ... these are default settings, created the first time the original author debianized the package. but tdom is a so-called "internal library" package in debian jargon, there will never be anything in bin or sbin. so, simply remove the file or empty it!!!!
- [Fixed]
Which version to package: 0.8.2 / 0.8.3? it is going to be CVS Head/ 0.8.3
- [Fixed] [geoxito] Installation paths not compliant with Debian Tcl/Tk policy
Study http://pkg-tcltk.alioth.debian.org/tcltk-policy.html/
and make sure that you change debian/rules etc. accordingly.
Most importantly, tcl package reside under /usr/lib/tcltk and not /usr/lib/ directly.
- [Fixed] [mr_calvin] Dedicated tdom-dev binary package. There needs to be a dedicated development binary package.
Fix:
- Add tdom-dev entry in debian/control
- debian/rules needs to copy following files into tdom-dev paths:
/usr/include/tdom.h
/usr/lib/tdomConfig.sh
/usr/lib/tdom0.8.2/libtdomstub0.8.2.a
- Btw. change the include path to /usr/include/tdom/*
and subsequently change the path settings in tdomConfig.sh through search/replace operations in debian/rules
(see my xotcl examples in http://svn.debian.org/viewsvn/pkg-tcltk/xotcl/trunk/debian/rules?rev=544&view=markup). watch out for perl commands in there ...
- [Fixed] [avni] Further lintian clean-up:
Problem:
> W: tdom: manpage-has-errors-from-man usr/share/man/man3/dom.3.gz invalid option -wmac
> W: tdom: manpage-has-errors-from-man usr/share/man/man3/domDoc.3.gz invalid option -wmac
> W: tdom: manpage-has-errors-from-man usr/share/man/man3/domNode.3.gz invalid option -wmac
> W: tdom: manpage-has-errors-from-man usr/share/man/man3/expat.3.gz invalid option -wmac
> W: tdom: manpage-has-errors-from-man usr/share/man/man3/expatapi.3.gz invalid option -wmac
> W: tdom: manpage-has-errors-from-man usr/share/man/man3/tdomcmd.3.gz invalid option -wmac
> W: tdom: manpage-has-errors-from-man usr/share/man/man3/tnc.3.gz invalid option -wmac
Fix: seems to be fixed now.
- [Fixed] [mr_calvin] Expat integration: Using internal (expat 2.0.1 or 1.95) or external (1.95) libexpat (as provided by Debian); comment by Debian Tcl/Tk maintainers:
"As far as I understand, the current version uses internal expat. I
think it's unacceptable. We should use libexpat from Debian. An
example of patches which allow to use system-wide expat could be found
at svn://bamboo.nes.ru/debian/tcl/tdom/trunk"
- [Fixed] [geoxito] Create tdom-doc package if possible. Fix: Not really needed, because there is no other tdom documentation apart the manpages.
Installing packages
These are instructions for installing the alpha dotlrn and openacs packages on debian (and ubuntu).
- Build and install tdom packages (see above, on "Resurrecting tdom").
- Set up a postgresql 8.2 server, and allow access for postgresql administrator user and openacs/dotlrn user from the machine where you are installing dotlrn/openacs (no need to create the dotlrn/openacs user and database).
- Modify your /etc/apt/sources.list file:
# debian sid deb http://debian.adenu.ia.uned.es/apt sid main # Ubuntu Hardy deb http://debian.adenu.ia.uned.es/apt hardy main
- Update the package list and install:
# apt-get update - dotLRN # apt-get install dotlrn
- OpenACS # apt-get install openacs
After that, just follow the instructions on the install ant have fun!
Created by Gustaf Neumann, last modified by Gustaf Neumann 25 Sep 2019, at 11:53 AM
NaviServer is a fork of AOLserver. While the goal of the AOLserver community is stability (no code changes unless necessary), NaviServer is targeted toward further development and extensions (implementing new features required by state of the art web server environments, see NEWS).
Availability
Using NaviServer with OpenACS
Created by Gustaf Neumann, last modified by Gustaf Neumann 25 Sep 2019, at 11:40 AM
Libthread is the standard Tcl thread library developed by Zoran Vasiljevic and provides optional functionality for OpenACS. Threads created by the Tcl thread library are executed in an event loop, which makes it easy to send commands to such threads. xotcl-core provides support for the the thread library and uses it for example for background delivery of large files. Also the chat package uses libthread when it is installed. The xotcl-request-monitor depends on libthread.
The advantage of libthead over NaviServer/AOLserver threads is that the threads created by libthread are waiting in an event loop for incoming requests, which eases some types of applications.
INSTALLATION:
In case, NaviServer was installed via install-ns, one can skip the section installation steps. Also the provided configuration script is already set up correctly for usage. The instruction below is for cases, where install-ns was not used.
1. Get and install libthread:
download libthread e.g. from
https://downloads.sourceforge.net/sourceforge/tcl/thread2.8.2.tar.gz
untar it and go to you platform specific directory (eg. thread2.8.2/unix)
# cd unix
# ../configure --enable-threads \
--prefix=/usr/local/ns \
--exec-prefix=/usr/local/ns \
--with-naviserver=/usr/local/ns
use --prefix --exec-prefix --with-naviserver with the path pointing to the directory, where NaviServer is installed.
The setup for AOLserver is similar, but different paths are used.
make
make install
You should now have installed libthread2.8.2.so (check for /usr/local/ns/lib/thread*/libthread* )
2) Adjusting the AOLserver/NaviServer configuration file to use libthread
Open the configuration file
restart nsd and check the error log, whether libthread was loaded successfully.
Created by OpenACS community, last modified by Gustaf Neumann 25 Sep 2019, at 11:16 AM
the free, open-source, multi-threaded, scalable, Tcl-enabled, web/application server used by some of the world's busiest websites, such as AOL.com, Mapquest.com, Netscape.com, and Moviefone.com. Other sites that run on AOLserver: http://panoptic.com/wiki/aolserver/Sites_That_Run_On_AOLserver
What others say about AOLserver
Using AOLserver with OpenACS
Notes on upgrading AOLserver 4.5.1 ( or greater )
- All the ns_cache* API is from AOLserver 4.5.1 on, part of the core, therefore loading nscache.so in your config file is not longer required. Doing otherwise could lead to syntax errors while doing some calls to the API.
