OperationsCommander - https://opscom.wiki

Setup Installation and Maintenance

First Time Installation - Android

The First Time Installation - Android guide outlines how to download and set up the legacy parking enforcement application on a new mobile device. Its primary purpose is to ensure field officers successfully download the application from the Google Play Store and understand the initial registration and permission requirements. This article is intended for OPSCOM administrators and field enforcement personnel provisioning new handheld devices.

Setup and Configuration

The installation requires both administrative setup in the web portal and physical configuration on the Android device.

Admin Side: Administrators must ensure that field users have the correct access rights before they can log in. Specifically, the user profile must have the Add New Violation permission enabled under the Violations Permissions settings in the core portal.

User Side (Enforcement Staff):

  1. Tap the Google Play Store app on the device's main screen to open it.

  2. Tap the search bar and type OperationsCommander or OPSCOM.

  3. Tap the OPSCOM application icon from the search results to access the store page.

  4. Tap the Install button to begin the download process.

  5. Tap Accept on the settings pop-up window to grant the application access to required device integrations.

  6. Tap the Open button directly within the store once the installation completes, or return to the device's home screen and tap the newly created OPSCOM app shortcut.

Using this Feature

Because this is a one-time installation process, interacting with the software primarily involves completing the initial launch and capturing the device's unique identifier.

Initial Application Launch

Upon opening the application for the very first time, the system will prevent immediate login and display a registration warning.


Best Practices and Considerations

Manual Update or Installation

The Manual Update or Installation process allows users to install or update the legacy Android enforcement application directly from the Google Play Store. Its primary purpose is to ensure field officers have the latest software version on their handheld devices for optimal performance and access to new features. This article is intended for OPSCOM administrators and field enforcement personnel.

Setup & Configuration

To use the software, the officer's user profile must have the proper permissions granted in the core OPSCOM system before they attempt to log into the mobile application.

Admin Side: Administrators must ensure that field users have the "Wireless handheld" permission enabled.

  1. Hover over System Config and click Manage Roles.

  2. Click Permissions beside the specific Administrator Role you wish to edit (e.g., Patrol Officer).

  3. Click the Violations tab.

  4. Enable the Display as Ticket Writer checkbox.

User Side (Enforcement Staff): Ensure the Android handheld device is connected to a stable Wi-Fi or cellular network before attempting to download or update the application.

Using this Feature

Field personnel can manually check for and install updates using the native Android app store.

Installing or Updating the Application

  1. Tap the Google Play Store app on the device's Apps screen.

  2. Tap the search bar and enter OperationsCommander or OPSCOM.

  3. Tap the OperationsCommander app icon to open the installation page.

  4. Tap the Install button to perform a fresh installation, or tap the Update button to perform an in-place update of the existing software.

  5. Tap Accept when the settings window pops up requesting access to integrated device features. (Note: On newer tablets, these permission requests may appear during the initial startup of the application instead).

  6. Tap the Open button directly within the Play Store, or return to the device's home screen and tap the newly created shortcut to launch the application.

Install vs. Update Tapping the Install button performs a fresh installation where a new shortcut and a fresh local database are created. Tapping the Update button performs an in-place update, meaning a new database is not created and your existing local data will not be disrupted.


Best Practices & Considerations

Testing Your WIFI Connection

The Testing Your WIFI Connection process guides users in diagnosing wireless network stability on Android handheld devices using a third-party application. Its primary purpose is to help identify signal drops and channel congestion that may disrupt real-time communication with the server. This article is intended for OPSCOM administrators and field enforcement staff.

Setup and Configuration

To accurately test your network connection, you must install a specific third-party diagnostic application on your Android handheld device.

Admin Side: 

  1. Open the Google Play Store on your Android handheld device.

  2. Search for and download WifiAnalyzer (open-source) by VREM Software Group. This is a free utility application.

Using this Feature

Administrators and staff can use this application to take a precise measurement of their Wi-Fi strength and identify the source channel to aid in troubleshooting.

Monitoring Wi-Fi Strength

  1. Open the WifiAnalyzer application on your device.

  2. Tap the hamburger icon (three parallel lines) located at the top left of the screen to open the main menu.

  3. Tap Access Points to view a graphic representation of your available networks and their current signal strengths.

  4. Tap the hamburger icon again and select Channel Graph to view a visual representation of channel congestion and overlapping network signals.

Visual Cues & Status Indicators


Best Practices & Considerations

Uninstalling the Application

The Uninstalling the Application process outlines how to safely remove the legacy OPSCOM Parking Enforcement app and its associated data folders from an Android handheld device. Its primary purpose is to guide users through a standard removal or a full clean data purge to prepare the device for troubleshooting or a fresh installation. This article is intended for OPSCOM administrators and IT support personnel.

