xref: /freebsd/crypto/krb5/src/windows/leash/htmlhelp/html/Renew_Tickets.htm (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
2<html><head>
3<meta name="GENERATOR" content="Microsoft� HTML Help Workshop 4.1">
4
5<title>Renew_Tickets</title><link rel="stylesheet" type="text/css" href="Leash.css"></head>
6
7<body>
8<a name="top"><h1>Renew Tickets</h1></a>
9<p>
10Renew a ticket to extend its usable lifetime. Each time a ticket is
11renewed, its lifespan is reset to the original length of the ticket. It
12can then be used until the new time listed in the "Valid Until" column
13in the main window. </p>
14
15<table>
16<tbody><tr>
17 <th id="th2">Learn about...</th><th id="th2">How to...</th></tr>
18<tr>
19<td>
20<ul id="helpul">
21<li><a href="#conditions"> What's necessary to renew tickets</a></li>
22<li><a href="#related-help"> Related help</a></li>
23</ul>
24</td>
25<td>
26<ul id="helpul">
27<li><a href="#renew-once"> Renew ticket once</a></li>
28<li><a href="#renew-automatically"> Renew tickets automatically</a></li>
29<li><a href="#renewable-until">Find  how long a ticket can be renewed</a></li>
30</ul>
31</td>
32
33</tr>
34</tbody></table>
35
36
37
38<a name="renew-once"><p></p></a>
39<h2>Renew ticket once</h2>
40
41<ol>
42<li>If you have more than one <a href="JavaScript:popup.TextPopup(popupPrincipal, popfont,9,9,-1,-1)">principal</a>, click to select all principals with tickets you want to renew. </li>
43<li>Click the Renew Ticket button in the Home tab or use the <a href="JavaScript:popup.TextPopup(popupKeyboardShortcut, popfont,9,9,-1,-1)">keyboard shortcut</a>  [Ctrl + r].</li>
44</ol>
45<p>
46The ticket lifetime is reset for all of the selected principal's renewable tickets.</p>
47<p>
48<a href="#top">Back to Top</a> </p>
49
50
51<a name="renew-automatically"><p></p></a>
52<h2>Renew tickets automatically</h2>
53<ol>
54<li>Open the Options tab in the main window.</li>
55<li> In the Ticket  Options panel, select the Automatic Ticket Renewal checkbox if it is not already checked.</li>
56</ol>
57<p>
58Your renewable  tickets will automatically reset their lifetimes
59before they expire, until the renewable lifetime of the tickets is
60reached. </p>
61<p>
62<b>Note: </b>This feature only works while MIT Kerberos is active and
63running. This means that if your machine is in hibernation mode or if
64Kerberos is not running when it is time to renew your tickets, your
65tickets will not be renewed and will expire instead. </p>
66<p>
67<a href="#top">Back to Top</a> </p>
68<a name="conditions"><p></p></a>
69<h2>What's necessary to renew tickets</h2>
70<p>
71You can renew a ticket if the following conditions are met:</p>
72<ul>
73<li> When you obtained the ticket, the Renewable flag was selected. <br> <a href="HTML/Ticket_Settings.htm">About: Ticket Settings and Flags </a></li>
74<li> The "Renewable Until" deadline has not been reached. Show or hide
75the Renewable Until column with the View Options panel in the Options
76tab. <br> <a href="Options_Tab.htm#using-view-options">How to: Use View Options Panel</a></li>
77<li> The ticket has not already expired. </li>
78<li>MIT Kerberos is running and your computer is not in hibernation mode.</li>
79</ul>
80<p>
81<a href="#top">Back to Top</a> </p>
82<a name="renewable-until"><p></p></a>
83<h2>Find  how long a ticket can be renewed</h2>
84<ol>
85<li>Open the Options tab in the main window.</li>
86<li> In the View  Options panel, select the Renewable Until checkbox.</li>
87</ol>
88<p> The Renewable Until column will appear. You can renew your ticket
89repeatedly until the date and time in this column is reached. </p>
90<p>
91<a href="#top">Back to Top</a> </p>
92<a name="related-help"><p></p></a>
93<h2>Related help</h2>
94<ul id="helpul">
95<li><a href="HTML/Tickets.htm#renewable">About renewable  tickets</a></li>
96<li><a href="HTML/Ticket_Settings.htm">Ticket settings and flags</a></li>
97<li><a href="HTML/Get_Tickets.htm">Get  tickets</a></li>
98</ul>
99<p>
100<a href="#top">Back to Top</a> </p>
101<script language="JavaScript">
102popfont="Arial,.725,"
103popupPrincipal="Your principal is your Kerberos identity. It is your user name combined with the Kerberos realm you are using. For example: 'jdoe@SALES.WIDGET.COM' "
104popupKeyboardShortcut="To use a keyboard shortcut, hold down the [Ctrl] key on your computer keyboard and press the appropriate letter.  "
105</script>
106
107<object id="popup" type="application/x-oleobject" classid="clsid:adb880a6-d8ff-11cf-9377-00aa003b7a11">
108</object>
109</body></html>
110