CounterSoft

General

• What is the default administrator username and password?
  
  

  If you have installed the Gemini database using the EXE database installer then the default admin user is manager and the password is manager.

  For database created using the SQL scripts the username is admin and the password is admin.
  
• "General Network Error" Received
  
  If you encounter a "General Network Error" enable "Integrated Windows Security" under IIS --> Directory Security.
  
• Why are my projects missing * Unscheduled * under Versions and * Unassigned * under Resources on the Project homepage?
  
  This means you do not have open issues that are unscheduled or unassigned.
  
• How do I view issues of each resource for ALL projects in ONE schedule?
  
  You can see the issues (tasks) for a resource by doing an all project filter on that resource and view the Gantt.
  
• How do I change the default RAD editor font?
  
  

  Open the RichText.ascx file (under the controls directory). Add the following between the RAD editor declaration:

  <telerik:RadEditor runat="server" ID="RadEditor1"
      Skin="Default2006"
      ToolsFile="~/controls/RAD/EditorTools.xml"
      EditModes="Design, Preview">
      <CssFiles>
        <telerik:EditorCssFile Value="~/EditorContentArea.css" />
      </CssFiles>
      <TemplateManager
       ViewPaths="~/controls/RAD/UserTemplates"
       UploadPaths="~/controls/RAD/UserTemplates"
       DeletePaths="~/controls/RAD/UserTemplates"
       />
      <ImageManager  EnableImageEditor="true"
       ViewPaths="~/controls/RAD/UserImages"
       UploadPaths="~/controls/RAD/UserImages"
       DeletePaths="~/controls/RAD/UserImages"
       >
       </ImageManager>
       <DocumentManager
       ViewPaths="~/controls/RAD/UserDocuments"
       UploadPaths="~/controls/RAD/UserDocuments"
       DeletePaths="~/controls/RAD/UserDocuments">
      </DocumentManager>
      <Content>
     
  </Content>
      <SpellCheckSettings SpellCheckProvider="PhoneticProvider" WordIgnoreOptions="None" />
  </telerik:RadEditor>

  Now create a file called EditorContentArea.css in the root of the Gemini web app and put the following in it:

  body
  {
      font-family: Arial, Verdana, Tahoma !important;
      font-size: 10pt !important;
  }

  
  
• How do I add default text to the RAD editor?
  
  

  You will need to amend the RichText.ascx page (under the controls folder) and add the text in the content tag:

      <Content>This content is set <b>directly</b> inline and includes HTML markup</Content>
  

  See: http://www.telerik.com/help/aspnet-ajax/gettingsettingcontent.html

   

  
  
• Can I link issues/sub-issues across Projects?
  
  Yes, issue links and sub issues can be associated from any project.
  
• How do I set the length of a custom field?
  
  Go to Administration > Projects > Custom Fields and click 'Edit' on the desired custom field and change the value of the 'Number of Columns' field.
  
• My Gemini is running slow. What can I do to improve performance?
  
  Make sure that Gemini runs in its own application pool and it is not recycled too often.  If SQL server is on the same server, make sure it does not take up all system memory.
  
  Additionally, check your database increment settings. A low increment will cause data and index fragmentation, try updating statistics
  
• Setting up SVN with Windows Authentication
  
  Please refer to the following Forum post in the Gemini Support Community by a Gemini user -
  
  http://community.countersoft.com/forums/thread/12118.aspx
  

Installing & Configuring

• How do I change the displayed Date Format?
  
  

  By default, Gemini is configured to show dates in the DD/MM/YYYY format.

  If you want US style date formats, edit the Gemini web.config file and update the Culture details from "en-GB" to "en-US".
  

   

  <globalization culture="en-GB" uiCulture="en-GB" requestEncoding="utf-8" responseEncoding="utf-8"/>

  
  
• How do I set default language settings of new users ?
  
  Default language (culture) settings for new users can be set from-

   

  Administration > General (Global Settings) > Default Culture Name

   

  Note: The Gemini login screen language is also based on this setting.

  
  
• How do existing Gemini users change their language settings ?
  
  Existing users can change their language settings from the "My Profile" page.
  
• How do I configure the source safe adaptor?
  
  

  First you will have to register the CounterSoft.Gemini.SourceControl.VSS.dll file. This is done by executing the following command (via Windows Start > Run menu): regsvr32 CounterSoft.Gemini.SourceControl.VSS.dll

  You should get a message confirming successful registration.

  Next you need to amend and register the registry file, GeminiVSS.reg. Right click on it and select edit, configure the URL to point to your installation and save the file. Double click on the file to register it.

  The final step is to create the ssaddin.ini in the Visual SourceSafe program files folder (usually: C:\Program Files\Microsoft Visual Studio\Common\VSS\win32). Open the file and insert the following line:

  GeminiVSS.SourceSafe.1=1

  Save the ini file and you should be up and running. When you check in / out a file simply type GEM:ABC in the comment (replace ABC with the issue number) and the file will be associated with the issue.
  