Setup and Configuration

Before removing the application, it is critical to ensure that all local data has been safely transferred to the core database.

Admin Side: Administrators should ensure the device has an active network connection and verify that all recent patrol data has successfully synchronized to the backend.

User Side (Enforcement Staff): Field staff must log in to the application one final time and check the Replication Status page to ensure all records have been pushed to the server.

Using this Feature

The uninstallation process can be completed natively on the Android device. In the event of a full clean install, residual files must also be deleted using the device's file manager or a connected PC.

Standard Application Uninstall

  1. Tap Settings from the main Android applications menu.

  2. Tap the General tab.

  3. Tap Applications under the Device Manager section to view the installed apps list.

  4. Tap the OperationsCommander application in the list.

  5. Tap Uninstall to remove the application from the unit.

Full Clean Install with Data Purge

In some cases, OPSCOM Support may ask you to perform a full clean install. This requires removing the app (following the steps above) and manually deleting all associated local files to prevent artifacts from affecting the new installation.

Data Loss Prevention If you are uninstalling the software to reinstall it, do not uninstall the software if the ViolationTransfer and/or VehicleTransfer tables contain data (viewable under Replication Status). These tables must be replicated to the server first to avoid permanent data loss and integrity issues.

Delete Files with Handheld Tools

  1. Tap the App Tray at the bottom right of the home screen display.

  2. Tap the My Files application.

  3. Locate and Tap and Hold the OPSCOM folder from the directory list.

  4. Tap Delete from the pop-up options window.

  5. Tap OK on the confirmation screen to remove the folder and all its contents.

Delete Files using a PC (USB Connection)

  1. Connect the handheld device to your computer via USB.

  2. Open Windows Explorer and locate the device under This PC.

  3. Click Tablet (or internal storage) to view the file content of the device.

  4. Locate the folder named OPSCOM.

  5. Right-click the folder and click Delete from the drop-down menu to remove the folder and all its contents.


Best Practices and Considerations

Reinstalling the OPSCOM App

The Reinstalling the OPSCOM App process guides users through completely removing the legacy Android application and preparing the device for a fresh installation. Its primary purpose is to help resolve persistent application issues or update the software when automated updates are unavailable. This article is intended for OPSCOM administrators and field enforcement personnel using the legacy Android application.

Setup and Configuration

Before removing the application, it is critical to ensure that the device is prepared and that no local data is left unsynchronized.

Admin Side: Administrators should ensure the device has a stable Wi-Fi or cellular connection to successfully download the new application package once the old version is removed.

User Side (Enforcement Staff): Enforcement officers must verify that all recent patrol data (such as offline violations or chalk records) has successfully synchronized to the backend database before beginning the uninstallation process.

Using this Feature

The uninstallation process is performed natively through the Android operating system's application manager.

Uninstalling the Application

  1. Tap Settings from your device's home screen or app drawer.

  2. Tap the General tab at the top of the settings menu.

  3. Tap Applications under the Device Manager section on the left side of the screen to bring up a list of installed apps on the right.

  4. Scroll through the list and tap the OPSCOM application.

  5. Tap Uninstall to remove the application and its base data from the unit.

Data Loss Prevention Never uninstall the application while you have active, unsynced data on your device. Removing the application will permanently delete all local cache files, and any violations that have not been pushed to the main server will be lost.

Reinstalling the Application

Once the application has been successfully removed from the Android device, you must download and install a fresh copy.

  1. Please refer to the Manual Update or Installation article for complete, step-by-step instructions on downloading the APK file and setting up the new application.


Best Practices and Considerations

Retrieve Local Tablet Backups

The Retrieve Local Tablet Backups process allows organizations to access and extract offline violation data directly from an Android handheld device's internal storage. Its primary purpose is to recover locally stored violations in the event of a synchronization failure, accidental application uninstallation, or database error before the records are successfully uploaded to the server. This article is intended for OPS-COM administrators and IT support personnel.

Setup and Configuration

Extracting these files requires physical access to the device and a wired connection to a workstation.

Admin Side: Administrators must have a physical USB connection cable and a PC to access the device's internal file system.

User Side (Enforcement Staff): Ensure the Android tablet is powered on and actively unlocked before connecting it to the computer.

Locating a USB Cable If you do not have a dedicated USB data cable, check the tablet's charging unit. Most charging cables feature a detachable USB plug that can be removed from the wall adapter and plugged directly into your PC.

Using this Feature

Administrators must connect the device to a PC, locate the specific application data folder, and transfer the files to OPSCOM support for recovery.

Connecting the Tablet to a PC

  1. Connect the tablet to your computer using a compatible USB cable.

  2. Unlock the tablet screen so the PC can authorize the connection and read the internal storage.

  3. Click the USB connection notification on your PC, or navigate manually through File Explorer to This PC and open the tablet's internal storage drive.

