Edit
Attach
P
rintable
r3 - 2017-07-28 - 20:19:54 - Main.pboney
You are here:
TWiki
>
Deployment Web
>
DeploymentInstallingUpgradingAndMigrating
>
BackupCLM
>
DngJfsIndexBackup
<div id="header-title" style="padding: 10px 15px; border-width:1px; border-style:solid; border-color:#FFD28C; background-image: url(<nop>https://jazz.net/wiki/pub/Deployment/WebPreferences/TLASE.jpg); background-size: cover; font-size:120%"> ---+!! Backup and restoration of Jazz Foundation Service index files for Rational DOORS Next Generation %DKGRAY% Authors: Main.PaulBoney<br> Build basis: Rational DOORS Next Generation 4.0+ %ENDCOLOR%</div></sticky> <!-- Page contents top of page on right hand side in box --> <sticky><div style="float:right; border-width:1px; border-style:solid; border-color:#DFDFDF; background-color:#F6F6F6; margin:0 0 15px 15px; padding: 0 15px 0 15px;"> %TOC{title="Page contents"}% </div></sticky> <sticky><div style="margin:15px;"></sticky> This document outlines the preferred steps for creating and restoring backup files of the Jazz Foundation Service (JFS) that are used by Rational DOORS Next Generation. These steps must be performed by the server administrator. Using a Rational DOORS Next Generation repository tools (repotools) command, you can create an archive of the indexes and save it to a location of your choice. This backup process is performed online while the server is running. If the JFS indexes ever get corrupted, you can use offline repotools commands to restore and synchronize the indexes from the backup file. Note that this process is for creating and restoring backups of the JFS indexes only; it will not create a backup of the Rational DOORS Next Generation database. For detailed information on performing a full backup, see [[BackupCLM][BackupCLM]] <br> ---++ Quick Reference The following steps provide an overview of the repository tools commands that are required to backup and restore the Rational DOORS Next Generation JFS indexes for version 4.0 and later. For detailed information about these commands, refer to the relevant sections of this document. ---++++ Online Backup _repotools-rm -backupJFSIndexes adminUserID=<your JTS admin ID> adminPassword=<your JTS admin password> toFile=<fully-qualified output filename>_ ---++++ Offline Restore _repotools-rm -restoreJFSIndexes fromFile=<fully-qualified filename of backup file>_ ---++++ Synchronization _repotools-rm -synchronizeJFSIndexes teamserver.properties=<fully-qualified path to teamserver.properties file>_ <br> ---++ Creating a backup of JFS indexes in Rational DOORS Next Generation 4.0+ As of version 4.0, server administrators can use a repotools command to create a backup of the JFS index files while the server is online. ---+++ The repotools location Repository tools command-line reference (repotools) is included with Rational DOORS Next Generation and is available at the installed server location. In a typical installation, the repotools scripts are found at _<server install directory>/server/repotools-rm_. <br><br> For more information on how to run repotools commands, and to view a list of available commands, see the [[https://www.ibm.com/support/knowledgecenter/SSYMRC_6.0.5/com.ibm.jazz.install.doc/topics/c_repotools_overview.html][Repository tools command-line reference]] topic in the online help. ---+++ Backup command To start the online backup of the JFS indexes, run the following repotools command:<br> _repotools-rm -backupJFSIndexes adminUserID=<your JTS admin ID> adminPassword=<your JTS admin password> toFile=<fully-qualified output filename>_ <br><br> Example:<br> _repotools-rm -backupJFSIndexes adminUserID=admin adminPassword=adminPass toFile=C:\backup\myBackup.zip_ <br><br> Note that while the backup is in progress, the server might appear sluggish or unresponsive to users. Also note that write processes to the indexes are queued and are run when the backup is complete. After the process is finished, the generated backup file is available in the location that you specified in the toFile command parameter.<br><br> For more information, see the [[https://www.ibm.com/support/knowledgecenter/SSYMRC_6.0.4/com.ibm.jazz.repository.web.admin.doc/topics/t_jfs_backup.html][Repository tools command to back up Jazz Foundation Service indexes]] topic in the online help. <br> ---++ Restoring JFS indexes from a backup file in Rational DOORS Next Generation 4.0+ There are two steps to restoring the JFS indexes from a backup file by using the repository tools commands:<br> 1. Restore the indexes by running the restoreJFSIndexes command.<br> 2. Synchronize the indexes by running the synchronizeJFSIndexes command.<br><br> Note that backup files that are more than 90 days old can not usually be restored. ---+++ Restore command The restoreJFSIndexes command is used to restore the JFS indexes from a backup file that was created by using the backupJFSIndexes command. The restore command must be run within 90 days from when the backup file was captured. In the event a database restore is also being performed, the index backup being restored must not be ahead of the database.<br><br> To restore the index, stop the server and run the following repotools command:<br> _repotools-rm -restoreJFSIndexes fromFile=<fully-qualified filename of backup file>_ <br><br> Example:<br> _repotools-rm -restoreJFSIndexes fromFile=C:\backup\myBackup.zip_ <br><br> For more information, see the [[https://www.ibm.com/support/knowledgecenter/SSYMRC_6.0.4/com.ibm.jazz.install.doc/topics/r_repotools_restorejfsindexes.html][Repository tools command to restore Jazz Foundation Service indexes from a backup file]] topic in the online help. ---+++ Synchronize command The synchronizeJFSIndexes command is used to synchronize the JFS indexes and the full text indexes with the resources in the database. It updates older indexes to the same level as the current one. <br><br> To synchronize the indexes, run the following repotools command:<br> _repotools-rm -synchronizeJFSIndexes teamserver.properties=<fully-qualified path to teamserver.properties file>_ <br><br> Example:<br> _repotools-rm -synchronizeJFSIndexes teamserver.properties=C:\myJTSInstall\server\conf\rm\teamserver.properties_ <br><br> For more information, see the [[https://www.ibm.com/support/knowledgecenter/SSYMRC_6.0.4/com.ibm.jazz.install.doc/topics/r_repotools_synchronizejfsindexes.html][Repository tools command to synchronize JFS indexes with database]] topic in the online help. <br><br> ---+++++!! Related topics: [[BackupCLM][BackupCLM]] ---+++++!! External links: * [[https://www.ibm.com][IBM]] <sticky></div></sticky>
Edit
|
Attach
|
P
rintable
|
V
iew topic
|
Backlinks:
We
b
,
A
l
l Webs
|
H
istory
:
r5
<
r4
<
r3
<
r2
<
r1
|
More topic actions...
Deployment
Deployment web
Planning and design
Installing and upgrading
Migrating and evolving
Integrating
Administering
Monitoring
Troubleshooting
Community information and contribution guidelines
Create new topic
Topic list
Search
Advanced search
Notify
RSS
Atom
Changes
Statistics
Web preferences
NOTE: Please use the Sandbox web for testing
Status icon key:
To do
Under construction
New
Updated
Constant change
None - stable page
Smaller versions of status icons for inline text:
Copyright © by IBM and non-IBM contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our
Terms of Use.
Please read the following
disclaimer
.
Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more
here
.