• When first accessing the site I am getting: "This version of RadControls for ASP.NET Ajax is licensed only for use by CounterSoft Gemini"
  
  Please make sure that you have set the application pool for Gemini to use Classic .NET
  
• Does Gemini run under ASP.NET Medium Trust?
  
  

  Yes.

  1. Uncomment the following line from web.config: "<!--add key="hibernate.use_reflection_optimizer" value="False" /-->".
  2. Ensure you are using Gemini Scheduler Service as email alerts engine -- "MailPlugin" not supported under medium trust level.
  3. Any custom plugins under "bin/plugins" will not be loaded under medium trust level.

  
  
• Windows 2008 / IIS 7
  
  For IIS 7 on Windows 2008/7, under certain circumstances, you may need to set the "Load User Profile" property of the IIS Application Pool to "true".  Equally, we have received reports that setting this setting to "false" has also helped!

   

   

  
  
  
• Could not load file or assembly 'System.Web.Abstractions'
  
  Re-install or Repair (Control Panel) on the .NET 3.5 SP1 Framework.
  

Administration

• My new custom field is not showning
  
  

  After creating the custom field, make sure the field is set to be visible in the field visibility scheme(s).

  Please note the visibility is applied per issue type for create, edit and view. So it is important to check the visibility scheme is used by the relevant issue type(s).
  
• New status is not available in the drop down list
  
  Make sure the newly created status has been added to the correct workflow and you have added transitions into this status from the other, existing, statuses.
  

User Security & Permissions

• How do I change my Gemini password ?
  
  From the "My Profile" page.
  
• How can I learn about setting up Gemini Permissions?
  
  Please refer to our Gemini Permissions Quick Guide.
  
  
• What is the difference between the Security Scheme and Field Visibility Scheme?
  
  Security Schemes are user and group centric. They determine what rights/permissions a user/group has for a Project/Issue/Gemini Administration e.g. View Project, Create Issue, Create Comment, Edit Issue. For more information please refer to the Gemini Management Guide.
  
  Field Visibility Schemes are Project Issue centric. They determine which Issue attributes e.g. status, priority, severity, resources, custom fields etc. are displayed. For more information please refer to the Gemini Management Guide.
  
• We have several external clients. We would like to setup Gemini so that each client can access (create, view, edit, etc.) only their own organization’s issues.
  
  Yes, this is possible in Gemini. You will need to create Gemini Security Schemes and follow the instructions in the Gemini Permissions Guide.
  
• While creating/viewing/editing an issue, can I control which fields are visible and to which group of users?
  
  You can select which fields are shown while creating, editing or viewing an issue by changing the Field Visibility Sheme(s).
  
  This can be done via the Administration > Field Visibility Scheme menu.. Please note that you have to assign the Field Visibility Scheme to the issue types by editing each issue type (via the admin section).
  
  
• Why can my users only view issues assigned to them?
  
  Ensure the permission "Only View Own Issues" is not assigned to the user / group. Administration > Schemes > (Select the applicable security scheme)
  
• How do I limit field visibility for Portal Mode users ?
  
  We are implementing Gemini 'Portal mode' for users to log their own issues/problems and want the Portal Mode users to have a simplified create issues layout. Is there a way to customize this layout?
  
• What determines which Issue attributes are displayed in the Issue Grid when I click on ‘All Project Issue Reporting’?
  
  The Field Visibility Scheme that is set at Administration > Security Settings > General > Field Visibility Scheme determines which Issue attributes are displayed. You can use either the built-in schemes or create a custom scheme. This view can be further customized by clicking on the ‘Customise’ link in the Issue Grid.
  
• What determines which Issue attributes are displayed in the Issue Grid when I click on ‘All Issues’?
  
  Administration > Projects > [Select Project] > Field Visibility Scheme.
  You can use either the built-in schemes or create a custom scheme. This view can be further customized by clicking on the ‘Customise’ link in the Issue Grid.
  
• How do I locate my Gemini API Key?
  
  You can find your Gemini API Key under the "My Profile" page.
  
• How do I enable CAPTCHA in Gemini?
  
  Gemini Home Page > Administration > Security Settings > General
  

Authentication

• How do I configure Gemini to use Windows authentication
  
  

  Follow the following steps:

  1. Create a Gemini admin user with the username of YOUR DOMAIN NAME\USER NAME
  2. Change the web.config file from Forms authentication to Windows:
     •   <authentication mode="Forms"> change to   <authentication mode="Windows">
  3. In IIS change the directory security to use integrated windows authentication only.
  4. For Windows Authentication, in IIS 'Allow Anonymous User' option should be unchecked/disabled.

  Note: For Gemini Scheduler and Gemini add-on products to work with Windows Authentication, please implement the changes recommended in this Microsoft KB Article and then disable anonymous access in IIS.
  That is it, after this add your users in the same way (DOMAIN\User) and they will be logged on automatically.
  
  