Locating and Copying Backup Files

  1. Navigate through the tablet's internal storage to the following folder path: Android\data\com.operationscommander.handheld\files\Backups.

  2. Select all backup files located within this folder (or the specific files requested by support).

  3. Copy the selected files.

  4. Paste the files into a new, temporary folder on your local computer's desktop (e.g., "Tablet Backups").

Sharing Backups with Support

Once the files are secured on your local computer, they must be shared with the support team to complete the recovery.

  1. Open a web browser and navigate to Google Drive.

  2. Click New and select Folder Upload.

  3. Select the temporary backup folder you created on your desktop to begin the upload.

  4. Wait for the upload status window in the bottom right corner of the screen to confirm all files have successfully uploaded.

  5. Share the uploaded folder with support@ops-com.com and notify the support team that the files are ready for retrieval.

You may also email the backup files directly to support if the overall file size is small enough to attach.


Best Practices and Considerations

Connecting as USB Hard Drive

The Connecting as USB Hard Drive process allows users to physically link their Android handheld device to a desktop computer to access its internal file system. Its primary purpose is to enable the direct transfer, copying, or backup of application data and files (such as local OPSCOM folders) without relying on a network connection. This article is intended for OPS-COM administrators and IT support personnel managing the legacy Android application.

Setup and Configuration

This procedure relies on the native Android operating system and a physical connection to a desktop computer.

User Side (Enforcement Staff): The handheld device requires a physical USB data cable and must have Developer Options enabled within the Android operating system to allow debugging and mass storage access.

Using this Feature

To access the device's file system, you must first enable the correct connection mode on the handheld, then navigate the file structure on your desktop computer.

Enabling Developer Options

If you do not already see a Development option in your settings menu, follow these steps to unhide it:

  1. Tap Settings from the device's main menu.

  2. Scroll down and tap About phone.

  3. Scroll down to locate Build number.

  4. Tap Build number seven times in rapid succession. A notification will appear confirming that the Developer setting is now unlocked.

Connecting the Device

  1. Tap Settings, select Applications, tap Development, and enable the USB debugging checkbox.

  2. Plug the USB cable into your desktop computer and connect the other end to your Android device. A USB icon will appear in the device's top status bar.

  3. Swipe down from the top edge of the Android device screen to reveal the notification shade.

  4. Tap USB Connected and select the option to mount the device (e.g., Connect USB storage or Mount).

  5. Tap Ok to confirm. The Android icon will change color (typically to orange), indicating the phone is now in USB Mass Storage mode.

Accessing Files on the Desktop Computer

  1. Open the file explorer on your desktop computer and navigate to the connected devices or removable storage section.

  2. Click the newly mounted hard drive letter associated with the Android device.

  3. Locate and click the OPSCOM folder (sometimes labeled ParkAdmin) to browse, copy, or transfer the required files.

Disable Mass Storage Mode Turn off USB hard drive mode on the handheld device immediately when you are finished copying files. Leaving this connection active can cause read/write conflicts and operational issues with the OPSCOM software.


Best Practices and Considerations


Google Account

The Google Account configuration process guides users on how to add a Google profile to their Android handheld device. Its primary purpose is to grant access to the Google Play Store for downloading, updating, and troubleshooting the legacy OPS-COM Parking Enforcement app, as well as managing beta releases. This article is intended for OPS-COM administrators and field enforcement personnel configuring their devices.

Setup and Configuration

You will require a valid Gmail email account and password to access the Google Play Store on your handheld device.

Admin Side: Administrators configuring field devices prior to deployment should ensure the device is connected to a stable network and a standardized organizational Google account is available for use.

User Side: Depending on your Android version, the exact naming conventions may vary slightly, but the core steps remain the same.

  1. Tap Settings from the main menu of your Android device.

  2. Tap Accounts (or Users & Accounts).

  3. Tap Add account from the settings list.

  4. Tap Google from the list of available account types.

  5. Enter your assigned Gmail email address and password, then follow the on-screen prompts to finalize the login.

Removing an Account If you already see Google in the accounts area and need to switch profiles, you can remove existing Google accounts from the device by tapping Google and selecting the remove option before adding the new account.

Using this Feature

Enforcement personnel and administrators use the active Google account to manage app updates, clear system caches, and opt into beta testing directly through the Google Play Store.

Clearing Google Play Cache

Google Play will cache application details for hours to even a day or more. Clearing the cache ensures that the most recent version of the application that is available is accessible to your device.

  1. Access your device's native app settings.

  2. Tap the Google Play Store application.

  3. Tap Storage or Storage & cache.

  4. Tap Clear cache to remove the temporary data.

