AQUILATM ComManager3 ; MachineManager3 Caterpillar

The following procedures are required to set up the server operations for the ComManager application:

• Configure ComManager.

• Test the machines that have been configured.

• Restart ComManager.

• Configure ComManager to run as a User.

Configuring ComManager

The ComManager application can be started by using the Windows Start menu.

Show/hide table



Illustration 1	g01400220

1. Click "Start".

2. Click "Programs". Refer to Illustration 1.

3. Click "Aquila". Refer to Illustration 1.

Show/hide table



Illustration 2	g01400222

4. Click "ComManager".

5. Click "ComManager Config". Refer to Illustration 2. The "ComManager config" screen that is shown in Illustration 3 appears.

"ComManager config" Screen

The "ComManager config" screen contains the six sections that are listed below:

Illustration 3	g01400671
(1) "Aquila root folder" (2) "Dial-up settings" (3) "Production Download Times" (4) "Machines" (5) "Protocol options" (6) "Tasks"

Aquila Root Folder

The "Aquila root folder" section (1) contains the location of the Aquila root folder. Refer to Illustration 3.

Illustration 4	g01400674
(7) "Browse" button

Click the "Browse" button (7) in order to locate the folder in your computer.

The Aquila root folder specifies the base path that is used for storing in-pit configuration data and in-pit machine data.

ComManager uses this folder for storing the following information for the in-pit machines:

• "Productivity" files

• Status of the machines

• Maps of the machines

The MachineManager program and the ComManager program must be configured to use the same Aquila root folder.

Two examples for specifying the name of the folder follow:

• C:\Aquila Root

• C:\Aquila Data

Note: The Aquila root folder can be a drive on the network. The MachineManager program must have sufficient privileges in order to access this folder over a network. The privileges are required in order to perform the following: and

• Send a file.

• Receive a file.

Dial-up Settings

The "Dial-up settings" section (2) is used if you are using a Freewave modem. Refer to Illustration 3.

Show/hide table



Illustration 5	g01400680
(8) "Dial-up to machines with Freewave modems" check box (9) "Freewave serial port" drop-down menu

1. Select the "Dial-up to machines with Freewave modems" box (8). A check mark will appear in the box.

2. Click on the "Freewave serial port" drop-down menu (9). Refer to Illustration 5.

3. Select the port that is used by the Freewave modem.

Production Download Times

The "Production Download Times" section (3) is used in order to specify the times during the day when ComManager should automatically download production files. Refer to Illustration 3.

Illustration 6	g01400681
(10) "Add" button (11) "Edit" button (12) "Remove" button

The following buttons are in this section:

(10) "Add" - Add a time to the list.

(11) "Edit" - Edit an existing time in the list.

(12) "Remove" - Remove a time from the list.

1. Click on the "Add" button (4) in order to enter a time. Refer to Illustration 6. The "Enter download time" dialog that is shown in Illustration 7 appears.

Show/hide table



Illustration 7	g01400252
(13) Field for entering time (14) "Ok" button

2. Enter the time for the download in the field (13) at the bottom of the dialog. The time is entered in a "24-hour" format. Use the hh:mm syntax for the time.

   Enter a value of 00 through 23 for the hh (hours). Enter a value of 00 through 59 for the "mm" (minutes).

   Three examples follow:

   • 7:30 a.m. = 07:30

   • 3:30 p.m. = 15:30

   • 12:00 p.m. = 00:00 (midnight)

3. Click the "Ok" button (14). Refer to Illustration 7. The time is added to the list. The dialog closes.

Machines

The "Machines" section (4) is used to specify the in-pit machines that are communicating with ComManager. Refer to Illustration 3.

Illustration 8	g01400682
(15) "Add" button (16) "Edit" button (17) "Test and Configure machine" button (18) "Remove" button

The following buttons are in this section:

(15) "Add" - Add a machine to the list.

(16) "Edit" - Edit an existing machine in the list.

(17) "Test and Configure machine" - Test a machine that has been added to the list. Refer to "Testing the Machines".

(18) "Remove" - Remove a machine from the list.

