Calendar Package Installation

part of the ArsDigita Community System by W. Scott Meeks
This file documents the process of installing the calendar package on a new server.

Because packages are very new to ACS, not all the features of the package manager may be working correctly in the version you're installing the package onto. This file attempts to document some of the potential deficencies and to give alternate paths in installing a package.

You will need to be a site-wide administrator and have database access on your server.

Create the Package

The first step is to create the package on the server. Ideally this should be done by uploading a .apm file, but that can be tricky, and a .apm file may not be available so this document will also outline how to create a package from scratch.

Option 1: Upload .apm

Steps:

TBD

Option 2: Create package from scratch

Steps:

  1. Install the packages/calendar sub-directory. Unlike ACS modules which live under the www directory on your server, packages live in a seperate packages directory. The packages directory for your server should be something like /webroot/web//packages. There are three main ways to get the files:
    • Manually unpack .apm file
      If you've downloaded calendar-1.0.apm, you can unpack this file by executing the following commands in your packages directory:
      mv calendar-1.0.apm calendar-1.0.tar.gz
      gunzip calendar-1.0.tar.gz
      tar xf calendar-1.0.tar
      

    • Checkout files from aD public CVS server
      The calendar package has been made available from the ArsDigita public CVS server. If you have CVS installed on your machine, you can execute the following commands in your packages directory:
      export CVSROOT=:pserver:anonymous@cvs.arsdigita.com:/usr/local/cvsroot
      cvs login
      password: acsrules
      cvs checkout -d calendar contrib/packages/calendar
      
    • Copy files from another location
      You will need to have access to the packages/calendar directory of some other server running the calendar package, e.g. /webroot/web/a-server/packages/calendar. Recursively copy this directory (e.g. 'cp -r' or 'scp -r') into the packages directory of your local server.

  • In your browser, navigate to /admin/apm/ on your server.
  • Select "Scan for new or modified packages".
  • You should be taken to a page titled Scan Packages. On that page you should see the line "Registered Calendar, version 1.0." (or whatever the version is for the package you're installing.)
  • Click on "Return to the Package Manager".
  • Click on "calendar".
  • If something went wrong with this process, you may have to create the package yourself by following these steps. Otherwise, skip to step 8 below.