Forum OpenACS Q&A: All about the Intranet (post-install HOWTO)
Congratulations, you've just installed ACS. You've managed to get through the install guide (or the OpenACS install guide), you've gotten Oracle or Postgres working, you're now a pretty cool person because you got it working.
Well, if you're using the Intranet module, you're going to need some more setup, and currently, I don't know of any good documentation on the module except for what is at Arsdigita. Read that first.
The Intranet is a pretty complicated module because it relies conceptually on so many other modules. Unless you already understand the ACS, it may take a while to get a handle on it.
First of all, if you're using Postgres 7.02, I recommend applying a patch that fixes the PortalHeapMemoryError. The link is at the top of this posting. Preferably, you would install this before installing OpenACS, because otherwise you have to export and import your data to get this working. But the directions are pretty good, so just follow them carefully. I'm not sure if this works completely though -- I started from a fresh copy.
Steps to getting your intranet running
- Set up your admin account and so on like the directions say
- Go through your /web/servicename/parameters/servicename.tcl or
.ini file and set the preferences for Intranet and New-ticket
modules. Make sure you enable the Intranet module.
- In your web browser, go to /admin/users and add in the users you
want. I assume these are Employees -- they won't be able to use the
Intranet unless you then go to /admin/ug and click on Intranet. Add
them to both the Authorized Users and Employees category.
- While you're in the Internet - Employees /admin/ug section, click
on "add module" under "Modules associated with groups in Employees".
Set up the news module. They will then be
able to make company-wide postings for the main page, and be able to
see other postings. Otherwise, they will get an error when they click
on the post an item link on the main intranet page.
- Go to the /intranet page. Click on "Offices", and set up an
- Set up your partner types. This is a pain, unless I'm overlooking
an easier way to do it. You have to open up a shell, start up
postgres, and change the categories in the database. Then, you have to
restart Aolserver, because I believe the variables are cached in
[postgres@intranet pgsql]$ psql intranet (or your servicename) Welcome to psql, the PostgreSQL interactive terminal. Type: copyright for distribution terms h for help with SQL commands ? for help on internal slash commands g or terminate with semicolon to execute query q to quit intranet=# select * from im_partner_types ; partner_type_id | partner_type | display_order -----------------+--------------------+--------------- 1 | Usability | 1 2 | Graphics | 2 3 | Strategy | 3 4 | Supplier | 4 5 | Sys-admin | 5 6 | Hosting | 6 7 | Systems Integrator | 7 (7 rows) intranet=# h update Command: UPDATE Description: Replaces values of columns in a table Syntax: UPDATE table SET col = expression [, ...] [ FROM fromlist ] [ WHERE condition ] intranet=# update im_partner_types set partner_type = 'Service Provider' intranet-# where partner_type = 'Usability'; UPDATE 1 intranet=# select * from im_partner_types ; partner_type_id | partner_type | display_order -----------------+--------------------+--------------- 2 | Graphics | 2 3 | Strategy | 3 4 | Supplier | 4 5 | Sys-admin | 5 6 | Hosting | 6 7 | Systems Integrator | 7 1 | Service Provider | 1 (7 rows)
- Don't forget to restart Aolserver
- If you don't have site-wide-search, you might want to disable the
site-wide-search box on the main /intranet page.
- Set up the calendar categories in /calendar/admin. Look at the documentation
that won't be relevant to this at all :) Think of categories like:
Social, Project Meeting, etc...
- Get pictures for everyone in your office and put them in. Or let
everyone do it themselves.
- Add in any Discussion Groups you might want.
- Add in teams for the new-ticket module. Go to /team to add in
teams. Make sure everyone who will be using the ticket system is part
of a team. If you don't do this, tickets won't work.
- Change the project types if the project types don't fit what you
need. I haven't done this yet, so no help here. Sorry!
- Beware of bugs: popuation count doesn't seem to work in the status reports, primary contact doesn't work for the customers/view.tcl page (you'll get an employee instead of a contact), you may get a nasty server error when you access the Employee Administration link from the main page, you can't seem to create tickets for the project view page (clicking on "create a ticket tracker" gives a server error) and other annoyances. These may be OpenACS 3.2.2 specific
One little question still bogus me: How on Earth is possible to edit someone's personal contact information?! There are a couple of TCL scripts which seem to address this problem, but they seem to be no longer used. I get redirected from one place to another, but I'm never able to do the job. The same thing is valid for ACS classic, too.
Probably I should sit down and write my own scripts, but I hate writing duplicate code
You cannot edit the information of someone else, unless you know their password or click the 'become this user' link in the user admin pages.