1. Click on the "Add" button (15) in order to add a machine to the list. Refer to Illustration 8. The "Add/Update machine" dialog that is shown in Illustration 9 appears.

Show/hide table



Illustration 9	g01400265
(19) "Machine Type" field (20) "Machine Name" field (21) "IP Address" field (22) "Freewave Serial (if applicable)" field (23) "Freewave Repeaters (if applicable)" field (24) "Ok" button

2. Enter the information about the machines.

   (19) "Machine Type" - Specify the type of machine. The choices are "Drill" or "Dragline".

   (20) "Machine Name" - Enter the name of the machine. An example is "Drill 001".

   (21) "IP Address" - Enter the IP address of the machine. An example is "192.168.10.10".

   (22) "Freewave Serial (if applicable)" - Enter the serial number of the Freewave modem.

   (23) "Freewave Repeaters (if applicable)" - Specify the list of repeaters that will be used in order to establish communications between the officeFreewave radio and the onboard radio. The repeaters are specified as a string of numbers. The numbers represent the call book entries on the office Freewave radios. Use the letter "A" in order to specify no repeaters. An example of a string follows:

   A31 - This string indicates that you would contact the following repeaters: <no repeaters> <repeaters used in call book entry 3> <repeaters used in call book entry 1>

   Note: The "Freewave Serial" field and the "Freewave Repeaters" field are used only if the machine is using a Freewave modem.

3. Click the "Ok" button (24). Refer to Illustration 9. The machine is added to the list. The dialog closes.

Protocol Options

The "Protocol options" section (5) is used to set up the communications for the application. Refer to Illustration 3.

Illustration 10	g01400686
(25) "Listen port" field (26) "FTP Timeout" field (27) "Connection Timeout" field (28) "Remote EXEC Timeout" field (29) "Username" field (30) "Password" field (31) "Confirm Password" field

Enter the information about the communications:

(25) "Listen port" - Enter the TCP port that is used by ComManager for incoming MachineManager connections. Caterpillar recommends using the 11235 port. This is the default port.

(26) "FTP Timeout" - Enter the amount of seconds before an FTP data transfer from the machines fails.

(27) "Connection Timeout" - Enter the amount of seconds in order to establish an FTP/Remote Exec connection. If this time is exceeded, then the task will fail.

(28) "Remote EXEC Timeout" - Enter the number of seconds in order to wait while a remote command is processed on an in-pit machine. This delay is used for the following:

• Obtaining the status of the machine

• Changing the onboard status

• Preparing the onboard files for transfers

(29) "Username" - Enter the name of the FTP/Remote user that connects to the in-pit machines. Set this field to "root".

(30) "Password" - Enter the Password that is used to connect to the in-pit machines. Set this field to "cold".

(31) "Confirm Password" - Enter the Password that is used to connect to the in-pit machines. Set this field to "cold".

Tasks

The "Tasks" section (6) is used to set up the tasks for the application. Refer to Illustration 3.

Illustration 11	g01400690
(32) "Machine update interval" field (33) "Delay before retrying a failed task" field (34) "Maximum number of retries before permanent task failure" field (35) "Automatically download maps during machine update" box

Enter the information about the tasks:

(32) "Machine update interval" - Enter the interval in minutes between the scheduled downloads of machine information. These downloads retrieve the following information: current position of machine, operator, map and other diagnostic information.

(33) "Delay before retrying a failed task " - Enter the delay in seconds after a task fails. When this time is reached, the program will retry the task. When a task fails, the task is placed back into a queue that contains the tasks that have failed.

(34) "Maximum number of retries before permanent task failure" - Enter the number of times in order to try the task. When this number is reached, the task fails permanently.

(35) "Automatically download maps during machine update" - This check box is used to determine whether an update to the machine also downloads the in-pit machine's map. On slow networks, an update to the machine may consume an excessive amount of time. If the update consumes an excessive amount of time, then disable this option.

Testing the Machines

Note: Test the machine before the ComManager script is uploaded to the machine.

Test the machines that were added to the ComManager's Machine list by using the following procedure:

