Senso Mac OS BETA Installer Guide


This guide explains how to install the Senso client on a macOS device.*


   *Please read all documentation provided before installation to prepare devices for deployment and to check permissions and supported architecture.


Supported operating systems


The client is available for all macOS devices that are running macOS 10.15 or higher.


Supported architectures


The Senso macOS client only supports x86/x64 architectures,

          


Obtaining the installer

You will need a Senso client installer package to install the client. The installer can be found within the email sent about install.

Downloading the Senso client

1. Right click the package and click ‘Save to downloads folder’.
2. Go to Finder and find the downloads folder.
3. Right click the installer and select open.
4. You will hit the pop-up screen above, click ‘Open’ 


    

Installation through the installer


Once you select open, the installer will open, and you will be faced with the screen seen below.



1. Complete the license agreement.

2. You will be prompted for administrator credentials. 

3. The installer will run.


                          
        
    

4.  If it run successfully, you will see the message below.

5. If the installer is unsuccessful for any reason, please ensure that the account used to install has admin

credentials.



Post-Installation


1. As soon as the Senso client is installed, you should see the Senso logo in the top navigation bar.


      

2. You will then be prompted for the License and Assignment Keys. These can be found in your portal. 


3. When entering these, there are two options:

       *Press ‘Enter Keys’ and write the corresponding keys into the text fields.

       *Double click ‘config.json’ file and enter your corresponding keys into the designated slots.

                    


4. If the details you entered were correct, click the client (this may take a minute or so). The connection status will change to connected and within your portal, and your device will appear.



5. You can also verify that the product has been installed by opening a Finder Window and navigating

to:


/Library/Renato Software/Senso client


The directory should contain the Senso client, the config.json file, the documentation file and the script file.



 

6. The client runs as a service and once it has been downloaded it will start running. To calibrate correctly to the account, once the client has been installed and it has been connected to the portal, please restart the machine.


Uninstall the client


To uninstall the client, run the following commands in the terminal:

  • launchctl unload /Library/LaunchAgents/sensoclient.app.LaunchAgent.plist

This should remove the Senso logo from your device’s navigation bar, then run:

  • sudo sh path/to/uninstall.sh

The ‘path/to/uninstall.sh’ needs replacing for the path to the uninstall script.


This will typically be:

  • sudo sh /Library/Application\ Support/Renato\ Software/Senso\ Client/Scripts/uninstall.sh


Once the command has been run, you will be prompted for administrator credentials. 


If your account does not have the required privileges to run elevated commands, you will need to run terminal as a user with elevated privileges and try again.


The uninstaller will run and output a success message when finished.



If the uninstaller is unable to run, you can manually uninstall the client by performing the following steps:



1. Remove all permissions for the app:

2. Delete the following directories and all-sub directories / content


    • /Library/Renato\ Software

    • rm /Library/Renato\ Software

    • /Library/Application\ Support/Renato\ Software

    • rm /Library/Application\ Support/Renato\ Software


3. Remove the installation record from pkgutil:

    • sudo pkgutil-forget “com.renatosoftware.SensoMacClient”


All of these must be performed using elevated credentials otherwise the client may not install correctly the next time you come to install it on this machine.