- Machine Control and Guidance Products
- CMD FOR HAULING (S/N: CM41-UP; CM51-UP; AT61-UP)
- Off-Highway Truck/Tractor
- 789D (S/N: SPD1-UP)
- 793D (S/N: FDB1-UP)
- 793F (S/N: SSP1-UP; D3T1-UP; RBT1-UP)
- 797F (S/N: LAJ1-UP; LTZ1-UP)
- 793D (S/N: FDB1-UP)
Introduction
This Special Instruction demonstrates how to use the Autonomy Log Processing (ALP) Log Transfer Appliance (LTA) virtual machine (VM). This Special Instruction will explain the following usage of the Transfer Appliance:
- Powering on the Log Transfer Appliance VM
- Connecting autonomy log drives
- Disconnecting autonomy log drives after file transfer
- The Results Drive
- Preparing a Results Drive
- Connecting a Results Drive
- Disconnecting a Results Drive
- Deleting logs transferred to the results drive
- Connecting a Results Drive
- Rebooting/Powering off the Transfer Appliance
Note: Configure and set up the ALP transfer appliance and processing nodes prior to using this document.
Important Safety Information
Work safely. Most accidents that involve product operation, maintenance, and repair are caused by failure to observe basic safety rules or precautions. An accident can often be avoided by recognizing potentially hazardous situations before an accident occurs. A person must be alert to potential hazards. This person should also have the necessary training, skills, and tools to perform these functions properly.
Safety precautions and warnings are provided in this instruction and on the product. If these hazard warnings are not heeded, bodily injury or death could occur to you or to other persons. Caterpillar cannot anticipate every possible circumstance that might involve a potential hazard. Therefore, the warnings in this publication and the warnings that are on the product are not all inclusive.
When a tool, procedure, work method, or operating technique that Caterpillar does not recommend is used, ensure that you and others are safe during use. Additionally, ensure that the product will not be damaged or made unsafe by the operation, lubrication, maintenance, or repair procedures that are used.
Do not operate or work on this machine unless you have read and understand the instructions and warnings in the Operation and Maintenance Manuals. Failure to follow the instructions or heed the warnings could result in injury or death. Contact your Cat dealer for replacement manuals. Proper care is your responsibility. |
While operating in autonomous mode, the machine may move without warning. Serious injury or death may occur. Maintain a safe distance from the machine. Personnel who may need to work in the area of an autonomous machine must understand the external autonomous mode indicator lights and job site procedures. Approach the machine when conditions are safe. |
Failure to use appropriate caution while operating the machine in autonomous mode can result in a potential crushing hazard. Serious injury or death may occur. Operate in autonomous mode only in authorized access restricted autonomous operations areas. Do not approach machine with a solid blue or flashing blue autonomous mode indicator light. |
Personal injury or death can result from sudden machine movement. Sudden movement of the machine can cause injury to persons on or near the machine. Prevent possible injury by performing the procedure that follows before working on the machine. Move the machine to a smooth and level location that is away from working machines and personnel. Engage the parking brake. Stop the engine. To avoid accidental engine starting, turn the battery disconnect switch to the OFF position. Remove the key for the battery disconnect switch. Use a secure padlock in order to lock the battery compartment access door. Place a "Do Not Operate" tag at the Start/Stop switch location to inform personnel that the equipment is being worked on. |
Illustration 1 | g00037860 |
Use steps and handholds whenever you mount the machine. Use steps and handholds whenever you dismount the machine. Before you mount the machine, clean the step and the handholds. Inspect the step and handholds. Make all necessary repairs.
Face the machine whenever you mount the machine and whenever you dismount the machine. Maintain a three-point contact with the step and with handholds.
Note: Three-point contact can be both feet and one hand or a single foot and two hands.
Do not mount a moving machine. Do not dismount a moving machine. Never jump off the machine. Do not try to mount the machine when you carry tools or supplies. Do not try to dismount the machine when you are carrying tools or supplies. Use a hand line to pull equipment onto the platform. Do not use any controls as handholds when you enter the cab or when you exit the cab.
Powering the Log Transfer Appliance (LTA) Virtual Machine (VM) ON/OFF
Powering ON the LTA VM
- Open "VMware Player" on the machine hosting the ALP LTA VM. "VMware Player" should have a shortcut icon pinned to the taskbar. If not, a link is on the start menu under "All Programs > VMWare > VMWare Player".
Show/hide table
Illustration 2 g03852721 (1) "Play virtual machine" button - When "VMware Player" opens, select the VM on the left-hand side and click "Play virtual machine" button (1).
Show/hide table
Illustration 3 g03852722 ALP "Log Transfer Appliance" screen - The machine will now power on and will be ready for copying when the system boots up into the ALP "Log Transfer Appliance" screen.
Note: If the ALP copy station does not boot to this screen, then the ALP machine is most likely not configured correctly or there is another error. Refer to Special Instruction, SEHS0379, if the system does not boot to the screen in Illustration 3.
Powering OFF the LTA VM
If the machine is not in use or needs shut off, follow Steps 1through 3 for proper shut off.
- Open the "VMware Player" window select the "Player" menu button (2), then select the "Power" menu option (3), select the "Shut Down Guest" menu option (4) to shutdown the VM properly.
Show/hide table
Illustration 5 g03853090 (5) "Yes" button - If the machine asks for confirmation to power off the virtual machine, click "Yes" button.
- After the machine has shutdown and closed the program, reopen "VMware Player" following the "Powering ON the LTA VM" section of this document.
Illustration 4 | g03852843 |
(2) "Player" menu button
(3) "Power" menu option (4) "Shut Down Guest" menu option |
Copying Drives
- Plug the hard drive into the physical machine. If a message from Windows pops up saying, "You need to format the disk in drive X: before you can use it. Do you want to format it?", click "Cancel" button (1).
Show/hide table
Illustration 7 g03853107 (2) "Never show this when a new device is available" box
(3) "OK" button - If a "Removable Devices" pop-up appears in VMware Player, when the drive is plugged in. Click "OK" button (3) to close the message. This message can be disabled for all future occurrences by checking the "Never show this when a new device is available" box (2).
Show/hide table
Illustration 8 g03853109 (4) "Player" menu button
(5) "Removable Devices" menu option
(6) USB device
(7) "Connect (Disconnect from host)" menu option - Click the "Player" menu button (4) at the top left and select the "Removable Devices" menu option (5). Select the correct USB device (6) and select "Connect (Disconnect from host)" menu option (7) to attach the hard drive to the VM.
Show/hide table
Illustration 9 g03853112 (3) "OK" button - If the system asks for permission to disconnect the drive from the host computer, select the "OK" button (3). Make sure that the drive is not in use by any other activity on the computer before connecting to the VM.
Show/hide table
Illustration 10 g03853114 - After the device has been connected to the VM, some text will scroll by which is initializing the hard drive. After that, the hard drive should now be shown as connected on the ALP VM.
- Repeat Steps 1 - 5 for any other drives that will be connected for copying to the NAS.
Note: Only three autonomy log drives will be processed at a time. More than three drives can be plugged in, but the extra drives will not show up on the main screen. The Results Drive does not count as one of these three drives. This only applies to autonomy logger drives.
Illustration 6 | g03853100 |
(1) "Cancel" button |
Disconnecting Drives
Illustration 11 | g03853118 |
When drives are finished copying, a message will appear stating that the drive is safe to disconnect from the log transfer appliance. Disconnect the drive with the matching disc label.
Note: Removing the incorrect drive and removing one that is in the middle of a read/write process could potentially corrupt the hard drive and make all the data permanently lost. Confirm that the correct drive is being disconnected to prevent data loss.
LTA Results Drive
The Results Drive is a large capacity, shippable disk for moving large amounts of logs from a remote site back to Cat Product Support. When attached to the Log Transfer Appliance, logs are copied from the Network Attached Storage (NAS ) to the Results Drive. The Results Drive is shipped when full, or at a configurable interval.
The LTA will usually have a Results Drive attached and is expected. For example, with two drives per site, one drive remains at site while the other drive is shipped back to Cat Product Support.
When attached to the Log Transfer Appliance, the Results Drive will receive a compressed copy of all results. If the Results Drive is not full after a configured amount of time, then the drive will begin storing compressed copies of full incoming logs. When full the Results Drive is "closed", and made ready for physical shipment to Cat Product Support.
Note: Contact Cat Product Support for the address to ship the Results Drive to.
Determine Mount Location on OCS
- The data storage device to be formatted should NOT be connected yet. If a terminal window is not already open, open one by pressing "Ctrl + Alt + t".
Show/hide table
Illustration 12 g03853119 Terminal screen shot - In the terminal, search for the existed mounted drives using the following command. Type "mount | grep /dev/sd", then press the "Enter" key. The display should show an output similar to the illustration below . This screen will show all the currently mounted drives.
Note: The "|" symbol is a pipe character and not a lower case letter "L".
- Plug the data storage device into the OCS laptop.
If configured, a file viewer window may appear. Leave the window open, as the window can be used to show that the unmounting process has worked in the later steps.
- Determine where the drive mounted. In the terminal, search for the existing mounted drives. Type "mount | grep /dev/sd", then press the "Enter" key.
Note: Reformatting of the correct data storage device is CRITICAL.
Show/hide tableIllustration 13 g03853120 Terminal screen shot - The screen will show all the currently mounted data storage devices. The new line shown is the data storage device that needs to be formatted. Record the information on screen that appears in the boxes in Illustration 13. This information will be needed in the upcoming steps.
- Now that the mounting location has been recorded, the hard drive will need to be unmounted to begin the formatting. Type the following command to unmount the drive:
umount /media/**Data Storage Device name**
Note: **Data Storage Device name** represents the name of the device or drive name that was recorded in Step 5.
- If this Step was executed correctly, the file viewer window (if applicable) that opened automatically in Step 3 will not show the data storage device anymore. The window may even close automatically.
Run the Formatting Script
- Now that the drive is unmounted, change to the scripts directory by typing the following command:
cd ~/software/scripts/
- Type the following command to run the formatting script.
sudo ./format_logging_disk.sh –r /dev/sdX
Note: The "X" following "sd" in the command will be the drive letter that was previously recorded. Ensure that the number of the partition title is left off. "/dev/sdb1" would be entered as "/dev/sdb".
- The user will be prompted to enter a password. Now enter the root/admin password and press "Enter".
- A warning will appear on the screen asking to type "Continue" with a capital "C" to continue with the specified formatting.
Note: Ensure that the correct mount location was selected or the PC hard drive can mistakenly be formatted.
Show/hide tableIllustration 14 g03853124 Continue formatting screen - After the word "Continue", with a capital "C", is typed and if the hard drive has never been formatted with the script, the system will ask for the serial number written on the outside of the drive. Enter in the external serial number with no spaces and press "Enter".
Note: If the drive has already been given the external serial number, then this step will be skipped and the formatting will continue without any more prompts.
- Once the script returns to the command prompt, the results drive is now safe to disconnect .
Connecting the Results Drive
Note: Before proceeding, it is assumed that the results drive is configured and formatted as an ALP Result Drive.
Illustration 15 | g03853128 |
LTA menu |
When connecting the Results Drive, follow the same procedure as if connecting a normal autonomy log drive. The only difference between the two will be after the Results Drive is plugged in, the drive will show differently as it would show in the LTA menu.
Disconnecting the Results Drive
- When the results drive is full, there will be a message indicating the drive is ready to be removed.
Show/hide table
Illustration 16 g06059537 - Disconnect the results drive from the transfer appliance by unplugging the drive from the computer. Once disconnected, ship the results drive back to Cat Product Support.
Deleting the Copied Results Drive Logs (Results Manifest)
When a disk has arrived back to engineering and all the data has been copied back, the Results Manifest ID and or Manifest Word can be messaged to the remote site operator. When entered to the ALP maintenance page, it will delete the associated logs and results (clearing the space on the NAS) that are no longer needed, since the associated logs and results have been received by engineering.
Note: Do not perform these steps unless a Manifest ID or Manifest Word has been received to confirm purging data off the ALP. Improper use of this feature could result in data being removed that wasnot intendedto be purged.
- Click inside the LTA VM screen to have the keyboard enter the VM console.
Show/hide table
Illustration 17 g06059541 - Once inside the VM console, press "Alt + F3". The Maintenance Interface screen will appear.
- Type "M" and press enter to generate a diagnostic report.
Show/hide table
Illustration 18 g06059543 - Once enter has been pressed, the ALP will load the "Acknowledge Results Manifest" screen. The list will contain all the active and closed manifests of results drives. Using the provided Manifest ID or Manifest Word, enter in the matching number as shown below in green. Once the number has been typed, press enter.
Show/hide table
Illustration 19 g06059571 - A confirmation will show up. Type "Yes" with a capital "Y" and press enter. Anything but that will return back to the Maintenance Interface window.
- After enter has been pressed, the Results Manifest will delete all logs and snapshots off the NAS that have been acknowledged as being transferred back to engineering from the selected manifest. This action could take some time depending on how many logs have been deleted. After the purging of data has occurred, the ALP screen will return to the Maintenance Interface window as shown in Step 2.
- To return to the main ALP screen, press "Alt + F1".
- To pass the keyboard and mouse functions back to the host computer, press "Ctrl + Alt".
Transferring a Corrupt Log File
- Connect the logger to an appropriate power supply and to an OCS laptop using a USB cable.
- Transfer the relevant files to the OCS laptop.
Note: The file names list times in UTC time not local time.
- Transfer the files to Cat Technical Support as needed.
Resetting the Log Transfer Appliance VM
If the machine is not functioning properly, a restart of the machine may be necessary to make it work normally again.
- Open the powered on LTA VM and select the "Player" menu button (1), then select the "Power" menu option (2), then click the "Restart Guest" menu option (3) to reset the VM properly.
Show/hide table
Illustration 21 g03853131 (4) "Yes" button - If the machine asks for confirmation to reset the virtual machine, click the "Yes" button (4).
Show/hide table
Illustration 22 g03853132 "Log Transfer Appliance" screen - Wait for the machine to reboot. When the machine has fully booted, the "Log Transfer Appliance" screen will appear.
Illustration 20 | g03853130 |
(1) "Player" menu button
(2) "Power" menu option (3) "Restart Guest" menu option |
Taking a Diagnostic Report
A diagnostic report should be taken whenever an unexplained issue happens with the ALP. When a diagnostic report is generated, the ALP saves the configuration state of each ALP VM and multiple logs from each, saving the diagnostic to a zipped file for later analysis. This method allows for Cat Product Support to analyze the zipped log files later and possibly determine the root cause of the ALP issue.
Note: If the ALP LTA VM is unresponsive, there is no way for the ALP to take a diagnostic report. If the VM is still responsive but experiencing an issue, a diagnostic report should always be taken to assist with troubleshooting analysis.
- Click inside the LTA VM screen to have the keyboard enter the VM console.
Show/hide table
Illustration 23 g03853135 Normal "Maintenance Interface" screen - Once inside the VM console, press "Alt + F3". The Maintenance Interface screen will appear.
Show/hide table
Illustration 24 g03853136 VM console - Type "D" and press enter to generate a diagnostic report. The diagnostic report may take some time to generate. There will be some messages displayed at the bottom of the screen indicating which VM it is logging files from.
- Once enter has been pressed, the ALP will ask for a reason of taking the diagnostic report. Be descriptive as possible in describing what is wrong with the ALP interface so that engineering can better troubleshoot the issue. Once the description has been typed, press enter to continue.
- When the diagnostic report is finished generating, the screen will refresh and return to the normal "Maintenance Interface" screen as seen in Step 2.
- To return to the main ALP screen, press "Alt + F1".
- To pass the keyboard and mouse functions back to the host computer, press "Ctrl + Alt".
- Notify engineering that a description of what the diagnostic report was taken. Include a short description of the failed behavior and what time it was taken.
Repairing a No-Software Log Transfer Appliance VM
If any of the ALP nodes are in a no-software state, the nodes can easily be recovered by using the ALP Maintenance Interface.
- Click inside the LTA VM screen to have the keyboard enter the VM console.
Show/hide table
Illustration 25 g06059416 - Once inside the VM console, press "Alt + F3". The Maintenance Interface screen will appear. Ifanyof the "Application Versions" show as "NOT_AVAILABLE", then the ALP has entered a no-software state for that specific node. Proceed to the next step if the VM has achieved this no-software state.
Show/hide table
Illustration 26 g06059419 - Type "1" and press enter to reboot all the processing nodes. Once enter has been pressed, type "Yes" with a capital "Y" to reboot the nodes.
Show/hide table
Illustration 27 g06059423 - The ALP LTA will now reboot all the nodes. Depending on the amount of the nodes present on the ALP, the node reboot may take some time, as there is a delay between the restart of each node to prevent the no-software state of the VM’s from occurring.
Show/hide table
Illustration 28 g06059444 - Once all the machines have been sent the reboot command, the main window of the ALP Maintenance Screen will show up again. Sometimes, some of the machines may show up as "Offline". The "Offline" status is most likely because the software status check was performed before the node had finished rebooting. If this condition has occurred, proceed to the next step. If all the nodes have the same Application Version and none are in a no-software state, proceed to Step 7.
Show/hide table
Illustration 29 g06059448 - A refresh of the Maintenance Interface window will have to occur to see if the node has booted correctly to have an Application Version. To do this type "R" and press enter.
The screen will refresh with an updated query of all the nodes. If all the nodes have the same Application Version and none of theme are in the no-software state, continue to the next step. If a refresh of the Maintenance Interface window does not continue to get all the nodes with an Application Version, contact engineering to look into other possible solutions to the issue.
- To return to the main ALP screen, press "Alt + F1".
- To pass the keyboard and mouse functions back to the host computer, press "Ctrl + Alt".
Production Logger Troubleshooting
Truck or OCS Hardware
If the drive is not mounting, perform the following steps:
- Confirm the functionality of the Power Cable.
- Verify continuity of the Power Cable connections.
- Verify that the Power Cable is plugged in on both ends correctly.
Note: Unlike Orange Loggers, the Production Loggers are not powered through the USB Cable. To connect to an OCS, it needs a power supply connection of 12V.
OK - The Power Cable is functioning properly. Proceed to Test Step 2.
Note: Proper connection of Power Cable: Positive and Negative from Power Cable to Power Supply.
Not OK - The Power Cable is not functioning properly.
Repair - Confirm that both ends of the Power Cable are tightly connected. Next, swap the Power Cable with a known good cable and see if this resolves the issue.
- Confirm the functionality of the USB Cable.
- Verify continuity of the USB cable.
- Verify that the USB cable is plugged in on both ends correctly.
OK - The USB Cable is functioning properly. Proceed to Test Step 3.
Not OK - The USB Cable is not working properly.
Repair - Confirm that both ends of the USB Cable are tightly connected. Next, swap the USB with a known good cable and see if this resolves the issue.
Show/hide tableIllustration 30 g06080661 - Confirm that the drive mounted properly.
OK - The drive mounted properly and has appeared in the Disk Utility.
Repair - Format the drive.
Note: For OCS or ALP, the following commands will determine what mount levels can be seen and what the format is:
In a Terminal, execute the following command:
sudo parted –l
Note: Execute the following command for older systems (This method does not work on GPT parted systems):
sudo fdisk -l
Note: For a GUI, use the Ubuntu App: Disk Utility
After repair, verify functionality with the ALP. Proceed to Test Step 4.
Not OK - The drive did not mount properly.
The drive is faulty. Replace the production logger.
STOP.
Show/hide tableIllustration 31 g06082186 - Is the drive correctly formatted and can the drive be seen at the /dev/sd level?
OK - The drive is formatted properly and can be seen.
Note: The drive should be EXT4 format. The drive format is only compatible with Linux OS and incomputable with Windows OS.
STOP.
Not OK - The drive is not formatted properly and cannot be seen.
Repair - Format the drive and confirm that it connects properly.