1. Select the machine that will be tested from the "Machines" section of the "ComManager config" dialog.

Show/hide table



Illustration 12	g01400731
(17) "Test and Configure machine" button

2. Click the "Test and Configure machine" button (17) .

   The "Testing machine" dialog that is shown in illustration 13 appears.

Testing the Machine

Illustration 13	g01400733
(36) "Test Machine" button (37) "Upload local ComManager script to machine" button (38) "Close" button

The "Testing machine" dialog contains the following buttons:

"Test Machine" - Test the machine.

"Upload local ComManager script to machine" - Upload the ComManager script.

"Close" - Close the dialog and save the changes.

1. Click the "Test machine" button (36). Refer to Illustration 13. The following actions will occur:
   • Three tests will be performed in order to check the status of the machine.

   • The version of the ComManager script that is installed on the machine will be determined.

2. Resolve any errors. The following errors may occur:

   "Unable to execute command on server" - This error usually indicates that the Username and/or the Password that has been specified is incorrect.

   "Operation timed out waiting for response from server": - This error indicates that communication cannot be established with the remote onboard computer.

   This situation could be caused by one of the following situations:

   • Power is not applied to the onboard computer.

   • The onboard computer is not communicating with the network.

   • An invalid IP address was specified for the machine.

   Upon successful completion of the three tests, the version of the onboard ComManager scripts will be displayed.

3. Click the "Close" button (38). Refer to Illustration 13.

Note: If the onboard version does not match the local version, the local scripts must be uploaded.

Uploading the ComManager Script

ComManager will not function properly unless the computer that is on the machine contains a ComManager script. The following procedure should be performed on each machine that is configured.

Perform the following steps In order to upload a new ComManager script to the machine.

1. Ensure that a connection has been established to the machine.

Show/hide table



Illustration 14	g01400733
(36) "Test Machine" button (37) "Upload local ComManager script to machine" button (38) "Close" button

2. Click the "Upload local ComManager script to machine" button (37). Refer to Illustration 14. The local ComManager script is loaded to the computer on the machine.

3. The "Upload Status" section displays the actions that are occurring. When the upload is complete, scroll through the window at the bottom of the screen. Ensure that no errors were reported.

4. Resolve any errors that were reported.

5. Click the "Close" button (38). Refer to Illustration 14.

Restarting the ComManager Service

Show/hide table



Illustration 15	g01400737
(39) "Ok" button

1. After all sections of the "ComManager config" screen have been completed, click on the "OK" button (39) in order to save the changes.

2. Restart the ComManager service in order for the changes to take effect. Use either of the two methods that are outlined below:

Method 1

1. From the Windows Start menu, click "Settings".

2. Click "Control Panel".

3. Click "Administrative Tools".

4. Click "Services". A list of services appears.

5. Right click "ComManager" from the list.

6. Click "Restart".

Method 2

1. From the Windows Start menu, select "Run...".

2. Enter "cmd" in the "Open" field.

3. Click the "Ok" button. A DOS window appears.

4. Type "net stop ComManager" at the command prompt.

5. Click the "Enter" key on the keyboard. Wait until the program indicates that the service has stopped.

6. Type "net start ComManager" at the command prompt.

7. Click the "Enter" key on your keyboard. The program will indicate that the service has started again.

8. Type "exit" at the command prompt.

9. Press the "Enter" key on the keyboard. The DOS window closes.

Run the ComManager Service as a User

An IT Manager must create a separate "User" account for ComManager if either of the following conditions exist.

• The "Aquila root" folder resides on another computer.

• The settings for security of the "Aquila root" folder on the local computer do not allow the standard System account to access the folder.

1. From the Windows Start menu, click "Settings".

2. Click "Control Panel".

3. Double click "Administrative Tools".

4. Double click "Services". A list of services appears.

5. Right click on "ComManager" in the list.

6. Select "Properties". The "Properties" window appears.

7. Click on the "LogOn" tab.

8. Select the "This Account:" button.

9. Specify the following information for the new User.
   • Location of account

   • Password

10. Click "Ok".

11. Close all of the windows.