5 0 0:Setting up Archive Adjustment: Difference between revisions

From SEPsesam
No edit summary
(Implemented changes for #16513 (commented out))
Line 46: Line 46:
</div>
</div>
<translate><!--T:13-->
<translate><!--T:13-->
Archive adjustment is used to make a comparison between media in the [[Special:MyLanguage/SEP_sesam_Glossary#loader|loader]] (tape library) and the SEP sesam media archive database, and performs a database synchronization with the selected loader by updating the database with the most current inventory information from the scanned device.
Archive adjustment is used to perform a comparison between the media in the [[Special:MyLanguage/SEP_sesam_Glossary#loader|loader]] (tape library) and the SEP sesam media archive database, and to perform a database synchronization with the selected loader by updating the database with the most current inventory information from the scanned device.


<!--T:14-->
<!--T:14-->
Archive adjustment is mandatory whenever the contents of your loader has changed. Typically, you need to run archive adjustment whenever new media or used media that have not yet been registered ([[Special:MyLanguage/Creating_a_Media_Event#initialization|initialized]]) by SEP sesam are inserted to identify unrecognized tapes.
Archive adjustment is mandatory whenever the contents of your loader have changed. Typically, you need to run archive adjustment whenever new media or used media that have not yet been registered ([[Special:MyLanguage/Creating_a_Media_Event#initialization|initialized]]) by SEP sesam are inserted to identify unrecognized tapes.


<!--T:15-->
<!--T:15-->
You can perform archive adjustment for a whole tape library or run the job against selected tapes only by specifying the selected segment ([[Special:MyLanguage/Setting_up_Archive_Adjustment#slot|see Slot range below]]).
You can perform archive adjustment for an entire tape library or run the job for selected tapes only by specifying the selected segment ([[Special:MyLanguage/Setting_up_Archive_Adjustment#slot|see Slot range below]]).
 
SEP sesam also supports archive adjustment with media introduction over barcode only. The option ''Adjustment by barcode only'' is shown for all libraries that have a barcode reader to quickly locate individual media by reading the barcode attached to the media. The media does not need to be loaded into a drive, which means that the process is faster and does not block all drives for backup or restore.


===={{anchor|prerequisite}}Prerequisite==== <!--T:16-->
===={{anchor|prerequisite}}Prerequisite==== <!--T:16-->
Make sure that your loaders are properly configured. If you want to use the command line to run archive adjustment, the task must include the name of the target autoloader or tape device. You should check your storage device configuration, as described in [[Special:MyLanguage/4_4_3:Configuring_a_Loader|Configuring Loaders and Drives]].
Make sure your loaders are configured correctly. If you want to run archive adjustment from the command line, the task must include the name of the target autoloader or tape device. You should check your storage device configuration, as described in [[Special:MyLanguage/4_4_3:Configuring_a_Loader|Configuring Loaders and Drives]].


===={{anchor|steps}}Steps==== <!--T:17--> </translate>
===={{anchor|steps}}Steps==== <!--T:17--> </translate>


<ol><li><translate><!--T:18-->
<ol><li><translate><!--T:18-->
From ''Main Selection'' -> '''Components''' -> '''Loaders''', select the relevant loader and click '''Archive Adjustment'''. Make sure that the target device (the loader which you want to scan) is at the top of the adjustment task.</translate><br />
From ''Main Selection'' -> '''Components''' -> '''Loaders''', select the relevant loader and click '''Archive Adjustment'''. </translate></li>
<translate><!--T:19-->
<translate><!--T:19-->
[[File:Loader_options_Beefalo_V2.jpg|link=]]</translate>
[[File:Loader_options_Jaglion_V2.jpg|link=]]</translate>
<br clear=all>
</li>
<li><translate><!--T:20-->
<li><translate><!--T:20-->
{{anchor|options}}In the ''Archive Adjustment window'', specify the required fields:</translate><br />
{{anchor|options}}In the ''Archive Adjustment window'', specify the required fields. Note that the available options depend on the loader and SEP sesam version.</translate><br />
<translate><!--T:21-->
<translate><!--T:21-->
[[File:Archive_adjustment_Beefalo_V2.jpg|link=]]</translate>
[[File:archive_adjust_loaders-options.jpg|link=]]</translate>
<br clear=all>
<br clear=all>
<ul><li><translate><!--T:22-->
<ul><li><translate><!--T:24-->
'''Media pool''': Select a media pool where you want to perform the archive adjustment. Make sure that you use this together with [[Special:MyLanguage/Setting_up_Archive_Adjustment#automatic|Automatic introduction]] enabled.</translate>
The '''Drive group''' is already selected and cannot be changed. You can select a drive from a drop-down list next to '''Drive (opt.)'''.</translate></li>
<li><translate><!--T:23-->
'''Storagepool''': Optionally, select this option, if you use an old and not recommended virtual tape library emulation from SEP sesam.</translate></li>
<li><translate><!--T:24-->
'''Drive (opt.)''': Optionally, select a drive.</translate></li>
<li><translate><!--T:25-->
<li><translate><!--T:25-->
{{anchor|slot}}'''Slot range''': You can limit synchronization to the specified loader segment by entering the number of the first and last slot.</translate></li>
{{anchor|slot}}'''Slot range''': You can limit the synchronization to the specified loader segment by entering the number of the first and last slot.</translate></li>
<li><translate><!--T:37-->
{{anchor|barcode}}'''Adjustment by barcode only''': If your loader contains a barcode reader, select this option to use it for archive adjustment of tapes in the loader. SEP sesam checks the barcodes of all tapes that are not in drives. This enables adjusting the archive while the drives are in use. SEP sesam scans only the tapes that are in slots, while the tapes in the drives are not scanned. <!--As of v. [[SEP_sesam_Release_Versions|INSERT VERSION]], you can use this option together with ''Automatic introduction'' (see below).--></translate></li>
<li><translate><!--T:36-->
'''Check label on tape. Ignore barcode labels''': Select this option if you want to scan the tape labels; every tape label is re-read and verified, while the barcode information is ignored.</translate></li>
<li><translate><!--T:26-->
<li><translate><!--T:26-->
{{anchor|automatic}}'''Automatic introduction''': Select this option to automatically add unknown media (without SEP sesam label) from the tape library to the specified media pool. Required settings:</translate>
{{anchor|automatic}}'''Automatic introduction''': Select this option if your loader does not contain a barcode reader and you want to automatically add unknown media (without a SEP sesam label) from the tape library to the specified media pool.</translate><!--<translate>As of v. [[SEP_sesam_Release_Versions|INSERT VERSION]], you can select this option together with ''Adjustment by barcode only''. In this case consider the following:</translate>
 
<ul><li><translate>This only work only if new tapes have a barcode.</translate></li>
<ol><li><translate><!--T:61-->
<li><translate>The later initialization only works if:
Select the relevant tape type by choosing it from the '''Tape type''' drop-down list.</translate></li>
** the tape is empty (there is no SEP sesam label on it)
 
** the tape has a SEP sesam label that is not already in SEP sesam DB. In this case, it will be overwritten with the requested label.</translate> --></li></ul>
<li><translate><!--T:27-->
<li><translate><!--T:22-->
Select the preferred way for '''Handling of unknown SEP sesam media'''. <br />Selecting '''''Automatic introduction''''' will overwrite all tape media which do not have a SEP sesam tape label stored on the tape. However, for tape media with existing SEP sesam label, the following applies:</translate>
'''Media pool''': Select a media pool where you want to perform archive adjustment.</translate>
<li><translate><!--T:61--> If you have selected <!-- only -->the option '''Automatic introduction''', select the appropriate tape type using the '''Tape type''' drop-down list. Then set the following:</translate></li>
<ol><li><translate><!--T:27-->
Select the preferred way for '''Handling of unknown SEP sesam media'''. <br /> All tape media that do not have a SEP sesam tape label stored on the tape will be overwritten. However, for tape media with an existing SEP sesam label, the following applies:</translate>
<ul><li><translate><!--T:62-->
<ul><li><translate><!--T:62-->
If the label is already stored in the SEP sesam DB (media table), the tape remains untouched.</translate></li>
If the label is already stored in the SEP sesam DB (media table), the tape remains untouched.</translate></li>
Line 91: Line 94:
If the SEP sesam tape label is ''unknown'', the tape handling depends on the following options:</translate>
If the SEP sesam tape label is ''unknown'', the tape handling depends on the following options:</translate>
<ul><li><translate><!--T:28-->
<ul><li><translate><!--T:28-->
By default, '''''Accept without initialization''''' is enabled. With this option enabled, if a tape with unknown SEP sesam label (which is not in the SEP sesam DB) is retrieved, for example, a tape from another SEP sesam Server, it will be automatically inserted. Note that such tapes are simply added to the SEP sesam DB without providing any metainformation about their content.</translate>
'''''Accept without initialization''''' is enabled by default. This means that if a tape with unknown SEP sesam label (which is not in SEP sesam DB) is retrieved, e.g., a tape from another SEP sesam Server, it will be automatically inserted. Note that such tapes are simply added to the SEP sesam DB without providing meta information about their contents.</translate>
 
<li><translate><!--T:32-->
<li><translate><!--T:32-->
If you select '''''Overwrite''''', a tape with unknown SEP sesam label (which is not in the SEP sesam DB) is initialized and added to the selected media pool.</translate></li>
If you select '''''Overwrite''''', a tape with unknown SEP sesam label (which is not in SEP sesam DB) will be initialized and added to the selected media pool.</translate></li>
</ul></li></ul></li><translate><!--T:66-->
</ul></li></ul></li><translate><!--T:66-->
Note that tape media from competitive manufacturer are not recognized and will be overwritten.</translate></ol></li>
Note that tape media from competing manufacturers are not recognized and will be overwritten.</translate></ol></li>
 
</ul>
<li><translate><!--T:36-->
'''Check label on tape''': Optionally, enable this if you want to scan the tape labels; every tape label is re-read and verified, while the barcode information is ignored.</translate></li>
<li><translate><!--T:37-->
'''Adjustment by barcode only''': Optionally, select this if you want SEP sesam to check the barcodes of all tapes which are not in drives. This enables you to adjust the archive while the drives are in use. SEP sesam scans only the tapes which are in slots, while the tapes in the drives are not scanned.</translate></li></ul>
<li><translate><!--T:38-->
<li><translate><!--T:38-->
Click '''Start'''.</translate></li></ol>
Click '''Start'''.</translate></li></ol>


<translate><!--T:39-->
<translate><!--T:39-->
Your archive adjustment starts immediately. SEP sesam will unload all drives for archive adjustment. If a drive is in use, for example, for backup or restore, archive adjustment will start when the drives are no longer used by another process.  
Your archive adjustment starts immediately. If you selected the option ''Automatic introduction'', SEP sesam will unload all drives for archive adjustment. If a drive is in use, e.g., for a backup or restore, archive adjustment will start as soon as the drives are no longer used by another process.  


<!--T:40-->
<!--T:40-->
Line 112: Line 110:


<!--T:41-->
<!--T:41-->
Alternatively, you can use a command event for setting up automatic archive adjustment. For details, see [[Special:MyLanguage/FAQ#automatic_archive_adjustment|How to set up automatic archive adjustment]].  
Alternatively, you can use a command event to set up automatic archive adjustment. For details, see [[Special:MyLanguage/FAQ#automatic_archive_adjustment|How to set up automatic archive adjustment]].  


===={{anchor|example}}Adding SEP sesam labeled tapes to a new or a different media pool==== <!--T:67-->     
===={{anchor|example}}Adding SEP sesam labeled tapes to a new or different media pool==== <!--T:67-->     


<!--T:43-->
<!--T:43-->
If you want to use already labeled tapes in a new or a different media pool, proceed as follows:</translate>
If you want to use already labeled tapes in a new or another media pool, proceed as follows:</translate>


<ol><li><translate><!--T:44-->
<ol><li><translate><!--T:44-->
From ''Main Selection'' -> '''Components''' ->  '''Media''', double-click the relevant media and click '''Delete Media'''. Note that all metadata from the tape is deleted and the tape entry is removed from the media table.</translate><br />
From ''Main Selection'' -> '''Components''' ->  '''Media''', double-click the relevant media and click '''Delete Media'''. Note that all metadata of the tape is deleted and the tape entry is removed from the media table.</translate><br />
<translate><!--T:45-->
<translate><!--T:45-->
[[File:Archive_adjustment_delete_media_Beefalo_V2.jpg|820px|link=]]</translate>
[[File:delete_media_Jaglion_V2.jpg|550px|link=]]</translate>
<br clear=all>
<br clear=all>
</li>
</li>
<li><translate><!--T:46-->
<li><translate><!--T:46-->
Start archive adjustment by using the option '''Automatic introduction''' together with '''Overwrite''' ([[Special:MyLanguage/Setting_up_Archive_Adjustment#automatic|see above steps]]). The tapes are initialized again with a new label for the selected media pool.</translate></li>
Start archive adjustment by using the option '''Automatic introduction''' together with '''Overwrite''' ([[Special:MyLanguage/Setting_up_Archive_Adjustment#automatic|see above steps]]). The tapes are reinitialized with a new label for the selected media pool.</translate></li>


{{<translate><!--T:47-->
{{<translate><!--T:47-->
Note</translate>|<translate><!--T:48-->
Note</translate>|<translate><!--T:48-->
By overwriting the existing label, all data on the tape is deleted.</translate>}}</ol>
Overwriting the existing label will erase all data on the tape.</translate>}}</ol>


<translate>==={{anchor|media_event}}Creating a media event for archive adjustment=== <!--T:49-->
<translate>==={{anchor|media_event}}Creating a media event for archive adjustment=== <!--T:49-->


<!--T:50-->
<!--T:50-->
By creating a special media event for archive adjustment, you can schedule it to run automatically in specified intervals or set up an archive adjustment template which you can use to start it interactively.  
By creating a special media event for archive adjustment, you can schedule it to run automatically at specific intervals or set up an archive adjustment template that lets you start it interactively.  


===={{anchor|steps_media}}Steps==== <!--T:51--></translate>  
===={{anchor|steps_media}}Steps==== <!--T:51--></translate>  


<ol><li><translate><!--T:52-->
<ol><li><translate><!--T:52-->
From ''Main Selection'' -> '''Scheduling''' -> '''Schedules''', select the schedule to which you want to link the event, select '''New''' and then  '''New Media Event'''. A schedule is opened with a new tab ''Parameter''.</translate></li>
From ''Main Selection'' -> '''Scheduling''' -> '''Schedules''', select the schedule you want to associate the event with, select '''New''', and then  '''New Media Event'''. A schedule is opened with a new tab ''Parameter''.</translate></li>
<li><translate><!--T:53-->
<li><translate><!--T:53-->
Under the ''Media action'', select '''Archive adjustment'''.</translate></li>
Under the ''Media action'', select '''Archive adjustment'''.</translate></li>
Line 151: Line 149:
</li>
</li>
<li><translate><!--T:56-->
<li><translate><!--T:56-->
You can start archive adjustment immediately, from '''Activities''' -> '''Immediate Start''' -> '''Media Action'''. For details, see [[Special:MyLanguage/4_4_3_Beefalo:Activities#media_action|Immediate start of a media action]].</translate></li></ol>  
You can start the archive adjustment immediately via '''Activities''' -> '''Immediate Start''' -> '''Media Action'''. For details, see [[Special:MyLanguage/4_4_3_Beefalo:Activities#media_action|Immediate start of a media action]].</translate></li></ol>  
   
   
<noinclude><translate><div class="noprint">
<noinclude><translate><div class="noprint">

Revision as of 19:32, 11 August 2022

Other languages:
Template:Copyright SEP AG en
Docs latest icon.png Welcome to the latest SEP sesam documentation version 4.4.3 Beefalo/5.0.0 Jaglion. For previous documentation version(s), check Documentation archive.


Overview

Archive adjustment is used to perform a comparison between the media in the loader (tape library) and the SEP sesam media archive database, and to perform a database synchronization with the selected loader by updating the database with the most current inventory information from the scanned device.

Archive adjustment is mandatory whenever the contents of your loader have changed. Typically, you need to run archive adjustment whenever new media or used media that have not yet been registered (initialized) by SEP sesam are inserted to identify unrecognized tapes.

You can perform archive adjustment for an entire tape library or run the job for selected tapes only by specifying the selected segment (see Slot range below).

SEP sesam also supports archive adjustment with media introduction over barcode only. The option Adjustment by barcode only is shown for all libraries that have a barcode reader to quickly locate individual media by reading the barcode attached to the media. The media does not need to be loaded into a drive, which means that the process is faster and does not block all drives for backup or restore.

Prerequisite

Make sure your loaders are configured correctly. If you want to run archive adjustment from the command line, the task must include the name of the target autoloader or tape device. You should check your storage device configuration, as described in Configuring Loaders and Drives.

Steps

  1. From Main Selection -> Components -> Loaders, select the relevant loader and click Archive Adjustment.
  2. Loader options Jaglion V2.jpg
  3. In the Archive Adjustment window, specify the required fields. Note that the available options depend on the loader and SEP sesam version.
    Archive adjust loaders-options.jpg
    • The Drive group is already selected and cannot be changed. You can select a drive from a drop-down list next to Drive (opt.).
    • Slot range: You can limit the synchronization to the specified loader segment by entering the number of the first and last slot.
    • Adjustment by barcode only: If your loader contains a barcode reader, select this option to use it for archive adjustment of tapes in the loader. SEP sesam checks the barcodes of all tapes that are not in drives. This enables adjusting the archive while the drives are in use. SEP sesam scans only the tapes that are in slots, while the tapes in the drives are not scanned.
    • Check label on tape. Ignore barcode labels: Select this option if you want to scan the tape labels; every tape label is re-read and verified, while the barcode information is ignored.
    • Automatic introduction: Select this option if your loader does not contain a barcode reader and you want to automatically add unknown media (without a SEP sesam label) from the tape library to the specified media pool.
  4. Media pool: Select a media pool where you want to perform archive adjustment.
  5. If you have selected the option Automatic introduction, select the appropriate tape type using the Tape type drop-down list. Then set the following:
    1. Select the preferred way for Handling of unknown SEP sesam media.
      All tape media that do not have a SEP sesam tape label stored on the tape will be overwritten. However, for tape media with an existing SEP sesam label, the following applies:
      • If the label is already stored in the SEP sesam DB (media table), the tape remains untouched.
      • If the SEP sesam tape label is unknown, the tape handling depends on the following options:
        • Accept without initialization is enabled by default. This means that if a tape with unknown SEP sesam label (which is not in SEP sesam DB) is retrieved, e.g., a tape from another SEP sesam Server, it will be automatically inserted. Note that such tapes are simply added to the SEP sesam DB without providing meta information about their contents.
        • If you select Overwrite, a tape with unknown SEP sesam label (which is not in SEP sesam DB) will be initialized and added to the selected media pool.
    2. Note that tape media from competing manufacturers are not recognized and will be overwritten.
  6. Click Start.

Your archive adjustment starts immediately. If you selected the option Automatic introduction, SEP sesam will unload all drives for archive adjustment. If a drive is in use, e.g., for a backup or restore, archive adjustment will start as soon as the drives are no longer used by another process.

You can also set up a special media event for archive adjustment and schedule it to run automatically, as described in the following section.

Alternatively, you can use a command event to set up automatic archive adjustment. For details, see How to set up automatic archive adjustment.

Adding SEP sesam labeled tapes to a new or different media pool

If you want to use already labeled tapes in a new or another media pool, proceed as follows:

  1. From Main Selection -> Components -> Media, double-click the relevant media and click Delete Media. Note that all metadata of the tape is deleted and the tape entry is removed from the media table.
    Delete media Jaglion V2.jpg
  2. Start archive adjustment by using the option Automatic introduction together with Overwrite (see above steps). The tapes are reinitialized with a new label for the selected media pool.
  3. Information sign.png Note
    Overwriting the existing label will erase all data on the tape.

Creating a media event for archive adjustment

By creating a special media event for archive adjustment, you can schedule it to run automatically at specific intervals or set up an archive adjustment template that lets you start it interactively.

Steps

  1. From Main Selection -> Scheduling -> Schedules, select the schedule you want to associate the event with, select New, and then New Media Event. A schedule is opened with a new tab Parameter.
  2. Under the Media action, select Archive adjustment.
  3. Under Parameter, specify the relevant options for archive adjustment (Loader, Media Pool, Drive, etc.), as described above.
    Click OK.
    Media event archive adjustment Beefalo V2.jpg
  4. You can start the archive adjustment immediately via Activities -> Immediate Start -> Media Action. For details, see Immediate start of a media action.