• How do I get my Gemini API Key? How often can I change it?
  
  Click on My Profile and then click on 'Generate' at the bottom of your My Profile page. You can change your API Key as many times as you like by clicking the 'Create' and then 'Update' buttons next to your API Key in your My Profile Page.
  
  
• How do I disable the ‘Click here to register’ link on the login screen?
  
  You can easily do this by going to Administration > General and set the Allow User Registrations (the very first setting on this page) option to 'No'.
  
• "Remember Me?" Does not work
  
  Please ensure the ASP.NET MachineKey is defined:

  
  

   http://www.codeproject.com/KB/aspnet/machineKey.aspx
  

  
  

SMTP & POP3

• Gemini does not send email alerts
  
  

  This may be because of the following reasons:

  • The SMTP configuration section was not set up correctly - Check the Gemini error log.
  • You use the scheduler service to send alerts but it is not installed.
  • You use the scheduler service but did not configure the scheduler config file with the correct URL or a valid Gemini username and password.
  • You use the scheduler service but Microsoft's WSE 3.0 is not installed on the web server.
  • Some users may have the alerts blocked by their spam filter / mail sweeper.

  
  
• I would like to receive alerts to issues I am assigned to only
  
  Un-tick all email alerts options in the "Email Alerts" section of the project home page. As Gemini admin set the "Email Issue Resource" setting to "Yes" in the Notifications section of the Administration menu.
  
• Using GMAIL or Yahoo! as SMTP Servers
  
  

  The following applies from Gemini release 2.2+.

  • All SMTP configuration is performed via Home -> Administration -> SMTP Configuration.
  • No SMTP configuration is performed via web.config -- if you see web.config SMTP stuff then you are either not using 2.2+ release or have a suspect web.config file!
  • Email Alerts can be sent either via the Gemini Mail Plugin (comes with Gemini) or via the Gemini Scheduler Service (preferred as it great reduces email traffic!).

  Basic configuration cycle:

  • Provide parameters in SMTP Configuration screen.
  • Click on Test button at the bottom of the SMTP Configuration screen.
  • Wait a couple of minutes (yes, some ISP's take time to deliver emails).
  • Test Email will be sent to the email address of person logged into Gemini.
  • View the Gemini System Log  found in Administration section (right hand side, last option) to see what errors if any were encountered.

  Google Mail as SMTP Server

  Use the following settings to use GMAIL as SMTP gateway:

  • SMTP Server: smtp.gmail.com
  • SMTP Server Port: 465
  • POP3 Before SMTP Send: No
  • SMTP Authentication Mode: Auto
  • SMTP Authentication Username: Your full gmail address (e.g. fred@googlemail.com)
  • SMTP Authentication Password: Your gmail password
  • SMTP SSL: Yes
  • SMTP SSL Protocol: Auto

  Click Test button to verify above settings.

  You have have to specify a Google Mail email address under Administration -> Notifications -> From Email Address.

  Yahoo! Mail as SMTP Server

  Use the following settings to use Yahoo! Mail as SMTP gateway:

  • SMTP Server: smtp.mail.yahoo.com (or smtp.mail.yahoo.co.uk)
  • SMTP Server Port: 25
  • POP3 Before SMTP Send: No
  • SMTP Authentication Mode: Auto
  • SMTP Authentication Username: Your Yahoo! login (e.g. JoeSmith)
  • SMTP Authentication Password: Your Yahoo! password
  • SMTP SSL: No
  • SMTP SSL Protocol: Auto

  General Notes

  For some SMTP servers specify SMTP Authentication Mode as "None" and supply both Username and Password.
  
  
• Understanding SMTP Relay
  
  

  Please consult this Microsoft article:

  http://support.microsoft.com/?kbid=304897
  
  
• Scheduler service won't authenticate once anonymous logon is removed. Local loopback security check
  
  If the scheduler service is installed on the web server and the web server is utilising host headers for Gemini, then Integrated Windows authentication will fail due to the local loopback security check. As a result the scheduler service will only run with anonymous access.
  
  Please refer to the following Microsoft KB article- http://support.microsoft.com/?kbid=896861
  

Gemini Web Services SDK

• Using Windows Authentication with REST
  
  In order to use Windows Authentication when invoking the Gemini RESTful services, please ensure that appropriate file system permissions have been granted on the "api" folder located under the Gemini web application.

  
  

  http://community.countersoft.com/forums/thread/13541.aspx
  

  
  

  
  

Licensing

• How is Gemini licensed?
  
  

  Gemini is licensed per installation. The commercial license allows for unlimited number of users and projects.

  Free upgrades and support are included for the first year.