Joining or Leaving the Beta Program

At times, new beta (non-production) releases may be offered that address client-reported issues or new functionality. Clients may test the beta versions to ensure issues are resolved and that normal functionality is not disrupted.

  1. Navigate to the Beta Program on Android on your handheld device, or the Beta Program on the Web on a desktop browser.

  2. Scroll down the page to determine your current status under the beta header.

  3. Tap Join to enter the program, and tap Join (or Confirm) a second time when prompted.

  4. Tap Leave if you wish to remove yourself from the beta program and no longer receive pre-release updates.


Best Practices and Considerations


Related Video

Application Logout

Setup and Configuration

The logout process is a core functionality built into the application and requires minimal backend setup.

Admin Side: Administrators must ensure user credentials and permissions are properly maintained in the central portal so field officers can log back in for subsequent shifts.

User Side (Enforcement Staff): Enforcement officers must ensure the handheld unit has an active Wi-Fi or cellular network connection prior to initiating the logoff process to guarantee complete data synchronization.

Using this Feature

Enforcement personnel must complete the logout procedure at the end of every shift or whenever handing off a device to another officer.

Executing the Shutdown Process

Logout Without Connectivity If you log off in an area without internet access, the software will still lock securely (requiring a password to sign back in), and all shift data will save locally on the tablet. However, the data will not upload to the server until a manual or startup synchronization occurs when connectivity is restored.

Confirming Data Synchronization

  1. Tap Synchronize Data prior to logging off if you receive an error or suspect recent shift data did not sync automatically.

  2. Tap Replication Status to verify that all pending records have successfully replicated to the main database.


Best Practices and Considerations

Using the OPSCOM App in DEMO Mode

The Using the OPSCOM App in DEMO Mode feature allows users to explore and test the legacy OPSCOM Parking Enforcement application without needing to officially register a handheld device. Its primary purpose is to provide a safe, pre-populated sandbox environment for training and familiarizing staff with the software's core functions. This article is intended for OPSCOM administrators and field enforcement personnel.

Setup and Configuration

No formal registration or backend configuration is required to access the demonstration environment.

Admin Side: Administrators do not need to configure specific user permissions or device profiles within the core OPSCOM portal for devices operating strictly in demo mode.

User Side (Enforcement Staff): Enforcement officers simply need to ensure the legacy Android application is successfully installed on their handheld device.

Using this Feature

Enforcement personnel can bypass the standard device registration screen to access a fully functional, pre-populated version of the application for testing purposes.

Accessing Demo Mode

  1. Boot up the application after the initial installation on your Android device.

  2. Tap DEMO MODE on the initial Device Not Recognized pop-up screen.

  3. Review the sign-in screen. The demonstration username and password credentials will automatically populate.

  4. Tap LOGIN to access the main index screen and begin testing.

Available Actions and Testing Scope

Once logged into DEMO mode, users can practice various core enforcement actions without affecting live database records. Recommended testing actions include:

Key Information Displayed: Test Data Profiles

The demonstration environment is pre-loaded with sample data. Use the following profiles to test different search queries, permit statuses, and violation scenarios:

Username

First Name

Last Name

User Type

Plate

VIN Number

Violations

Permits

spencer

Spencer

Carr

Full Time Staff

SPENCE




jparsons

Julie

Parsons

Complimentary

JULPAR

ASDA347

1q21242143124213


COM100 - Unpaid

jrockwood

James

Rockwood

F/T Student

JROCK

5SXHANDC38RZ55506


R102 - Red Student Lot W

sjamieson

Steph

Jamieson

P/T Student

SJAM


SJAM2

2T1BU4EE5DC972469


1N4AL3AP5DN517821

TT-10001

100 - Red Student W

 

102 Red Student W

johndoe

John

Doe

F/T Staff

ABC316

1FMCU0EG1CKB65454


501 - Unpaid

skjones

Jones

Sarah

Daily Reserved

AKRJ259




vcosta

Voula

Costa

Daily Reserved

VCOST

2GCEC19V531113601


L103 - Unpaid

bcameron

Brady

Cameron

Complimentary

BCAM



COM100 - Unpaid

sbyers

Sheldon

Byers

Daily Reserved

SHELBY

1G8ZN12871Z117051


L100 - Unpaid

pbirch

Patricia

Birch

F/T Staff

BIRCH


No Plate

1N6AD0ER5FN709323


1GKS1AKC7FR518845

TT-10003

None

mashbury

Micheal

Ashbury

P/T Staff

MASH


ASDA437


BDHE385

JNAMA43H9XGE50339

15-170420

TT-10010

Monthly

0005 - Red Staff Lot West

0002 - Red Staff Lot West

50 -After 4PM

500 - Green Staff Lot East - UNPAID


Best Practices and Considerations