# macOS Installation

The simplest way to install ZebraTester on macOS is to run the guide and follow the installation instructions. Below are

1. A 10-minute end-to-end video showing
   1. Installing ZebraTester
   2. Creating the CA Root Certificate creation
   3. Importing the CA Certificate into a browser
   4. Quick ZebraTester proxy recorder test of the installation
2. An Installation Summary Table with the installation steps and associated screenshots.

***

## Installation Video <a href="#macosinstallation-installationvideo" id="macosinstallation-installationvideo"></a>

This is a complete video walkthrough of the installation, certificate creation, and initial ZebraTester test recording for macOS, by Apica veteran, Doug McAfee.

## Installation Steps <a href="#macosinstallation-installationsteps" id="macosinstallation-installationsteps"></a>

Apica recommends installing ZebraTester into the default folder. However, it is possible to have multiple installations of ZebraTester on your machine at the same time if you install ZebraTester into different folder names, for example, 70B/Zebratester… and 75A/Zebratester…

| **Step**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | **Screenshot** |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
| <h3 id="macosinstallation-pre-installationstep">Pre-installation Step</h3><p>There has been a permission change that Apple implemented since Catalina (macOS 10.15.X) where an Apple Certificate is expected (the presented Apica Certificate is no longer accepted) and changes the installer package so that it cannot autoinstall because the executables have been changed to text files.</p><p>This only means that Apple-Certified installation packages will be automatically installed. The installation package is still valid with the Apica Certificate and can be installed with a few extra steps.</p><p>In these cases, you will get an alert that will need a small workaround.</p><p> This can be easily corrected by the few steps listed on these preinstallation steps here.<br> Or, please visit our Apica Community to a page, <a href="https://community.apicasystems.com/hc/en-us/community/posts/360007694040-Installation-file-can-t-be-opened-in-Mac-OSX-Catalina">Installation file can't be opened in macOS Catalina</a>, that contains the technical steps to change the permissions that allow the installation to proceed.</p> |                |
| <h3 id="macosinstallation-installzebratester">Install ZebraTester</h3><p>Expand the archive <strong>ZBA55</strong>\<minor version><strong>.zip</strong> with a mouse click and then start the installation by clicking on <strong>ZBA55</strong>\<minor version>.</p><p>Alternatively, you can install ZebraTester in any other location like your home folder /Users/\<your account name>/ZebraTester\`.</p><p>During the installation a pop-up window is shown which generates a new default license or shows your existing license if ZebraTester was already installed earlier at the same location.</p><p><strong>Note:</strong> You must click the <strong>Apply</strong> button in order that the new license is stored on disk.</p>                                                                                                                                                                                                                                                                                                                                                                                                                   |                |
| <h3 id="macosinstallation-zebratesterinstallerscreens">ZebraTester Installer Screens</h3><p>These screens were seen in earlier installations--you may not see these prompts.</p><ol start="1"><li>Java is required for the installation and running of ZebraTester. Please accept the screens that require it. In this case Java will need access to my installer files on my Desktop.</li><li>InstallAnywhere will prompt you through</li></ol>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |                |
| <h3 id="macosinstallation-introductionandlicenseagreement">Introduction and License Agreement</h3><ol start="1"><li>Click Next at the Introduction</li><li>Check next to the “I Accept…” statement</li></ol>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |                |
| <h3 id="macosinstallation-setinstallationfolderandanalias-ifdesired">Set Installation folder and an Alias (if desired)</h3><ol start="1"><li>The default destination is in the Applications folder on the hard drive.</li><li>Create any Zebra Alias’s that you desire/need.</li></ol>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |                |
| <h3 id="macosinstallation-pre-installationsummary-and-installation">Pre-Installation Summary & Installation</h3><ol start="1"><li>Review to confirm</li><li>Installation will start after clicking the <strong>Install</strong> button</li></ol>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |                |
| <h3 id="macosinstallation-settingsandlicense">Settings and License</h3><ol start="1"><li>Select your timezone and number format</li><li>Click <strong>Apply</strong> and <strong>Next.</strong></li></ol><p>Please ensure you Click the Red <strong>Apply</strong> Button to properly set the licensing information! You will probably get errors otherwise.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |                |
| <h3 id="macosinstallation-carootcertificateandtuning">CA Root Certificate and Tuning</h3><h4 id="macosinstallation-createyourowncarootcertificate">Create your own CA Root Certificate</h4><ul><li>Generating a private CA Root Certificate (macOS)</li></ul><h4 id="macosinstallation-optional-onlyifloadtesting-tuneyourmacosforloadtestingperformance">Optional: Only if load Testing: Tune your macOS for Load Testing performance</h4><p>This is step is not needed if you are only intending to use ZebraTester to capture sessions and script.</p><ul><li>If you are load testing, then please see the macOS System Tuning page.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |                |
| <h3 id="macosinstallation-installationcomplete">Installation Complete</h3><ol start="1"><li>Note some of the locations.</li><li>Drag shortcuts to the Dock as needed.</li><li>Clock <strong>Done</strong> to exit the Installer</li></ol>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |                |
| <h2 id="macosinstallation-tostartzebratester">To start ZebraTester:</h2><ul><li>Click the <strong>ZebraTester Console</strong> icon to start the console</li><li>Clicking the <strong>ZebraTester GUI</strong> icon</li><li>Alternatively, you can also access the GUI by starting your <strong>Chrome/Firefox Web Browser</strong> and entering <a href="http://127.0.0.1:7990"><http://127.0.0.1:7990></a> into the address bar.</li></ul><p>To record Web Surfing Sessions, you can optionally use the <a href="https://apica-kb.atlassian.net/wiki/spaces/DAZT/pages/4620878/Download+the+ZebraTester+Extension">Recording Extension</a>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |                |
