Alert.png The wiki is deprecated and due to be decommissioned by the end of September 2022.
The content is being migrated to other supports, new updates will be ignored and lost.
If needed you can get in touch with EGI SDIS team using operations @ egi.eu.

Difference between revisions of "FAQ GGUS-User Guide"

From EGIWiki
Jump to navigation Jump to search
 
(45 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{GGUS-header-edit|FAQ GGUS-User-Guide}}
{{GGUS-header-edit|FAQ GGUS-User-Guide}}
= Introduction =
= Introduction =
The GGUS system is the primary means by which users request support when they are using the grid. The GGUS system creates a trouble ticket to record the request and tracks the ticket from creation through to solve.  The user of the system should not need to know any of the details of what happens to the ticket in order to get it from creation to solve.  However, an understanding of the operation of the system may be helpful to explaining what happens when you request help.
GGUS system is the central helpdesk for EGI and WLCG communities. The GGUS system creates a trouble ticket to record the request and tracks the ticket from creation through to solve.  The user of the system should not need to know any of the details of what happens to the ticket in order to get it from creation to solve.  However, an understanding of the operation of the system may be helpful to explaining what happens when you request help. Use the GGUS [https://ggus.eu web interface] to create the ticket.
There are two ways in which a user can submit a request for help:
* Send an e-mail to helpdesk<<at>>ggus.org,
* Use the GGUS [https://ggus.eu web interface] to create the ticket.
The first one of these methods is further documented in section [[#Submitting_a_ticket_using_email|Submitting a ticket using email]] of this note.<br>
The web interface is described in section [[#Accessing_the_web_interface_to_GGUS|Accessing the web interface to GGUS]] of this note.<br>
The web interface is described in section [[#Accessing_the_web_interface_to_GGUS|Accessing the web interface to GGUS]] of this note.<br>
Once the ticket has entered GGUS, it is processed by assigning it to the appropriate group to deal with the problem. The groups are generally addressed via mailing lists, and so GGUS assigns the ticket to a group, and an e-mail message is sent to people on the appropriate list. Sometimes, a ticket is simple and it is assigned to the correct group immediately and dealt with immediately.
Once the ticket has entered GGUS, it is processed by assigning it to the appropriate group to deal with the issue. The groups are generally addressed via mailing lists, and so GGUS assigns the ticket to a group, and an e-mail message is sent to people on the appropriate list. Sometimes, a ticket is simple and it is assigned to the correct group immediately and dealt with immediately.
 
= Submitting a ticket using email =
This is quite the simplest way to request help. The user simply sends an e-mail to helpdesk@ggus.org. The e-mail is converted into a ticket and processed. 
The information provided in the email should be as detailed as possible. Helpful information could be
* The name of the site concerned,
* The VO concerned and whether it is a VO specific problem,
* The error message received,
* The command used,
* Software versions (OS, Middleware etc.).
The user will receive e-mails which either request further information from the user, or which notify the user of a change in status of the ticket.  For simple cases, this should be all that is necessary for the user to know.
The e-mails which a user receives may include links into the ticketing system. If the user uses the link, then GGUS will ask the user to identify him. The user does this using his digital certificate. The digital certificate must be registered with GGUS.<br>
<b>Note: All emails sent to helpdesk@ggus.org are either added to an existing ticket or trigger the creation of a new ticket. Please avoid sending mails to this mail address if you do not want to submit a new ticket or update an existing one.</b>
 
== Attachments and emails with large body ==
Attachments to ticket submit mails are processed like the mail itself. They are added to the ticket. The size of attachments is limited to 2 MB. Please avoid file formats like .exe, php, html etc.<br>
Mails with a body size of more than 3500 chars are cut during the mail processing. The cut part is also added as attachment to the ticket.
 
== How to set the priority of a ticket ==
It is possible to define a priority by adding a number in square brackets to the subject line of the mail. Priority numbers can be 1, 2, 3 and 4.
* 1 stands for priority “less urgent”. This is also the default priority of tickets.
* 2 stands for priority “urgent”,
* 3 stands for priority “very urgent”,
* 4 stands for priority “top priority”.
The subject should look like “[2] gcc: Command not found” for defining a ticket priority”.


= Submitting a ticket using the web interface =
= Submitting a ticket using the web interface =
Before using this route, it is essential to have a digital certificate and that it is installed in the manner appropriate for its use by the browser being used. A description of how to do this is outside the scope of this document.  Some of the Certificate Authorities (CAs) provide documentation on this matter.
Before using this route, it is essential to have either a digital certificate and that it is installed in the manner appropriate for its use by the browser being used or an EGI SSO account. A description of how to do this is outside the scope of this document.  Some of the Certificate Authorities (CAs) provide documentation on this matter. For further information on EGI SSO accounts please refer to the [https://www.egi.eu/sso/ EGI SSO pages]


== Accessing the web interface to GGUS ==
== Accessing the web interface to GGUS ==
Line 40: Line 12:
If the user carries out all of the steps above, but is not registered to use GGUS, then the home page is like shown in the following figure  
If the user carries out all of the steps above, but is not registered to use GGUS, then the home page is like shown in the following figure  
If the user faces problems with his certificate he may get help here:
If the user faces problems with his certificate he may get help here:
* http://lcg.web.cern.ch/LCG/digital.htm
* http://wlcg.web.cern.ch/getting-started/certificates/WLCG-CA/personal
* http://lcg.web.cern.ch/LCG/loading_certifs.htm
* https://wiki.egi.eu/wiki/USG_Getting_Certificate
* http://lcg.web.cern.ch/LCG/cert-trouble.htm
For accessing GGUS users have to register first. Registration process is described in chapter [[#Registering_at_GGUS|Registering at GGUS]].
For accessing GGUS users have to register first. Registration process is described in chapter [[#Registering_at_GGUS|Registering at GGUS]].


== Registering at GGUS ==
== Registering at GGUS ==
For registering at GGUS the user should go to [https://ggus.eu/pages/home.php GGUS home] and click the [https://ggus.eu/admin/register.php registration] link.
For getting support privileges users need to be register at GGUS. For registering at GGUS the user should go to [https://ggus.eu/index.php?mode=index GGUS home] and click the [https://ggus.eu/index.php?mode=register_info registration] link.
This link opens the registration form the user has to fill in. Additionally there are some links were the user can find information about grid certificates.<br>
This link opens the registration form that the user has to fill in. In addition, there are some links where the user can find information about grid certificates.
Users who do not have a valid digital certificate can access GGUS with login and password.
Users who do not have a valid digital certificate can access GGUS via EGI SSO or via login and password. Since the use of login and password will no longer be guaranteed in the future, it is recommended to access GGUS with a valid digital certificate or EGI SSO. Both authentication methods, Grid certificate and EGI SSO, will be guaranteed in the future. After filling in the registration form, the user receives an e-mail from the GGUS employees with his access data to GGUS.
The usage of login and password is not guaranteed to be supported in future, so it is recommend accessing GGUS with a valid digital certificate. The usage of a valid digital certificate is guaranteed in future.
After filling in the registration form the user will receive an email from GGUS staffs with his access data for GGUS.


== Accessing GGUS with certificate ==
== Accessing GGUS with certificate ==
[[File:GGUS Home.png|thumb|Figure 2: GGUS home page for recognized users]]
[[File:GGUS Home.png|thumb|Figure 2: GGUS home page for recognized users]]
The primary address of the GGUS portal is: http://ggus.eu. When the user types this into the browser, then an alert is displayed by the browser requesting that the user indicate which certificate to use (if the user has not selected to choose the certificate automatically in the browser settings).  The reason for this alert is that GGUS has to validate the user to provide the appropriate access.  Once this is done, the user is not required to provide further identification. The user identifies himself with his digital certificate.   
The primary address of the GGUS portal is: http://ggus.eu. If the user enters this in the browser, a warning will be displayed by the browser prompting the user to specify which certificate to use (if the user has not selected to automatically select the certificate in the browser settings).  The reason for this warning is that GGUS has to validate the user in order to allow access.  After that, the user will no longer be asked to identify himself. The user identifies himself with his digital certificate.   
At this point, GGUS has identified the user, and displays the home page, as shown in Figure 5: GGUS home page for recognized users. Note that in this case, the identity of the user is displayed on the page, and GGUS has recognized that this user is registered for submitting tickets.  
At this point in time, GGUS has identified the user and displays the start page as shown in Figure 2: GGUS home page for registered users. Note that in this case, the user's identity is displayed on the page and GGUS has recognized that this user is registered to submit tickets.  
If authentication via certificate fails, you are guided to the login page (Figure 6: Screen to login to GGUS with login and password).
If authentication by certificate fails, you will be taken to the login page.
 
== Accessing GGUS via EGI SSO==
When choosing "Login via EGI AAI CheckIn" on the login page the user is guided to the EGI AAI page were the users Identity Provider can be selected. After authenticating there the user will be redirected to GGUS.


== The ticket submit form on web interface ==
== The ticket submit form on web interface ==
[[File:Ticket Submit Form.png|thumb|Figure 3: Ticket submit form on web interface]]
[[File:Ticket Submit Form.png|thumb|Figure 3: Ticket submit form on web interface]]
The tickets submit form offers a set of fields which should help the user to describe his problem as detailed as possible.
The tickets submit form offers a set of fields which should help the user to describe his issue as detailed as possible.
Most of the fields on the submit form are optional. Only field “Subject” is required. The submit form consists of three main sections: the <b>user information</b>, the <b>problem information</b> and the <b>routing information</b>.
Most of the fields on the submit form are optional. Only field “Subject” is required. The submit form consists of three main sections: the <b>user information</b>, the <b>issue information</b> and the <b>routing information</b>.
# User information<br>
# User information<br>
#: Most fields in the user information section are pre-filled by GGUS system.  
#: Most fields in the user information section are pre-filled by GGUS system.  
#:* “Name/Login” is taken from the GGUS user database.
#:* “Name/Login” is taken from the GGUS user database.
#:* “E-Mail” is also taken from the GGUS user database.  
#:* “E-Mail” is also taken from the GGUS user database.  
#:* “Notification mode” defaults to “on solution”. The “Notification mode” manages the update notifications the user receives. “On solution” means that the user only gets notified when the ticket status is set to “solved”. Additional information is available by clicking on the question mark on the right hand side of the field label.
#:* “Notification mode” defaults to “on solution”. The “Notification mode” manages the update notifications the user receives. “On solution” means that the user only gets notified when the ticket status is set to “solved” or a comment is added to the public diary. Additional information is available by clicking on the question mark on the right hand side of the field label.
#:* “CC to” could be filled with any mail address of people who should be informed about this ticket. Notifications are sent on every ticket update. The field content could only be changed by people who have support access. Additional information is available by clicking on the question mark.
#:* “CC to” could be filled with any mail address of people who should be informed about this ticket. Notifications are sent on every ticket update. The field content could only be changed by people who have support access. Additional information is available by clicking on the question mark.
# Problem information<br>
# Issue information<br>
#:Although only one field is mandatory in this section as much fields as possible should be filled with information.
#:Although only one field is mandatory in this section as much fields as possible should be filled with information.
#:* “Date/Time of problem” defaults to the submitting time. This field should be set if the ticket is submitted much later than the problem occurred.
#:* “Date/Time of issue” defaults to the submitting time. This field should be set if the ticket is submitted much later than the issue occurred.
#:* “Affected Site” The site impacted by the problem. A drop-down list with all EGI sites registered in GOC DB and OSG sites registered in OIM DB is available. This is no routing information!
#:* “Subject” is a mandatory field. It should give a short description of the issue. This field is limited to 250 characters.
#:* “Affected ROC/NGI” The NGI/ROC impacted by the problem. A drop-down list of all NGIs/ROCs integrated in GGUS is provided.
#:* “Describe your issue…” is limited to 4000 characters. It should be used for a detailed description of the issue. If the user does not know which information to add here he could click on the question mark for getting additional information.
#:* “Concerned VO” provides a drop-down list of all VOs supported by GGUS.
#:* “Concerned VO” provides a drop-down list of all VOs supported by GGUS.
#:* “VO specific” is a flag indicating whether a problem is VO specific or not. It defaults to “no”. This flag could only be set to “yes” in combination with a VO selected in field “Concerned VO”.
#:* “VO specific” is a flag indicating whether an issue is VO specific or not. It defaults to “no”. This flag could only be set to “yes” in combination with a VO selected in field “Concerned VO”.
#:* “Does it affect the whole” allows specifying whether a problem is affecting a VO or site or ROC as a whole.
#:* “Affected Site” The site impacted by the issue. A drop-down list with all EGI sites registered in GOC DB and OSG sites registered in OIM DB is available. This is no routing information!
#:* “Subject” is a mandatory field. It should give a short description of the problem. This field is limited to 250 characters.
#:* “Affected ROC/NGI” The NGI/ROC impacted by the issue. A drop-down list of all NGIs/ROCs integrated in GGUS is provided.
#:* “Describe your problem …” is limited to 4000 characters. It should be used for a detailed description of the problem. If the user does not know which information to add here he could click on the question mark for getting additional information.
#:* “Ticket category” provides a drop-down list with possible values. This field is for categorizing the issue. It defaults to “Incident”.
#:* “Command used” is for providing the command used when facing the problem.
#:* “Type of issue” provides a drop-down list with possible values. This field is for categorizing the issue. It defaults to “Other”.
#:* “Error message you obtain” is for adding the error message, if got one.
#:* “OS, Middleware, Application version” is for providing information on software versions used.
#:* “Type of problem” provides a drop-down list with possible values. This field is for categorizing the problem. It defaults to “Other”.
#:* “Priority” provides a drop-down list with possible priority values. They are “less urgent” which is the default, “urgent”, “very urgent” and “top priority”.
#:* “Priority” provides a drop-down list with possible priority values. They are “less urgent” which is the default, “urgent”, “very urgent” and “top priority”.
#:* “Attach file(s)” offers the possibility to upload 4 attachments (e.g. log files etc.) at a time. Attachments are limited to 2 MB. Please avoid uploading file formats “.exe”, “.php”, “.htm(l)”.
#:* “Attach file(s)” offers the possibility to upload 4 attachments (e.g. log files etc.) at a time. Attachments are limited to 2 MB. Please avoid uploading file formats “.exe”, “.php”, “.htm(l)”.
Line 91: Line 60:


== Bypassing the TPM ==
== Bypassing the TPM ==
Users can bypass the TPM if they have good knowledge about where the problem is by either selecting site or NGI/ ROC names from the drop down menus on submit form. If selecting a site name the site will receive a notification about the ticket. Additionally the NGI/ROC the site belongs to is set automatically. Hence the ticket is assigned to this NGI/ROC.  
The TPM (Ticket Processing Manager) is the 1st Line Support in GGUS. Users can bypass the TPM if they have good knowledge about where the problem is. For this purpose at the bottom of ticket submit form there is a section "Routing information". Selecting either a site from the [[FAQ_GGUS-Notify-Sites | "Notify SITE"]] drop-down menu '''or''' a support unit from the "Assign to support unit" drop-down menu routes the ticket directly to the selected support unit. If selecting a site name the NGI/ROC the site belongs to is set automatically. Hence the ticket is assigned to the relevant NGI/ROC. Additionally the site will receive a notification about the ticket.  
Selecting values in both fields, “Notify SITE” and “Assign to NGI/ROC” is not possible.
Selecting both, the "Notify SITE" and the "Assign to support unit" is not possible.
 
Tickets of type [[FAQ_GGUS-Team-Tickets | TEAM]] and [[FAQ_GGUS-Alarm-Tickets | ALARM]] are always routed to the relevant NGI/ROC by default.


= Browsing your own tickets =
= Browsing your own tickets =
After authenticating himself the user has access to the GGUS homepage. On this page he sees a list of his own open tickets and a list of the latest open tickets of all users (Figure 5). Below the list of the user’s own open tickets there are two links for further browsing possibilities of the user’s own tickets:
After authenticating himself the user has access to the GGUS homepage. On this page he sees a list of his own open tickets and a list of the latest open tickets of all users (Figure 2). Below the list of the user’s own open tickets there are two links for further browsing possibilities of the user’s own tickets:
* Show my complete ticket list,
* Show my complete ticket list,
* My Team Tickets.
* My Team Tickets.
Line 107: Line 78:


== Modifying your tickets using the web ==
== Modifying your tickets using the web ==
[[File:Ticket History.PNG|thumb|Figure 6: Ticket information section]]
[[File:Ticket History.PNG|thumb|Figure 6: Ticket history]]
For modifying a ticket the user can just click on the ticket ID. He is guided to another page. On this page are three main sections:  
For modifying a ticket the user can just click on the ticket ID. He is guided to another page. On this page are three main sections:  
* the ticket information (Figure 6),
* the ticket information (Figure 7),
* the ticket history (Figure 7) and  
* the ticket history (Figure 6) and  
* the modify section (Figure 8).
* the modify section (Figure 8).
The ticket information gives an overview of the personal data the user provided, the problem description and the ticket status.
The ticket information gives an overview of the personal data the user provided, the issue description and the ticket status.
The ticket history shows all actions that have been taken to solve the ticket, the date and time these actions have been taken and the name of the supporter who did them.
The ticket history shows all actions that have been taken to solve the ticket, the date and time these actions have been taken and the name of the supporter who did them.
In the modify section the user can add some additional information or comment on a question of a supporter to him. The user can add attachments, change the email notification behavior of the system and change some other attributes of his ticket.
In the modify section the user can add some additional information or comment on a question of a supporter to him. The user can add attachments, change the email notification behavior of the system and change some other attributes of his ticket.
[[File:Ticket Information.PNG|thumb|Figure 7: Ticket history]]
[[File:Ticket Information.PNG|thumb|Figure 7: Ticket information section]]
[[File:GGUS Modifysection User.PNG|thumb|Figure 8: Ticket modify section]]
[[File:GGUS Modifysection User.PNG|thumb|Figure 8: Ticket modify section]]


Line 131: Line 102:
=== Verifying the solution ===
=== Verifying the solution ===
[[File:GGUS Verify Button.png|thumb|Figure 10: Verify button]]
[[File:GGUS Verify Button.png|thumb|Figure 10: Verify button]]
When a ticket is solved the user could confirm that the solution has solved his problem by verifying it. A solution could be verified by either  
When a ticket is solved the user could confirm that the solution has solved his issue by verifying it. A solution could be verified by either  
* Clicking the “Verify” button in the web portal or
* Clicking the “Verify” button in the web portal or
* Replying to the solution mail without changing anything.
* Replying to the solution mail without changing anything.
Line 196: Line 167:
* Search ticket database,
* Search ticket database,
* Show all open tickets,
* Show all open tickets,
* Show LHCOPN tickets,
* Technology Helpdesk.


== GGUS search engine ==
== GGUS search engine ==
[[File:GGUS User Search.PNG|thumb|Figure 12: GGUS search engine]]
[[File:GGUS User Search.PNG|thumb|Figure 12: GGUS search engine]]
For browsing all tickets the GGUS search engine is a useful tool (Figure 16: GGUS search engine for users). The GGUS search engine can be entered by clicking on link “Search ticket database”. When accessing the search engine a default search is performed like shown in Figure 16: GGUS search engine for users.  
For browsing all tickets the GGUS search engine is a useful tool (Figure 12: GGUS search engine). The GGUS search engine can be entered by clicking on link “Search ticket database”. When accessing the search engine a default search is performed like shown in Figure 12: GGUS search engine.  
Searching via Ticket ID is the easiest and fastest way to look at a ticket. When searching via Ticket ID all other search parameters were ignored. Besides searching for all open tickets this is the recommended kind of search, because it avoids needless workload on the system. When searching via ticket ID the ticket details are shown in the same window. For getting back to the main page use the "Back" button of your browser.
Searching via Ticket ID is the easiest and fastest way to look at a ticket. When searching via Ticket ID all other search parameters were ignored. Besides searching for all open tickets this is the recommended kind of search, because it avoids needless workload on the system. When searching via ticket ID the ticket details are shown in the same window. For getting back to the main page use the "Back" button of your browser.
The various search parameters can be combined in any way wanted except “Untouched since”.  
The various search parameters can be combined in any way wanted except “Untouched since”.  
Line 209: Line 178:
== Showing all open tickets ==
== Showing all open tickets ==
Clicking on this link shows all open tickets that are currently in the system. Unlike “Showing all open tickets” the default search in GGUS search engine uses a timeframe of one week for showing open tickets.
Clicking on this link shows all open tickets that are currently in the system. Unlike “Showing all open tickets” the default search in GGUS search engine uses a timeframe of one week for showing open tickets.
== Showing LHCOPN tickets ==
LHCOPN tickets are tickets from the OPN network group within EGI project. This group monitors networks and creates tickets if a network problem is detected. Also for scheduled downtimes for maintenance reasons tickets are created. Clicking on the link “Show LHCOPN tickets” guides to the LHCOPN dashboard giving an overview of open LHCOPN tickets.
== Technology Helpdesk ==
The technology helpdesk is a specific view for middleware providers. Accessing the technology helpdesk requires specific privileges.


= Contacting the GGUS team =
= Contacting the GGUS team =
Line 221: Line 184:


= GGUS development plans =
= GGUS development plans =
On GGUS home page there are a couple of links where users can get more information on the [https://ggus.eu/pages/development.php GGUS development plans] as well as submit own feature requests.
On GGUS home page there are a couple of links where users can get more information on the [https://ggus.eu/index.php?mode=development GGUS development plans] as well as submit own feature requests.
Feature requests are collected in the GGUS shopping lists in [https://savannah.cern.ch/support/?group=esc savannah] and [https://rt.egi.eu/rt/Dashboards/2636/GGUS-Requirements EGI RT].
Feature requests are collected in the GGUS shopping lists in [https://its.cern.ch/jira/secure/CreateIssue!default.jspa JIRA] (only for users having a CERN account) and [https://rt.egi.eu/rt/Dashboards/2636/GGUS-Requirements EGI RT].


= Operation of GGUS =
= Operation of GGUS =
== Some words about GGUS system ==
The GGUS system is running on servers located at Karlsruhe Institute of Technology (KIT), Germany.  
The GGUS system is running on servers located at Karlsruhe Institute of Technology (KIT), Germany.  
Besides the GGUS production system a backup system is in place. Switching from production system to backup system currently needs manual interaction. An automatic switch in case of fail-over will be implemented.
Besides the GGUS production system a backup system is in place. Switching from production system to backup system currently needs manual interaction. An automatic switch in case of fail-over will be implemented.
GGUS staffs at Karlsruhe are not providing support apart from requests concerning GGUS system itself. They can be contacted by email to support@ggus.org. Usual office hours for GGUS staffs are from 07:00 to 15:00 o’clock (UTC).
GGUS staffs at Karlsruhe are not providing support apart from requests concerning GGUS system itself. They can be contacted by email to support<<at>>ggus.org. Usual office hours for GGUS staffs are from 07:00 to 15:00 o’clock (UTC).


== Some words about TPM ==
== TPM ==
TPM is the most important part of the support system for the grid. TPM is ticket process management. The purpose of TPM is:
TPM (Ticket Processing Manager) is the most important part of the support system for the grid. The purpose of TPM is:
* closing simple trouble tickets,
* closing simple trouble tickets,
* ensuring that other tickets are sent to the correct place for processing,
* ensuring that other tickets are sent to the correct place for processing,
* reacting to alarms that tickets have not been processed,
* reacting to alarms that tickets have not been processed,
TPM teams work on a bi-weekly rotating basis. There is always one team on duty and one backup team. The teams consist of people with a broad knowledge of the Grid. TPM effort is done by Italy and Germany co-operating with GGUS.
The TPM teams consist of people with a broad knowledge of the Grid. TPM effort is done by NGIs CZ and IBERGRID.
 
== Ticket Monitoring ==
Besides developing and maintaining GGUS system the GGUS team is also doing the ticket monitoring. The ticket monitoring team is responsible for:
* [https://wiki.egi.eu/wiki/FAQ_GGUS-Waiting-For-Submitter-Process reminding users] in case their input is required for further ticket processing
* [https://wiki.egi.eu/wiki/FAQ_GGUS-Waiting-For-PT-Process reminding supporters] in case tickets are not processed
* assisting in any problem during ticket processing


= What if I have questions which are not dealt with by this FAQ?  =
= What if I have questions which are not dealt with by this FAQ?  =

Latest revision as of 14:42, 17 September 2018

GGUS-logo.jpg


GGUS wiki / GGUS Documentation


FAQ GGUS-User-Guide


Introduction

GGUS system is the central helpdesk for EGI and WLCG communities. The GGUS system creates a trouble ticket to record the request and tracks the ticket from creation through to solve. The user of the system should not need to know any of the details of what happens to the ticket in order to get it from creation to solve. However, an understanding of the operation of the system may be helpful to explaining what happens when you request help. Use the GGUS web interface to create the ticket. The web interface is described in section Accessing the web interface to GGUS of this note.
Once the ticket has entered GGUS, it is processed by assigning it to the appropriate group to deal with the issue. The groups are generally addressed via mailing lists, and so GGUS assigns the ticket to a group, and an e-mail message is sent to people on the appropriate list. Sometimes, a ticket is simple and it is assigned to the correct group immediately and dealt with immediately.

Submitting a ticket using the web interface

Before using this route, it is essential to have either a digital certificate and that it is installed in the manner appropriate for its use by the browser being used or an EGI SSO account. A description of how to do this is outside the scope of this document. Some of the Certificate Authorities (CAs) provide documentation on this matter. For further information on EGI SSO accounts please refer to the EGI SSO pages

Accessing the web interface to GGUS

Figure 1: GGUS home page for unregistered users

If the user carries out all of the steps above, but is not registered to use GGUS, then the home page is like shown in the following figure If the user faces problems with his certificate he may get help here:

For accessing GGUS users have to register first. Registration process is described in chapter Registering at GGUS.

Registering at GGUS

For getting support privileges users need to be register at GGUS. For registering at GGUS the user should go to GGUS home and click the registration link. This link opens the registration form that the user has to fill in. In addition, there are some links where the user can find information about grid certificates. Users who do not have a valid digital certificate can access GGUS via EGI SSO or via login and password. Since the use of login and password will no longer be guaranteed in the future, it is recommended to access GGUS with a valid digital certificate or EGI SSO. Both authentication methods, Grid certificate and EGI SSO, will be guaranteed in the future. After filling in the registration form, the user receives an e-mail from the GGUS employees with his access data to GGUS.

Accessing GGUS with certificate

Figure 2: GGUS home page for recognized users

The primary address of the GGUS portal is: http://ggus.eu. If the user enters this in the browser, a warning will be displayed by the browser prompting the user to specify which certificate to use (if the user has not selected to automatically select the certificate in the browser settings). The reason for this warning is that GGUS has to validate the user in order to allow access. After that, the user will no longer be asked to identify himself. The user identifies himself with his digital certificate. At this point in time, GGUS has identified the user and displays the start page as shown in Figure 2: GGUS home page for registered users. Note that in this case, the user's identity is displayed on the page and GGUS has recognized that this user is registered to submit tickets. If authentication by certificate fails, you will be taken to the login page.

Accessing GGUS via EGI SSO

When choosing "Login via EGI AAI CheckIn" on the login page the user is guided to the EGI AAI page were the users Identity Provider can be selected. After authenticating there the user will be redirected to GGUS.

The ticket submit form on web interface

Figure 3: Ticket submit form on web interface

The tickets submit form offers a set of fields which should help the user to describe his issue as detailed as possible. Most of the fields on the submit form are optional. Only field “Subject” is required. The submit form consists of three main sections: the user information, the issue information and the routing information.

  1. User information
    Most fields in the user information section are pre-filled by GGUS system.
    • “Name/Login” is taken from the GGUS user database.
    • “E-Mail” is also taken from the GGUS user database.
    • “Notification mode” defaults to “on solution”. The “Notification mode” manages the update notifications the user receives. “On solution” means that the user only gets notified when the ticket status is set to “solved” or a comment is added to the public diary. Additional information is available by clicking on the question mark on the right hand side of the field label.
    • “CC to” could be filled with any mail address of people who should be informed about this ticket. Notifications are sent on every ticket update. The field content could only be changed by people who have support access. Additional information is available by clicking on the question mark.
  2. Issue information
    Although only one field is mandatory in this section as much fields as possible should be filled with information.
    • “Date/Time of issue” defaults to the submitting time. This field should be set if the ticket is submitted much later than the issue occurred.
    • “Subject” is a mandatory field. It should give a short description of the issue. This field is limited to 250 characters.
    • “Describe your issue…” is limited to 4000 characters. It should be used for a detailed description of the issue. If the user does not know which information to add here he could click on the question mark for getting additional information.
    • “Concerned VO” provides a drop-down list of all VOs supported by GGUS.
    • “VO specific” is a flag indicating whether an issue is VO specific or not. It defaults to “no”. This flag could only be set to “yes” in combination with a VO selected in field “Concerned VO”.
    • “Affected Site” The site impacted by the issue. A drop-down list with all EGI sites registered in GOC DB and OSG sites registered in OIM DB is available. This is no routing information!
    • “Affected ROC/NGI” The NGI/ROC impacted by the issue. A drop-down list of all NGIs/ROCs integrated in GGUS is provided.
    • “Ticket category” provides a drop-down list with possible values. This field is for categorizing the issue. It defaults to “Incident”.
    • “Type of issue” provides a drop-down list with possible values. This field is for categorizing the issue. It defaults to “Other”.
    • “Priority” provides a drop-down list with possible priority values. They are “less urgent” which is the default, “urgent”, “very urgent” and “top priority”.
    • “Attach file(s)” offers the possibility to upload 4 attachments (e.g. log files etc.) at a time. Attachments are limited to 2 MB. Please avoid uploading file formats “.exe”, “.php”, “.htm(l)”.
  3. Routing Information
    • “Notify SITE” provides a drop-down list with all EGI sites registered in GOC DB and OSG sites registered in OIM DB. If selecting a site from the list this site will be notified about this ticket by mail. Additionally the ticket is assigned to the appropriate NGI/ROC directly, bypassing the TPM (Some words about TPM). If setting a site value the appropriate NGI/ROC is set automatically. Choosing an NGI/ROC simultaneously is not possible.
    • “Assign to ROC/NGI” provides a drop-down list of all NGIs/ROCs integrated in GGUS. Choosing a value in this field assigns the ticket to the appropriate ROC directly, bypassing the TPM. If assigning a ticket to an NGI/ROC choosing a site value simultaneously is not possible.


After clicking the “Submit” button the user gets a confirmation page showing the information submitted and the ticket ID.

Figure 4: Confirmation after ticket submit

Bypassing the TPM

The TPM (Ticket Processing Manager) is the 1st Line Support in GGUS. Users can bypass the TPM if they have good knowledge about where the problem is. For this purpose at the bottom of ticket submit form there is a section "Routing information". Selecting either a site from the "Notify SITE" drop-down menu or a support unit from the "Assign to support unit" drop-down menu routes the ticket directly to the selected support unit. If selecting a site name the NGI/ROC the site belongs to is set automatically. Hence the ticket is assigned to the relevant NGI/ROC. Additionally the site will receive a notification about the ticket. Selecting both, the "Notify SITE" and the "Assign to support unit" is not possible.

Tickets of type TEAM and ALARM are always routed to the relevant NGI/ROC by default.

Browsing your own tickets

After authenticating himself the user has access to the GGUS homepage. On this page he sees a list of his own open tickets and a list of the latest open tickets of all users (Figure 2). Below the list of the user’s own open tickets there are two links for further browsing possibilities of the user’s own tickets:

  • Show my complete ticket list,
  • My Team Tickets.

The system only shows the user tickets which have been created with the same authentication information the user is currently logged in. This means if a user submits tickets with different certificates he does not see all of his tickets. The reason for this is that the DN string of the certificate is stored in each ticket. Showing all tickets of a user can be done by using the GGUS search engine. In the GGUS search engine users can search by user name amongst others. This search will show all tickets of a user independent from the authentication information.

Show my complete ticket list

Figure 5: Complete ticket list on GGUS home

This link opens a new window showing tables of all open and closed tickets of the user and all tickets of other users the user has subscribed to. Information on how to subscribe to a ticket is available in chapter Subscribing to a ticket of another user.

Modifying tickets

Modifying your tickets using the web

Figure 6: Ticket history

For modifying a ticket the user can just click on the ticket ID. He is guided to another page. On this page are three main sections:

  • the ticket information (Figure 7),
  • the ticket history (Figure 6) and
  • the modify section (Figure 8).

The ticket information gives an overview of the personal data the user provided, the issue description and the ticket status. The ticket history shows all actions that have been taken to solve the ticket, the date and time these actions have been taken and the name of the supporter who did them. In the modify section the user can add some additional information or comment on a question of a supporter to him. The user can add attachments, change the email notification behavior of the system and change some other attributes of his ticket.

Figure 7: Ticket information section
Figure 8: Ticket modify section

Escalating a ticket

Figure 9: Escalation button

Between the information section and the ticket history there is a button which allows the user to escalate a ticket (Figure 9). Three escalation levels are available in GGUS:

  • Escalating ticket to the support unit it is assigned to,
  • Escalating the ticket to the support unit and the TPM on shift,
  • Escalating the ticket to the support unit, the TPM and the GGUS ticket monitoring.

The escalation levels are reached one by one. It is not possible to choose one of them. Additional information is available by clicking on the little question mark on the left hand side of the button.

Reopen a solved ticket

If a ticket is already closed it could be reopened by adding a comment and changing the status to “reopened” in the “Modify section” (Figure 10). In this case the support unit which solved the ticket and the TPM receive an email about the ticket reopening.

Verifying the solution

Figure 10: Verify button

When a ticket is solved the user could confirm that the solution has solved his issue by verifying it. A solution could be verified by either

  • Clicking the “Verify” button in the web portal or
  • Replying to the solution mail without changing anything.

Verifying a solution can help to increase the quality of solutions in GGUS.

Modify your tickets using email

Updating a ticket using email is also possible if one fundamental requirement is achieved. The mail subject must contain the typical GGUS string “GGUS-Ticket-ID: #<<Ticket-ID>>” where <<Ticket-ID>> is the ID of the ticket which should be updated. The easiest way to do this is to reply to an update notification received from GGUS. When updating a ticket using email the whole mail body will be added to the ticket. Changing any other field (e.g. status, priority,…) is impossible!

Ticket Participation

GGUS system offers various possibilities for participating in tickets. They are

  • the CC field,
  • the Involve others field and
  • the Subscribe field.

An overview on these fields is given in the table below. Ticket participation can be done by adding a valid mail address to one of these fields. Please avoid adding closed mailing lists as such produce a lot of mail errors! Several mail addresses have to be separated by semi-colon.

User submit User modify Supporter modify
CC Yes No Yes
Involve others No No Yes
Subscribe No Yes Yes

The “CC” field

The CC field can be set by the user in the ticket submit form. Updates are only possible for supporters for correcting or removing invalid mail addresses. Every ticket update triggers a notification email to the mail address specified in the “CC” field.

The “Involve others” field

The “Involve others” field is only for supporters use. Every ticket update triggers a notification email to the mail address specified in the “Involve others” field.

Subscribing to a ticket of another user

Figure 11: Ticket subscribe

Every user could subscribe to tickets of other users if he is interested in the solution of any. For subscribing a valid email address has to be provided. The user gets a notification once the ticket is solved. After subscribing to a ticket the user could change the notification mode or unsubscribe if he wants to (Figure 11). Accessing the system with the same credentials as used for subscription is necessary for this. Additional information on subscribing to tickets is available by clicking on the question mark at the right hand side of the label “Subscribe to this ticket”.

Who gets what email notification from GGUS?

The ticket "submitter" gets emails according to the "Notification mode" value (s)he selected when submitting the ticket. If the selected "Notification mode" value is "on every change" then all updates are sent to the "submitter". "Public Diary" entries are sent to the submitter regardless the value of the "Notification mode". "Internal Diary" entries never go to the "submitter". They are reserved for exchanges amongst supporters.

The email addresses in the "Cc:" field can be entered by the "submitter" and receive the same notifications as the submitter. "Public Diary" entries are sent to the addresses in the "Cc:" field. "Internal Diary" entries never go to the people in the "Cc:" field. They are reserved for exchanges amongst supporters.

The email addresses in the "Involve others:" field can be entered by supporters only and receive the same notifications as the Support Unit (SU) to which the ticket is assigned. "Internal Diary" entries are sent to the relevant SU members AND the people in the "Involve others:" field, as they are supposed to be experts and contribute to the ticket solution.

The email address in the "Assign to one person:" field can be entered by supporters only and receive the same notifications as the Support Unit (SU) to which the ticket is assigned. "Internal Diary" entries are sent to the relevant SU members AND the people in the "Involve others:" field AND the email address in the "Assign to one person:" field as they are, all, supposed to be experts and contribute to the ticket solution.

Every ticket update triggers an email to the addresses in the "Cc:", "Involve others:" and to ticket subscribers, i.e. GGUS users, unrelated to the specific ticket, who entered their own email in the "Subscribe to this ticket" field.

GGUS email notifications highlight the fields changed with the specific update.

Please avoid including closed mailing lists, e-groups in these fields as mail delivery will fail.

Browsing all tickets

At the bottom of the home page there are additional links for browsing:

  • Search ticket database,
  • Show all open tickets,

GGUS search engine

Figure 12: GGUS search engine

For browsing all tickets the GGUS search engine is a useful tool (Figure 12: GGUS search engine). The GGUS search engine can be entered by clicking on link “Search ticket database”. When accessing the search engine a default search is performed like shown in Figure 12: GGUS search engine. Searching via Ticket ID is the easiest and fastest way to look at a ticket. When searching via Ticket ID all other search parameters were ignored. Besides searching for all open tickets this is the recommended kind of search, because it avoids needless workload on the system. When searching via ticket ID the ticket details are shown in the same window. For getting back to the main page use the "Back" button of your browser. The various search parameters can be combined in any way wanted except “Untouched since”. Description fields “Keyword”, “Involved supporter” and “Assigned to person” trigger a LIKE search to the database. Concatenating keywords with “AND” or “OR” is currently not possible. The search can either be started by clicking on "go" or just hitting the return key. The result of a search by parameters is shown in the result list. For viewing ticket details just click on the ID. A new window opens showing ticket details. For getting back to the search result just close the window with the ticket details.

Showing all open tickets

Clicking on this link shows all open tickets that are currently in the system. Unlike “Showing all open tickets” the default search in GGUS search engine uses a timeframe of one week for showing open tickets.

Contacting the GGUS team

Users can click on the “Envelope” icon in the menu bar for sending an email to the GGUS team with any comments. Note: This must not be used for submitting support requests as it does not create a ticket in the system!

GGUS development plans

On GGUS home page there are a couple of links where users can get more information on the GGUS development plans as well as submit own feature requests. Feature requests are collected in the GGUS shopping lists in JIRA (only for users having a CERN account) and EGI RT.

Operation of GGUS

The GGUS system is running on servers located at Karlsruhe Institute of Technology (KIT), Germany. Besides the GGUS production system a backup system is in place. Switching from production system to backup system currently needs manual interaction. An automatic switch in case of fail-over will be implemented. GGUS staffs at Karlsruhe are not providing support apart from requests concerning GGUS system itself. They can be contacted by email to support<<at>>ggus.org. Usual office hours for GGUS staffs are from 07:00 to 15:00 o’clock (UTC).

TPM

TPM (Ticket Processing Manager) is the most important part of the support system for the grid. The purpose of TPM is:

  • closing simple trouble tickets,
  • ensuring that other tickets are sent to the correct place for processing,
  • reacting to alarms that tickets have not been processed,

The TPM teams consist of people with a broad knowledge of the Grid. TPM effort is done by NGIs CZ and IBERGRID.

Ticket Monitoring

Besides developing and maintaining GGUS system the GGUS team is also doing the ticket monitoring. The ticket monitoring team is responsible for:

  • reminding users in case their input is required for further ticket processing
  • reminding supporters in case tickets are not processed
  • assisting in any problem during ticket processing

What if I have questions which are not dealt with by this FAQ?

Please submit a GGUS ticket.