Frequently asked questions¶
Authors: | Michael JasonSmith; |
---|---|
Contact: | Michael JasonSmith <mpj17@onlinegroups.net> |
Date: | 2016-04-05 |
Organization: | GroupServer.org |
Copyright: | This document is licensed under a Creative Commons Attribution-Share Alike 4.0 International License by OnlineGroups.net. |
If you have a question that is missing from the list below feel free to ask in the GroupServer Development group.
How do I...¶
... add another site administrator?
Multiple people can administer a site. A person must already have a profile to be an administrator. (The easiest way to create one is to create a support group and add the new site administrator to that.)
- Log into the ZMI.
- Visit the folder for your site in
/groupserver/Content
.- Select the Security tab.
- Click local roles at the top of the page.
- Enter the user-identifier (it is the last segment of the profile URL, between the
/
characters) into the User entry.- Select DivisionAdmin from the Roles list.
- Click the Add button.
Note
The site administrator can change any group, but only group administrators will receive notifications about each group. A site administrator can be made a group administrator using the Manage members page.
[From OnlineGroups.net Support]
... create a new site?
GroupServer can handle more than one site. Each site will have its own set of groups, while the profiles will be shared between the sites. Sadly, the process is very manual, and prone to problems.
- Copy the folder for the initial site.
- Visit the
/groupserver/Content
folder in the ZMI.- Select the folder.
- Click the Copy button.
- Click the Paste button to paste it into the
/groupserver/Content
folder.- Select the new folder.
- Click the Rename button.
- Give the folder a new unique name. The new name must be unique among the sites, and all the groups.
- Click the Ok button.
- Create a new user group for the site.
- Visit
/groupserver/acl_users
- Select the User Groups tab.
- Click the Add... button.
- Set the Name of the new user group to
{site-name}_member
, where{site-name}
is the name of your site.- Click the Add button.
- Update the site configuration.
- Update the site title.
- Visit the folder for your new site.
- Select the Properties tab.
- Edit the title.
- Click the Ok button.
- Update the URL
- Visit the
DivisionConfiguration
in the folder for your new site.- Set the following at a minimum.
- Update
canonicalHost
to be the hostname of your site.- Ensure that
canonicalPort
is correct. If this site is going to be an HTTP sitecanonicalPort
should be80
; for HTTPS it should be443
- Add a new property named
emailDomain
. This is the domain used after the@
in the email addresses for the groups on the site. It may be the same ascanonicalHost
or different.- Click the Save Changes button.
- Delete the groups.
- Visit the
groups
folder in your new site.- Select all the groups.
- Click the Delete button.
- Set the permissions.
- Visit the folder for your new site.
- Select the Security tab.
- If there is no
DivisionAdmin
role listed enterDivisionAdmin
into the User defined roles entry and click Add Role- If there is no
DivisionMember
role listed enterDivisionMember
into the User defined roles entry and click Add Role- Click local roles at the top of the page.
- Set yourself as a site administrator.
- Set the user-group.
- Select the name of the user-group for the site from the Group list.
- Select
DivisionMember
from the Roles list.- Click the Add button.
- Add the proxy configuration for your new site.
- Add the Postfix configuration for your new site.
<http://groupserver.org/r/topic/44uT6Wt3mkmod7cyqugqp2> <http://groupserver.org/r/topic/1S6podvwyVodJydNUfh4DY>
- ... change the email address for a group?
The email address for a group is normally the group-identifier followed by the domain name for the site. However, it can be changed:
- Open the list object in the
/groupserver/ListManager
folder. - Edit the
mailto
property to the new value. - Click the Save changes button.
- Open the list object in the
- ... change the footer?
To change the footer edit a file called
footerlinks.xml
in the ZMI.Log into the ZMI.
Visit the file
/groupserver/Templates/output/footerlinks.xml
.Change the contents of the page template to the footer you desire. Something like the following:
<ul class="inline-list pull-right"> <li>Like</li> <li>This</li> </ul>
Click the Save Changes button.
- ... change the host name?
The host-name is normally set during installation. However, it can be changed afterwards.
- Visit the
/groupserver/
folder in the ZMI. - Open the
GlobalConfiguration
object. - Edit the
canonicalHost
property to the new value. - Click the Save changes button.
- Visit the
/groupserver/ListManager
folder. - Change the email address for every group in the folder
- Visit the
... change the Reply-to behaviour for a group?
The default Reply-to is set depending according to the type of group.
Group type Reply-to Discussion Group Announcement Sender Support Sender To change the default Reply-to
- Visit the Group page.
- Select Change the general properties in the This group section of the Admin area.
- Select the new setting from Email replies go to…
- Click the Change button.
[From OnlineGroups.net Support]
- ... change the support email?
The email address for support is first set during the GroupServer installation. To change it
- Visit the
/groupserver/
folder in the ZMI, - Open the
GlobalConfiguration
object, and - Edit the
supportEmail
property. - Click the Save changes button.
- Visit the
- ... create a page?
Some pages in GroupServer (such as
/about
) are editable.- Visit the folder that should contain the page in the ZMI.
- Add a new folder.
- Visit the new folder.
- Select the Interfaces tab.
- Select
Products.GSContentManager.interfaces.IGSContentManagerFolderMarker
in the Available Marker Interfaces list. - Click the Add button.
- ... delete a post?
Once a post has been made then the group members will receive an email message containing that post, and there is no way to recall the message. However, a post can be hidden in the archive: click the Hide button next to the post. The post will be replaced with a message saying why it was deleted.
To actually delete a post:
- Any associated files must be removed from the
file
table, - The
first_post_id
,last_post_id
andnum_posts
must be updated in thetopic
table, and - The post itself must be removed from the
post
table.
After deleting a post anyone following a link to the post on the archive (from the earlier message) will see a
404 (Not found)
error rather than the nicer410 (Gone)
error.- Any associated files must be removed from the
- ... disable email address obfuscation?
You cannot disable this feature. If a person posts from a domain controlled by DMARC (RFC 7489) then GroupServer rewrites the From header so others will receive the message. (If this was skipped then the message will fail the DMARC check and the group members would never see the message.) This conforms to the draft DMARC interoperability specification.
... disable HTML email
HTML formatted email messages from a group can be disabled for an entire site.
- Log into the ZMI.
- Visit the
DivisionConfiguration
for your site (by default/groupserver/Content/initial_site/
).- Add the
htmlEmail
property.
- Add
htmlEmail
to the Name entry.- Select
boolean
as the Type.- Leave the Value as blank (
False
).- Click the Add button.
To enable HTML formatted email messages either delete the
htmlEmail
property, or set it toTrue
.[From OnlineGroups.net Support]
- ... import posts from another system?
To import posts from another system first export the posts as an
mbox
file, then use the mbox2gs script to import the posts into GroupServer (documentation).
- ... make all the members of a group moderated?
Ideally you would change the moderation of a group to Moderate specified members, and all new members that join this group before the new members are added. However, if this was skipped, and a large number of people has been added, then it is possible to set the list of moderated members.
- Visit the
/groupserver/
folder in the ZMI. - Open the
acl_users
object. - Select the User groups tab.
- Open the user-group.
- Copy the list of user-identifiers from the Users list into a text editor.
- Remove the identifiers for each the administrator and moderator.
- Visit the
/groupserver/ListManager
folder in the ZMI. - Open the mailing list object for the group.
- Copy the list of members to be moderated from the text
editor into the
moderated_members
list. - Click the Save changes button.
- Visit the
- ... remove a user?
When a person leaves their last group on a site they are no longer a site member, but they will still have a user-object. These objects can be deleted, but it is discouraged.
- Visit the
/groupserver/
folder in the ZMI, - Open the
acl_users
object, - Select the user-object to delete, and
- Click the
Delete
button.
- Visit the
- ... scan for viruses?
Install pyClamd.
- ... set multiple people to receive the support email?
The easiest way for multiple people to receive messages to the Support email address is to create a new Support group.
- Start a secret group.
- Change the group type to Support.
- Add the people who need to receive the messages to support to the group.
- Change the support email address to the email address of the new group.
- ... turn off a feature?
Normally the easiest way to turn off a feature is to hide it in the CSS.
- Get used to changing the skin.
- Make your own skin, based off the Blue or Green skin (see Development guide).
- Hide the interface element in question by setting it to
display: none
.
- Hide post: <http://groupserver.org/r/post/3e6qousrx7qyvpsK0HsZUt>
- Password toggle: <http://groupserver.org/r/post/7ezGHt8QtK9zdl82uSxrgo>
Why do I see...¶
... a CRC check failed
error during install?
If a file partly downloads and the network connection times out then you may see a CRC-check error after you restart the install. For example:
Getting distribution for 'sqlalchemy==0.9.10'. error: CRC check failed 0xcea84515 != 0x22d9d947LDelete the associated file in
downloads/dist
and restart the build.
... an error setting up the database?
Towards the end of the GroupServer installation process the system will try and create some tables. If the permissions for PostgreSQL are set to
IDENT
based authentication you will see the following error:psql: FATAL: Ident authentication failed for user “gsadmin”Change the PostgreSQL authentication to
md5
.
Open the file
pg_hba.conf
. (It is normally found within/etc/postgresql
, but the specific location depends on your version of PostgreSQL and distribution.)Change
ident
tomd5
in the lines that read:host all all 127.0.0.1/32 ident host all all ::1/128 identThey should end up like the following:
host all all 127.0.0.1/32 md5 host all all ::1/128 md5Restart PostgreSQL.
- ... an error with distribute?
Sometimes there is an issue with installing the
distribute
package:Error: There is a version conflictWe already have : distribute 0.6.24The solution is
Go to your GroupServer folder,
Get pip to install the correct version of distribute:
$ ./bin/pip install "distribute == 0.6.49"
Carry on installing GroupServer:
$ ./gs_install_ubuntu.sh
- ... “couldn’t install: lxml”?
To compile
lxml
the system needs at least 1024M of RAM.
- ... email messages with the wrong CSS?
The web-hook that adds a message may use different URL to the one used for normal web traffic (see Change the skin). If this is the case GroupServer may have to be explicitly told the skin to use.
- Visit the
/groupserver/
folder in the ZMI, - Open the
GlobalConfiguration
object, - Set the
emailSkin
property to the same value that is used in the proxy configuration.
- Visit the
- ... “Error with the configuration file” when sending the digest?
Specify the full path to the
gsconfig.ini
on the command line to senddigest. (See also Daily digest of topics.)
- ... no email when I make a post?
If you are testing, ensure that your group members are on One email per post.
- ... Request Entity Too Large?
Email messages are added to GroupServer, by postifx, using a web-hook. Because of this the proxy can block a message if it is too large. Adjust the
client_max_body_size
parameter in nginx or similar variable in your proxy of choice.
- ... so many errors when installing?
GroupServer can only run as a normal user, never as the
root
superuser. Change the ownership of the GroupServer directory and all of its contents to a normal user.