Processes available for manually transferring the TrueSight Capacity Optimization (TSCO) Agent capacity planning data from the Perform remote agent server to the TSCO Gateway Server console server when manager run does not successfully transfer the data. NOTE: This Knowledge Article was originally published as Resolution 210290.
|
Section I: Linux Gateway Server Console Options There are three options available to recover from a failed data transfer:
Option A: Re-run the [date]-[date].XferData scriptThis recovery path can be triggered via the Gateway Manager UI by selecting Gateway Manger -> Status /Recover Runs -> Select run -> Click the 'Recover' button. Selecting that option in the UI will then trigger the XferData script execution described below.The [date]-[date].XferData script supports a new '-r' recovery option to allow it to automatically recover failed data transfer and initiate data processing. If the *.XferData script is being kept in the Manager Output Directory (not automatically deleted) after the Manager run completes it can be re-run to re-transfer and then execute re-processing for the Manager run. For example, to re-try data transfer for the Manager run in the '/bmc/perform/manager/run1/Mar-16-2008.15.16' Manager Output Directory for the April 24th 00:00 - 23:59 Manager run: /bmc/perform/manager/run1/Mar-16-2008.15.16/Apr-23-2008.00.00-Apr-23-2008.23.59.XferData -r &
INFO: Thu Apr 24 13:06:13 CDT 2008 XferData Starting UDRCollectManager in recovery mode. udrCollectMgr: manager run was initiated INFO: Thu Apr 24 13:06:13 CDT 2008 XferData Recovery RC=0, Run is initiated.. INFO:Thu Apr 24 13:06:14 CDT 2008 XferData recovery started. udrCollectMgr: time is expired for manager run udrCollectMgr: manager run is registered and complete for date specified The [date]-[date].XferData script will initiate udrCollectMgr processes to handle the data transfer and then once the transfer phase is complete it will initiate the [date]-[date].ProcessDay script to re-process the data. Option B: Use the UCM Command Line UtilityTo recover failed data transfer using the UCM command line executable: $BEST1_HOME/bgs/bin/udrCollectMgr -b /usr/adm/best1_default -d MM-DD-YYYY -v /path/name.vcmds -r
For example: $BEST1_HOME/bgs/bin/udrCollectMgr -b /usr/adm/best1_default -d 04-23-2005 -v /home2/best1data/files/topgun_daily.vcmds -r
The -r parameter restarts Manager runs that have been aborted, or runs that are already complete. Specify this option along with the required run date and the script file name (VCMDS), which identifies the run. The '-r' recovery parameter can be replaced with a '-R' forced recovery option which is able to recover an additional set of failed data transfers where the TSCO Gateway Server never sent the data collection request but the data is available on the TSCO Agent side due to the 'Days in Advance' data collection. When run after the run has finished (so in transfer recovery mode) the command will only attempt to re-transfer data from the nodes defined as part of the specified Manager run that failed to transfer data previously. It will not attempt to re-transfer data from nodes that already successfully sent their data to the console. Option C: Transfer the data using the best1collectTransfer the data using the best1collect command from the command line. However, this method requires that you know a good deal about exactly where the data resides on the remote computer.The following is an example of the command: $BEST1_HOME/bgs/scripts/best1collect -n [NODENAME] -B [BEST1_COLLECT_HOME] -d [REMOTE_DATA_REPO] -D [MANAGING_NODE_DATA_REPO] -b [DATE_TIME_STAMP_DIR] -p PULL_DELETE
$BEST1_HOME; Generally specified as /usr/adm/BEST1_V.V.VV, where V.V.VV is the product version number -n NODENAME; The hostname of the agent node -B BEST1_COLLECT_HOME; Generally specified as /usr/adm/best1_V.V.VV. -D MANAGING_NODE_DATA_REPO; The data repository on the managing node (where you want the data to end up) -b DATE_TIME_STAMP_DIR; The date/time stamp directory where the data resides on the agent node. This is in the format Mmm-dd-yyyy.hh.mm - for Manager run started data collection, hh.mm will typically be '00.00' (midnight). -p PULL_DELETE; The type of data transfer to use. The PULL_DELETE is the best option and is the standard transfer mechanism used by the nightly Manager runs. The following is an example of the command that would transfer the data from a UNIX agent computer that would transfer data from the default agent repository directory on the agent computer topgun to the /best1data directory on the managing node: > $BEST1_HOME/bgs/scripts/best1collect -n topgun -B /usr/adm/best1_20.02.00 -D /best1data -b Sep-23-2004.00.00 -p PULL_DELETE
For a Windows agent computer, use the same parameters but specify Windows paths instead, as shown in the following example: > $BEST1_HOME/bgs/scripts/best1collect -n winmachine -B "C:\\Program Files\\BMC Software\\PATROL3\\BEST1\\20.02.00" -D /best1data -b Sep-23-2004.00.00 -p PULL_DELETE
For Windows, make sure that if there are spaces in the paths that the command line parameter is enclosed in double-quotes (as in the example above). Also ensure that the directory separators are specified as two backslashes, not a single backslash. Option D: Manually transfer the dataTransfer the UDR data using an external transfer tool if necessary.Section II: Windows Gateway Server ConsoleThe TSCO Gateway Server Manager on the Windows managing console assumes that the data is already present on the managing node when executing a Manager run that uses the Use existing data option. Therefore, you need to use another method to get the data to the managing node before running Manager again to reprocess the data.
Option A: Use the 'Recover' option in the TSCO Gateway Manager UI GUIA recovery request for a Manager run can be triggered under Administration -> Gateway Manager -> Gateway Operations -> Status/Recover Runs. Selecting the desired Manager run(s) to recover and clicking the 'Recover' button will attempt to recover data transfer and data processing for the run.Option B: Using the UCM Command Line UtilityTo recover failed data transfer using the UCM command line executable: "%BEST1_HOME%\bgs\bin\udrCollectMgr" -b "%BEST1_HOME%" -d MM-DD-YYYY -v X:\path\name.msf -r
The -r parameter restarts Manager runs that have been aborted, or runs that are already complete. Specify this option along with the required run date and the script file name (VCMDS), which identifies the run. When run after the run has finished (so in transfer recovery mode) the command will only attempt to re-transfer data from the nodes defined as part of the specified Manager run that failed to transfer data previously. It will not attempt to re-transfer data from nodes that already successfully sent their data to the console. Option C: Using the Collect Data WizardThe Collect Data Wizard includes functionality to transfer this type of data in this type of situation.Step 1
Start the Collect Data Wizard by choosing Start => Programs => BMC PATROL => Perform => Collect Data. Step 2
The Collect Data Wizard window is displayed. Click the Start a collect process on a Console or Agent computer option (the icon shows a green traffic light). Step 3
Click Next on the Welcome to the Collect Wizard window. Step 4
The Select the Collection Mode window is displayed. Click Standard Mode, and then click Next. Step 5
The Select Computers window is displayed. On this window there are two options. a. Select the Agent computer or network address radio button, and in the edit box, type in the list of computers from which to transfer data, separated by commas. b. Alternately, if the list of computers is long, create a text file (using a text editor such as Notepad) that contains a list of all the computers from which you want to transfer data. This text file should contain a list of computers, with one computer name on each line in the text file. Once the text file is created, Choose the Select a file that contains the computers to collect radio button and then either type the full path to the file into its edit box, or click the Browse button to browse to the file. NOTE: The agent nodes must have the same remote data repository path for the text file method to work. Step 7
In the Repositories and Actions window, fill in the following three edit boxes: a. Top box: The directory on the managing computer where the data should be transferred. b. Middle box: Where does the data reside on the agent computer (it needs to be the same for all computers). c. Bottom box, choose the data transfer type. The options are Pull data or Push data. Step 8
Click the Next button. Step 9
The Data Collection Frequency window is displayed. Enter how frequently you want the data collected, summarized, and saved. Click Next. Step 10
The Collection Schedule window is displayed. In the Begin and End by Date and Time section, enter the date and time that corresponds to the date/time stamp directory of the data on the remote computer. Manager passes this directory from the managing computer so it will be the same on all remote computers (if Manager initially collected the data). Step 11
Click the Next button. Step 12
The Completing the Collect wizard window is displayed. This lists the command that is going to be run. Click Finish here to get back to the main collect data window. Step 13
The messages generated by the transfer will appear in the messages window. Check each computer and make sure that the message Request was completed successfully on node: [nodename] was generated. For each computer that failed to transfer the data, it may be necessary to try a different transfer type (such as PULL instead of PUSH) or to manually transfer the data.
Section III: General Manager OptionGeneral Manager coordinates and controls Manager runs by integrating multiple BMC Performance Assurance consoles on UNIX and Windows hosts under a single umbrella. Step 1
Do one of the following:
Step 2
Click Recover Runs option. Step 3
Select a Manager console or [All] option. Step 4
Under Recover Manager Runs, click the Summary tab. Step 5
To filter the list of runs, select a Console, Manager Run, or, in the Manager Run Filter, type a string, and then click the filter icon. Step 6
To sort the list of runs, click one of the following table column headers: Run Name, Run Date, Status, Console, or Last Recovered. Step 7
To view detailed status, and completion information on recovered runs, click the Detail tab. Step 8
Select one or more runs. Step 9
Click Recover. Related Products:
|