3 * Bacula Director -- next_vol -- handles finding the next
4 * volume for append. Split out of catreq.c August MMIII
5 * catalog request from the Storage daemon.
7 * Kern Sibbald, March MMI
12 Copyright (C) 2000, 2001, 2002 Kern Sibbald and John Walker
14 This program is free software; you can redistribute it and/or
15 modify it under the terms of the GNU General Public License as
16 published by the Free Software Foundation; either version 2 of
17 the License, or (at your option) any later version.
19 This program is distributed in the hope that it will be useful,
20 but WITHOUT ANY WARRANTY; without even the implied warranty of
21 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
22 General Public License for more details.
24 You should have received a copy of the GNU General Public
25 License along with this program; if not, write to the Free
26 Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
40 * MEDIA_DBR mr (zeroed out)
41 * create -- whether or not to create a new volume
43 int find_next_volume_for_append(JCR *jcr, MEDIA_DBR *mr, int create)
47 mr->PoolId = jcr->PoolId;
48 bstrncpy(mr->MediaType, jcr->store->media_type, sizeof(mr->MediaType));
49 Dmsg2(120, "CatReq FindMedia: Id=%d, MediaType=%s\n", mr->PoolId, mr->MediaType);
51 * Find the Next Volume for Append
55 bstrncpy(mr->VolStatus, "Append", sizeof(mr->VolStatus)); /* want only appendable volumes */
56 ok = db_find_next_volume(jcr, jcr->db, 1, mr);
57 Dmsg2(100, "catreq after find_next_vol ok=%d FW=%d\n", ok, mr->FirstWritten);
59 /* Well, try finding recycled volumes */
60 ok = find_recycled_volume(jcr, mr);
61 Dmsg2(100, "find_recycled_volume %d FW=%d\n", ok, mr->FirstWritten);
64 ok = recycle_oldest_purged_volume(jcr, mr);
65 Dmsg2(200, "find_recycled_volume2 %d FW=%d\n", ok, mr->FirstWritten);
67 /* See if we can create a new Volume */
68 ok = newVolume(jcr, mr);
72 if (!ok && (jcr->pool->purge_oldest_volume ||
73 jcr->pool->recycle_oldest_volume)) {
74 Dmsg2(200, "No next volume found. PurgeOldest=%d\n RecyleOldest=%d",
75 jcr->pool->purge_oldest_volume, jcr->pool->recycle_oldest_volume);
76 /* Find oldest volume to recycle */
77 ok = db_find_next_volume(jcr, jcr->db, -1, mr);
78 Dmsg1(400, "Find oldest=%d\n", ok);
81 Dmsg0(400, "Try purge.\n");
82 /* Try to purge oldest volume */
83 ua = new_ua_context(jcr);
84 if (jcr->pool->purge_oldest_volume) {
85 Jmsg(jcr, M_INFO, 0, _("Purging oldest volume \"%s\"\n"), mr->VolumeName);
86 ok = purge_jobs_from_volume(ua, mr);
88 Jmsg(jcr, M_INFO, 0, _("Pruning oldest volume \"%s\"\n"), mr->VolumeName);
89 ok = prune_volume(ua, mr);
93 ok = recycle_volume(jcr, mr);
94 Dmsg1(400, "Recycle after purge oldest=%d\n", ok);
99 Dmsg2(100, "VolJobs=%d FirstWritten=%d\n", mr->VolJobs, mr->FirstWritten);
101 /* If we can use the volume, check if it is expired */
102 if (has_volume_expired(jcr, mr)) {
103 /* Need to update media */
104 if (!db_update_media_record(jcr, jcr->db, mr)) {
105 Jmsg(jcr, M_ERROR, 0, _("Catalog error updating volume \"%s\". ERR=%s"),
106 mr->VolumeName, db_strerror(jcr->db));
108 if (retry++ < 200) { /* sanity check */
109 continue; /* try again from the top */
111 Jmsg(jcr, M_ERROR, 0, _(
112 "We seem to be looping trying to find the next volume. I give up.\n"));
123 * Check if any time limits or use limits have expired
124 * if so, set the VolStatus appropriately.
126 bool has_volume_expired(JCR *jcr, MEDIA_DBR *mr)
128 bool expired = false;
130 * Check limits and expirations if "Append" and it has been used
131 * i.e. mr->VolJobs > 0
134 if (strcmp(mr->VolStatus, "Append") == 0 && mr->VolJobs > 0) {
135 /* First handle Max Volume Bytes */
136 if ((mr->MaxVolBytes > 0 && mr->VolBytes >= mr->MaxVolBytes)) {
137 Jmsg(jcr, M_INFO, 0, _("Max Volume bytes exceeded. "
138 "Marking Volume \"%s\" as Full.\n"), mr->VolumeName);
139 bstrncpy(mr->VolStatus, "Full", sizeof(mr->VolStatus));
142 /* Now see if Volume should only be used once */
143 } else if (mr->VolBytes > 0 && jcr->pool->use_volume_once) {
144 Jmsg(jcr, M_INFO, 0, _("Volume used once. "
145 "Marking Volume \"%s\" as Used.\n"), mr->VolumeName);
146 bstrncpy(mr->VolStatus, "Used", sizeof(mr->VolStatus));
149 /* Now see if Max Jobs written to volume */
150 } else if (mr->MaxVolJobs > 0 && mr->MaxVolJobs <= mr->VolJobs) {
151 Jmsg(jcr, M_INFO, 0, _("Max Volume jobs exceeded. "
152 "Marking Volume \"%s\" as Used.\n"), mr->VolumeName);
153 bstrncpy(mr->VolStatus, "Used", sizeof(mr->VolStatus));
156 /* Now see if Max Files written to volume */
157 } else if (mr->MaxVolFiles > 0 && mr->MaxVolFiles <= mr->VolFiles) {
158 Jmsg(jcr, M_INFO, 0, _("Max Volume files exceeded. "
159 "Marking Volume \"%s\" as Used.\n"), mr->VolumeName);
160 bstrncpy(mr->VolStatus, "Used", sizeof(mr->VolStatus));
163 /* Finally, check Use duration expiration */
164 } else if (mr->VolUseDuration > 0) {
165 utime_t now = time(NULL);
166 /* See if Vol Use has expired */
167 if (mr->VolUseDuration <= (now - mr->FirstWritten)) {
168 Jmsg(jcr, M_INFO, 0, _("Max configured use duration exceeded. "
169 "Marking Volume \"%s\" as Used.\n"), mr->VolumeName);
170 bstrncpy(mr->VolStatus, "Used", sizeof(mr->VolStatus));
179 * Try hard to recycle the current volume
181 * Returns: on failure - reason = NULL
182 * on success - reason - pointer to reason
184 bool is_volume_valid_or_recyclable(JCR *jcr, MEDIA_DBR *mr, char **reason)
190 /* Check if a duration or limit has expired */
191 has_volume_expired(jcr, mr);
194 * Now see if we can use the volume as is
196 if (strcmp(mr->VolStatus, "Append") == 0 ||
197 strcmp(mr->VolStatus, "Recycle") == 0) {
202 * Check if the Volume is alreay marked for recycling
204 if (strcmp(mr->VolStatus, "Purged") == 0) {
205 if (recycle_volume(jcr, mr)) {
206 Jmsg(jcr, M_INFO, 0, "Recycled current volume \"%s\"\n", mr->VolumeName);
209 /* In principle this shouldn't happen */
210 *reason = "and recycling of current volume failed";
215 /* At this point, the volume is not valid for writing */
216 *reason = "but should be Append, Purged or Recycle";
219 * What we're trying to do here is see if the current volume is
220 * "recyclable" - ie. if we prune all expired jobs off it, is
221 * it now possible to reuse it for the job that it is currently
224 if ((mr->LastWritten + mr->VolRetention) < (utime_t)time(NULL)
225 && mr->Recycle && jcr->pool->recycle_current_volume
226 && (strcmp(mr->VolStatus, "Full") == 0 ||
227 strcmp(mr->VolStatus, "Used") == 0)) {
229 * Attempt prune of current volume to see if we can
230 * recycle it for use.
234 ua = new_ua_context(jcr);
235 ok = prune_volume(ua, mr);
239 /* If fully purged, recycle current volume */
240 if (recycle_volume(jcr, mr)) {
241 Jmsg(jcr, M_INFO, 0, "Recycled current volume \"%s\"\n", mr->VolumeName);
242 return true; /* Good volume */
244 *reason = "but should be Append, Purged or Recycle (recycling of the "
245 "current volume failed)";
248 *reason = "but should be Append, Purged or Recycle (cannot automatically "
249 "recycle current volume, as it still contains unpruned data)";
252 return *reason ? false : true;