1. Unpack the downloaded archive

2. Copy the files in the bin folder to the binfolder of your geminiinstallation or leave it as a subfolder of in the folder you create in step 3.

3. Copy the files in the gemama-folder to a folder of your own choice.

4. Create a Catch-All Email Account
This account will be the one that Gemama will 'pop' - and every mail that fullfils the rules below will result in a new isuue.
a.The Email-adress of the sender must belong to a user created in Gemini.
b.The name of the receipient should be a Project Code in Gemini.
Example : an email sent to acmeproject@examplesite.com will result in a new issue in a project with the projectcode acmeproject.
Note : A Catch-all for email, refers to a mailbox on a domain that will "catch all" of the emails addressed to the domain that do not exist in the mail server.

5. Create a Response Email Account
This account will be the one used for 'reply-to / From' in the generated emails.

6. Create a Gemini Service account
This account will be used for communicating with Gemini - the account should be a systemaccount. You'll use thie credentials for this account when configuring Gemama.

7. Create a scheduled task
This task should fetch the page named "Default.aspx" from the downloaded archive. You could for instance use 'Scheduled task' for this - and fetch the page every minute.
If you want to send out summaries you should create an additional task fetching "Default.aspx?reminder=true" - this could be called once a day.

8. The final step is to configure Gemama. This is done by editing the web.config file in the archive - Please make sure NOT to overwrite the existing web.config in the root folder - this web.config should reside the the folder where gemama is placed. if You call "Default.aspx?help=1" you will get of list of IDs you can use to get the relevant ID's for the list below.
´
NewIssuesServer
The name of the pop3-server that is used for incomming mails for new issues.

NewIssuesUser
The name of the account that is used for incomming mails for new issues.

NewIssuesPassword
The password of the account that is used for incomming mails for new issues.

NewIssueRisklevel
The ID for the risklevel for incomming mailissues.

NewIssueIssueType
The ID for the issuetype of incomming mailissues.

NewIssueIssueStatus
The ID for the statur of incomming mailissues.

NewIssueIssuePriority
The ID for the issuePriority of incomming mailissues.

NewIssueIssueSeverity
The ID for the issueseverity of incomming mailissues.

GeminiServerURL
The url of your Gemini-installation.

GeminiUser
The name of the serviceaccount that gemama should use when communicating with Gemini,

GeminiPassword
The password of the serviceaccount that gemama should use when communicating with Gemini,

GeminiAPIkey
The API-keyof the serviceaccount that gemama should use when communicating with Gemini,

GeminiWindowsAuthenticationMode
Set this to true if your installation is authenticated through windows - otherwise false.

CommentsServer
The name of the pop3-server that is used for incomming mails for comments.

CommentsUser
The name of the account that is used for incomming mails for comments.

CommentsPassword
The password of the account that is used for incomming mails for comments.

SummaryFromEmail
The mailadress that should be used for "from" when sending the summarymails.

SummaryReplytoEmail
The mailadress that should be used for "reply-to" when sending the summarymails.

SummaryTestEmail
When filled out - will receive all summarymails - use this for testing summarymails.

Aliases
When filled out - can be used to have mutiple emailadresses pointing to the same project, syntax = "alias!projectcode" - seperate aliases with an "/". example = "alias1!projectcodeA/alias2!projectcodeA/alias3!projectcodeB"

DefaultReportingUser
if an issue is created by an unknown user/email this email will be used instead. Remember to create a geminiuser with the same email.

CommentNote
this text is used for creating a comment for every issue created by email, example = "Created by email by %email / %name"

Last edited Oct 6, 2011 at 4:03 AM by modist, version 7

Comments

No comments yet.