Installing required software 

Make sure you are connected to the Internet. 

Updating macOS 

  1. Ensure you are running the latest version of macOS. You can check the latest versions of macOS on the Apple website. 

Installing Microsoft Office software 

  1.  Install Microsoft Office 365 or Microsoft Office 2019 (or newer). 
  2. Open any Microsoft Office application and activate the license by either logging in with a suitable account or by entering a license key. 
  3. Open the Microsoft Excel, Word and PowerPoint apps at least once, then clear any popups or activation dialogs to prevent them from interfering with the Procyon office productivity Benchmark.  

Installing the UL Procyon Office Productivity Benchmark 

  1. Install Procyon:
    Procyon-macos-installer-x64-OfficeProductivity-<version>.pkg 
  2. You may be prompted to install Rosetta to continue the installation unless Rosetta is already installed in the system. It can be installed with the command:  
    softwareupdate --install-rosetta 
  3. Follow the prompts to complete the installation. 

Note:  
UL Procyon is installed in the ‘/Library/UL/Procyon/OfficeProductivity’ folder. 

Registering your Procyon license

  1. Open Terminal. 
  2. In Terminal, navigate to the installation folder with:  
    cd /Library/UL/Procyon/OfficeProductivity 
  3. Register your license:
    ./UL_Procyon --register <license key>


First time Procyon setup

We recommend that in order to correctly set up the required macOS security permissions, you first run the “Office Productivity first time setup” process, then accept the requests for security permissions that appear in the first few minutes of the process.  

Usually on a system that has not any special permissions configured the Office Productivity first time setup process goes as follows: 

  1. Using Terminal, run the configuration tool in the Procyon install directory:  
    <./UL_Procyon -d office_productivity_first_time_setup.def 
  2. Accept the macOS permission requests that appear during the first-time process.  
  3. The last prompt will take you to Security & Permissions in Settings app.  
  4. Check the box next to “java” (on macOS Monterey) or “Terminal” (on macOS Ventura) 
  5. The first-time setup will end and show a prompt to retry the first-run setup if it did not have all necessary security permissions. 
  6. Click ‘Retry’ in the first-time setup dialog. 
  7. Accept any more permission requests that appear. 
  8. Necessary security permissions will have been set up once the first-time setup ends successfully. You may have to run the setup several times to achieve this. 


Notes:  

  • In case you accidentally deny a permission instead of accepting it, you can go to Security & Permissions in Settings app to check boxes in Accessibility and Automation tabs 
  • If it all fails, you can start over by resetting all permissions by issuing the following command in Terminal: 
    tccutil reset All  
    • Some enterprise security systems may require you to first add Terminal app to have Full disk access in Security & Permissions 


Required Permissions

MacOS 12 Monterey 

On macOS 12 Monterey, the required permissions are: 

    Accessibility: 

  • /Library/UL/Procyon/jdk8u292-b10-jre/Contents/Home/bin/java 

    Automation: 

  • /Library/UL/Procyon/ jdk8u292-b10-jre/Contents/Home/bin/java 
  • Microsoft Word 
  • Microsoft PowerPoint 
  • Microsoft Excel 
  • System Events 

MacOS 13 Ventura 

On macOS 13 Ventura, the required permissions are: 

    Accessibility: 

  • Terminal 

    Automation: 

  • Terminal 
  • Microsoft Word 
  • Microsoft PowerPoint 
  • Microsoft Excel 
  • System Events

MacOS 14 Ventura and MacOS 15 Sequoia 

On macOS 14 and macOS 15, the required permissions are: 

    Accessibility: 

  • Terminal 

    Automation: 

  • Terminal
    • Microsoft Word 
    • Microsoft PowerPoint 
    • Microsoft Excel 
    • System Events


Run the office productivity benchmark

Once the benchmark is installed and permissions configured properly, it can be run as follows: 

  1. Open Terminal. 
  2. In Terminal, navigate to the installation folder with:
    cd /Library/UL/Procyon/OfficeProductivity 
  3. To run the office productivity benchmark:
    ./UL_Procyon -d office_productivity.def -o “<output path>/<output file>.procyon-result”
    Example:
    ./UL_Procyon -d office_productivity.def -o “/Users/ProcyonTestUser/Procyonresults/OfficeProductivityResult.procyon-result” 


Viewing your results

The best method to process benchmark result data is to use the Office Productivity benchmark with Testdriver Cloud.  

If you chose to not use Testdriver Cloud, you can extract the information from the results file using either of the following processes.  

Exporting with command line switch

Option 1:

  1. Use -export-csv or -export-xml command line switch to export results as an XML or CSV file:  
    ./UL_Procyon -d office_productivity.def -o <Export File Name>.zip --export-csv ~/<Result File Name>.csv 
    Example:
    ./UL_Procyon -d office_productivity.def -o ZipOfficeProductivityResult --export-csv OfficeProductivityResult.csv 

Option 2:

  1. Use the -export-simple-CSV command line switch to export results as a single CSV file:  
    ./UL_Procyon -d office_productivity.def -o <Export File Name>.zip -l 2 --export-simple-csv <CSV File Name>.csv
    Example:
    ./UL_Procyon -d office_productivity.def -o ZipOfficeProductivityResult.zip -l 2 --export-simple-csv OfficeProductivityResult.csv

Extracting Result.xml from the .procyon-result file.

(This is essentially the same as using -export-xml command) 

  1. Unzip the .procyon-result file to extract the contents. Your benchmark results are available in the ‘Result.xml’ file.

Once you have the CSV or XML file, you can process the data with your preferred tools.


Uninstalling UL Procyon Office Productivity

The benchmark can be uninstalled as follows: 

  1. Open Terminal. 
  2. In Terminal, navigate to the installation folder with:
    cd /Library/UL/Procyon/OfficeProductivity 
  3. Run the uninstallation script:
    sudo ./uninstall.sh 

Note:  

It is not recommended to uninstall just by removing the installation folder, as it will leave the Procyon app installed in the operating system registers. This can cause issues when installing Procyon again later.