Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry UEM Integration SDK 12.12
  3. BlackBerry UEM Integration SDK Development Guide
  4. Best practices and troubleshooting

Best practices and troubleshooting

Best practices
How to...
Steps
Avoid issues if you remove an RX method annotation
If you remove an RX method annotation, code that was generated previously for that annotation will remain in the ui.server project. You must manually remove all generated code from the ui.server project, then regenerate the code by clean-building the ui.server project (Project > Clean). When this is complete, refresh all projects in 
Eclipse
.
Remove a plug-in from a 
BlackBerry UEM
 installation (test or production)
  1. In the 
    Windows
     Services, stop the 
    BlackBerry UEM Core
     and management console services.
  2. Shut down 
    Eclipse
    .
  3. Delete the plug-in folder from 
    <drive>
    :\Program Files\BlackBerry\UEM\ext\.
  4. Navigate to 
    <drive>
    :\Program Files\BlackBerry\UEM\ui\ and run 
    deploy.bat
     as an administrator. This process may take up to 10 minutes.
  5. When 
    deploy.bat
     completes, restart the 
    BlackBerry UEM Core
     and management console services.
Troubleshooting
Issue
Possible solution
In 
Eclipse
, I can't view log data for the UI server
In 
Run > Run Configurations > Java Application > UI Server
, add the following VM argument: 
-"Dlog4j.configuration=file:///${bep.ui}/log4j.xml"
Eclipse
 crashes
Add 
-XX:-UseLoopPredicate
 to the eclipse.ini file. For more information, see Stack Overflow: Eclipse crashing frequently.
The Core or UI launchers do not start
Complete the integration process again and select the 
Regenerate launchers
 check box.
The ui.client project does not compile due to missing classes in the 
<plug-in_id>
.ui.server package
There are errors in *-generated projects (but none in server projects)
Possible solution 1
:
  1. Verify that there are no errors in *.common and *.server projects.
  2. In 
    Eclipse
    , verify that auto-building is enabled.
  3. Delete all generated source code (src/generated) in *-generated projects. Ignore additional errors that are caused by this step.
  4. Clean the ui.server project (Project > Clean > Clean projects selected below).
  5. Refresh all projects:
    1. In the Project Explorer, collapse all projects. For each project, only the project name should be visible, not the contents.
    2. Click a project that is not currently selected.
    3. Click a different project.
    4. Press Ctrl + A.
    5. Press F5.
  6. Wait for the build to complete.
If this does not correct the issue, clean all projects (Project > Clean > Clean all projects) then repeat steps 5 and 6.
Possible solution 2
: In the project ui.server-generated, create a folder named src/generated. Put a dummy file in this folder and rebuild the project.
Possible solution 3
: Run the integration process again (see Create an Eclipse workspace and integrate it with BlackBerry UEM) and do not select 
Create Basic Plug-in Projects
.