Difference between revisions of "Entity Management"

From myViewBoard
Jump to navigation Jump to search
Line 307: Line 307:
 
<div class="mw-collapsible-toggle" style="font-weight:bold;line-height:1.6;float:none;border-bottom:solid 1px #CCCCCC;"><b>What is a software instance?</b></div>
 
<div class="mw-collapsible-toggle" style="font-weight:bold;line-height:1.6;float:none;border-bottom:solid 1px #CCCCCC;"><b>What is a software instance?</b></div>
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
A software instance is any instance of installation of Whiteboard (both Android and Windows versions). If the Whiteboard software is deleted and reinstalled, it will count as a separate instance as it will have to be activated again (requiring a new name and ID).  
+
A software instance is any instance of installation of Whiteboard (both Android and Windows versions). If the Whiteboard software is deleted and reinstalled, it will count as a separate instance as it will have to be enrolled again (requiring a new name and ID).<!--verify if any new install will count as a separate enrollment, i.e. whether or not a new instance ID will be created-->
  
  
Line 316: Line 316:
 
<gallery widths="600" heights="400">
 
<gallery widths="600" heights="400">
 
File:Entity Management software instances2.png|All instances registered to your entity domain will appear in Entity Management.
 
File:Entity Management software instances2.png|All instances registered to your entity domain will appear in Entity Management.
File:Whiteboard name and instance ID info from settings2.png|Whiteboard name and instance ID can be viewed in Whiteboard: settings : info.
+
File:Whiteboard name and instance ID info from settings2.png|Whiteboard name and instance ID can be viewed in Whiteboard settings within the '''info''' tab.
 
</gallery>
 
</gallery>
 
<br>
 
<br>
  
 
===How to install instances of Whiteboard===
 
===How to install instances of Whiteboard===
Whiteboard can be downloaded from the myViewBoard website [https://myviewboard.com/download/|here]. This page link includes MSI files for Windows, and APK for Android. The Android version can also be downloaded and installed from the Google Play store (search "myViewBoard Whiteboard").
+
Whiteboard can be downloaded from the myViewBoard website [https://myviewboard.com/download/|here]. This page link includes MSI files for Windows, and APK for Android. The Android version can also be downloaded and installed from the Google Play store (search "myViewBoard Whiteboard"). Likewise, the iOS version can be downloaded and installed from the App Store (search "myViewBoard Whiteboard").
  
 
If using a ViewSonic ViewBoard, Whiteboard is likely preinstalled on the inbuilt Android OS.
 
If using a ViewSonic ViewBoard, Whiteboard is likely preinstalled on the inbuilt Android OS.
  
 
{| class="wikitable"
 
{| class="wikitable"
!colspan="3" style="background-color:#cef2e0;"|''Install Whiteboard''
+
!colspan="3" style="background-color:#cef2e0;"|''Installing Whiteboard''
 
|-
 
|-
 
! style="background-color:#cef2e0;"|
 
! style="background-color:#cef2e0;"|
 
! style="background-color:#cef2e0;" |'''''On Windows'''''
 
! style="background-color:#cef2e0;" |'''''On Windows'''''
 
! style="background-color:#cef2e0;"|'''''On Android'''''
 
! style="background-color:#cef2e0;"|'''''On Android'''''
 +
! style="background-color:#cef2e0;"|'''''On iOS/macOS'''''
 
|-
 
|-
! style="background-color:#cef2e0;"|'''''End-user'''''
+
! style="background-color:#cef2e0;"|'''''End user'''''
 
! style="background-color:#f5fffa;text-align:left"|Manual installation of '''MSI file''' from [https://myviewboard.com/download/ myViewBoard website]
 
! style="background-color:#f5fffa;text-align:left"|Manual installation of '''MSI file''' from [https://myviewboard.com/download/ myViewBoard website]
 
! style="background-color:#f5fffa;text-align:left"|Manual installation of '''APK file''' from [https://myviewboard.com/download/ myViewBoard website]<br>Download from Google Play store
 
! style="background-color:#f5fffa;text-align:left"|Manual installation of '''APK file''' from [https://myviewboard.com/download/ myViewBoard website]<br>Download from Google Play store
 +
! style="background-color:#f5fffa;text-align:left"|Download from the App Store
 
|-
 
|-
 
! style="background-color:#cef2e0;"|'''''IT admin'''''
 
! style="background-color:#cef2e0;"|'''''IT admin'''''
 
! style="background-color:#f5fffa;text-align:left"|
 
! style="background-color:#f5fffa;text-align:left"|
* Remote and background installation using '''Group Policy''': [[MyViewBoard_deployment|read full guide here]]{{BR}}
+
* Remote and background installation using '''Group Policy'''{{BR}}
 
* Command Prompt msi install (see below)
 
* Command Prompt msi install (see below)
! style="background-color:#f5fffa;text-align:left"|''Unnecessary for ViewSonic Viewboards as Whiteboard preinstalled''
+
! style="background-color:#f5fffa;text-align:left"|''Unnecessary for ViewSonic ViewBoards as Whiteboard comes preinstalled''
 +
! style="background-color:#f5fffa;text-align:left"|''Currently, no IT support required''
 
|}
 
|}
  
Line 349: Line 352:
  
  
Whiteboard for Windows is installed from an MSI file. This can be installed in batches or as a background process by, for example, using Group Policy from Microsoft.
+
Whiteboard for Windows is installed from an MSI file. This can be installed in batches or as a background process by, for example, using Microsoft Group Policy, SCCM, Microsoft Endpoint Manager, and third-party deployment software methods. However, these methods are not within the scope of these instructions.
  
Alternately, use '''Command Prompt (as administrator)''' and execute the following to install to the device:
+
Alternately, use '''Command Prompt (as administrator)'''. If you do not know how to run "Command Prompt" as an administrator, please view [https://www.howtogeek.com/194041/how-to-open-the-command-prompt-as-administrator-in-windows-8.1/ this website].
  
    msiexec.exe /qn /i [name of file].msi PURPOSE="Business" ORGANIZATION="Organization name"
+
Execute the following to install to the device:
  
 +
    msiexec /qn /i $[MSI_PATH] VIEWBOARDNAME=$[VIEWBOARD_NAME] PURPOSE=$[PURPOSE] ORGANIZATION=$[ORGANIZATION]
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 363: Line 367:
 
|-
 
|-
 
|PURPOSE
 
|PURPOSE
|"Business" ''or'' "Public sector" ''or'' "Education" ''or'' "Sport"
+
|"Business" ''or'' "Corporation" ''or'' "Education"
|No
+
|Yes
|This applies the theme for Whiteboard. If not set, the default is Education. Can be changed by users.
+
|This applies the theme for Whiteboard. If not set, the default is Education. Can be changed by users after installation.
 
|-
 
|-
 
|ORGANIZATION
 
|ORGANIZATION
 
|Enter organization (entity) name.
 
|Enter organization (entity) name.
 
|Yes
 
|Yes
|If organization is registed, the installer will automatically fill in the email address of the entity administrator. The instance will be linked to the myViewBoard entity and appear in the Entity Management console.  
+
|If the organization is registered, the installer will automatically fill in the email address of the entity administrator, which cannot be modified. The instance will be linked to the myViewBoard entity and appear in the Entity Management console.
 +
|-
 +
|DOT_NET
 +
|Indicates whether to install .NET framework.
 +
|No
 +
|Supported in v2.36.4.0 and above. Set DOT_NET = FALSE if these components are already installed on a device. If no argument is set in such a case, installation errors may occur.
 +
|-
 +
|VC_RUNTIME
 +
|Indicates whether to install Microsoft Visual C++ redistributable packages.
 +
|No
 +
|Supported in v2.36.4.0 and above.
 
|}
 
|}
  
 
'''Command Prompt: msiexec options'''
 
'''Command Prompt: msiexec options'''
* /qn  Specifies no UI during installation
+
* /qn  Specifies silent mode installation (no UI during installation).
* /i    Specifies normal installation
+
* /i    Specifies normal installation, requiring a user to input settings manually.
* For further parameters, see [https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec?WT.mc_id=none msiexec guide]
+
* For further parameters, see the [https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec?WT.mc_id=none msiexec guide].
 +
 
 +
If you are uncertain how to execute MSI installation via Command Prompt, we recommend enrolling your Whiteboard instances via entity user email. IT Admin should ensure all necessary users have been added under the Entity first, and then end users can enroll Whiteboard simply by signing in. For more information, review the [[Entity Management#Adding users|adding users section above]].
  
 
</div>
 
</div>
Line 389: Line 405:
  
 
{{ent:Blue_note
 
{{ent:Blue_note
|1=[[File:Warning.svg|25px|link=]] When enrolling instances of Whiteboard (for iOS and Android), make sure to '''use your myViewBoard email within your entity domain'''. This will ensure the software instance is automatically registered to that entity and will appear in Entity Management. Any user email address that is registered in the entity user list can activate the software.  
+
|1=[[File:Warning.svg|25px|link=]] When enrolling instances of Whiteboard (for iOS and Android), make sure to '''use your myViewBoard email within your entity domain'''. This will ensure the software instance is automatically registered to that entity and will appear in Entity Management. Any user email address that is registered in the entity user list can enroll the software.  
 
}}
 
}}
  
  
 
<div class="mw-collapsible mw-collapsed plus-toggle" style="overflow:auto;border:solid 1px #white; padding:8px;">
 
<div class="mw-collapsible mw-collapsed plus-toggle" style="overflow:auto;border:solid 1px #white; padding:8px;">
<div class="mw-collapsible-toggle" style="font-weight:bold;line-height:1.6;float:none;border-bottom:solid 1px #CCCCCC;">''Method 1: Enroll instances via Whiteboard Enrollment Form (any entity user)''</div>
+
<div class="mw-collapsible-toggle" style="font-weight:bold;line-height:1.6;float:none;border-bottom:solid 1px #CCCCCC;">''Method 1: Enroll instances with Whiteboard Enrollment Form (any entity user)''</div>
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
# The end user installs the instance of Whiteboard for Windows or Android to their device ([https://myviewboard.com/download/ link to download page]).
+
# The end user installs the instance of Whiteboard for Android or iOS to their device ([https://myviewboard.com/download/ link to download page]).
 
# Open the software and sign in with your myViewBoard account.
 
# Open the software and sign in with your myViewBoard account.
 
# Click '''settings''' and click the '''i''' button for the software information tab.
 
# Click '''settings''' and click the '''i''' button for the software information tab.
 
# Click ''Enroll Software Instance under Entity''.
 
# Click ''Enroll Software Instance under Entity''.
 
# Complete the ''Whiteboard Enrollment Form'' by entering a Whiteboard name and a myViewBoard email address.
 
# Complete the ''Whiteboard Enrollment Form'' by entering a Whiteboard name and a myViewBoard email address.
# After inputting the email address, await detection of corresponding entity.
+
# After inputting the email address, await detection of the corresponding entity.
 
# A prompt should appear informing you of successful enrollment.
 
# A prompt should appear informing you of successful enrollment.
 
#*# On the ''Whiteboard Enrollment Form'', click ''Enroll via QR Code''.
 
#*# Open the [[MyViewBoard Companion App|Companion app]] (make sure to be signed in with your Entity Admin account).
 
#*# Tap the QR code icon to open the scanner.
 
#*# Scan the QR code displayed on Whiteboard with your mobile device.
 
#*# On your mobile device, ensure you select your desired entity.
 
#*# Click '''Submit'''.
 
#*# A prompt should appear on Whiteboard informing you of successful enrollment.
 
 
<!--add image of enroll button and QR code-->
 
<!--add image of enroll button and QR code-->
 
</div>
 
</div>
Line 417: Line 425:
  
 
<div class="mw-collapsible mw-collapsed plus-toggle" style="overflow:auto;border:solid 1px #white; padding:8px;">
 
<div class="mw-collapsible mw-collapsed plus-toggle" style="overflow:auto;border:solid 1px #white; padding:8px;">
<div class="mw-collapsible-toggle" style="font-weight:bold;line-height:1.6;float:none;border-bottom:solid 1px #CCCCCC;">''Method 2: Enroll instances via Whiteboard Enrollment via QR Code (Entity Admin only)''</div>
+
<div class="mw-collapsible-toggle" style="font-weight:bold;line-height:1.6;float:none;border-bottom:solid 1px #CCCCCC;">''Method 2: Enroll instances with Whiteboard Enrollment via QR Code (Entity Admin only)''</div>
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
# The end user installs the instance of Whiteboard for Windows or Android to their device ([https://myviewboard.com/download/ link to download page]).
+
# The end user installs the instance of Whiteboard for Android or iOS to their device ([https://myviewboard.com/download/ link to download page]).
 
# Open the software and sign in with your myViewBoard account.
 
# Open the software and sign in with your myViewBoard account.
 
# Click '''settings''' and click the '''i''' button for the software information tab.
 
# Click '''settings''' and click the '''i''' button for the software information tab.
Line 476: Line 484:
  
 
==Display instances==
 
==Display instances==
[MyViewBoard Display] for [MyViewBoard Display for Android|Android] and [MyViewBoard Display for Windows|Windows] turns a device into a wireless display, with presenters able to share their screen via [https://myviewboard.com/display/ myviewboard.com/display/]. Display comes preinstalled on ViewBoards and ViewBoard Box, but it can also be downloaded for free from [https://myviewboard.com/download/] for Android and Windows devices, and from the [https://www.amazon.com/ViewSonic-Corporation-myViewBoard-Display/dp/B08YNDPBRT/ref=sr_1_125 Amazon app store].
+
[[MyViewBoard Display]] for Android and Windows turns a device into a wireless display, with presenters able to share their screen via [https://myviewboard.com/display/ myviewboard.com/display/]. The Display Instances panel within the Entity Management console allows Admin to assign '''Display Advanced licenses''' to instances installed on [[MyViewBoard Display Advanced for Android|Android]] or [[MyViewBoard Display Advanced for Windows|Windows]].
 +
 
 +
===How to install instances of Display===
 +
Display comes preinstalled on ViewBoards and ViewBoard Boxes, but it can also be downloaded for free from [https://myviewboard.com/download/ https://myviewboard.com/download/] for Android and Windows devices, and from the [https://www.amazon.com/ViewSonic-Corporation-myViewBoard-Display/dp/B08YNDPBRT/ref=sr_1_125 Amazon app store].
 +
 
 +
Review the '''system requirements''' sections of the [[MyViewBoard Display for Android|Android]] and [[MyViewBoard Display for Windows|Windows]] pages for more information.
  
 +
===How to enroll instances of Display===
 
After installation, IT Admin have the option to enroll the device.
 
After installation, IT Admin have the option to enroll the device.
 
<section begin=enroll instance/>
 
<section begin=enroll instance/>
Line 488: Line 502:
  
 
<!--image of QR code screen-->
 
<!--image of QR code screen-->
 +
The enrolled Display instance will now be listed in the Display instances console, which is accessible through the [[Entity Management]] console.
 +
<section end=enroll instance/>
 +
===Assigning Display Advanced licenses to devices===
 +
In order to provide Display end users with access to '''Display Advanced features''', licenses must be assigned to specific instances of Display.
 +
<section begin=assign licenses/>
 +
To assign Display Advanced licenses to devices:
 +
<ol>
 +
<li>Sign into [https://myviewboard.com https://myviewboard.com].</li>
 +
<li>Click the '''[[Entity Management]]''' tile.</li>
 +
<li>Click '''Display''' on the left-side menu.</li>
 +
<li>The Display software instances console will load.</li>
 +
<li>Locate the Display instance to which you want to assign a license. You will identify the instance by its corresponding ''Display Code''.</li>
 +
<ol style="list-style-type:lower-alpha">
 +
<li>Browse the list, looking for the row with the corresponding ''Display Code''.</li>
 +
<li>Or enter the instance's display code into the search bar at the top-right of the list table to filter for the instance.</li>
 +
</ol>
 +
<li>Check the box on the row with the corresponding display code.</li>
 +
<li>Click the Advanced licenses icon [[File:Display advanced license assign.svg|30px|link=]] on the top toolbar.</li>
 +
<li>This Display instance should now be assigned with a Display Advanced license. You will see <span class = "btn" style="padding:5px;border:solid 1px #black;color:#000">'''Advanced'''[[File:Display advanced license assigned.svg|30px|link=]]</span> appear in the '''Mode''' column for this instance.</li>
 +
<li>Continue assigning licenses, with the option to assign multiple licenses at once.</li>
 +
</ol>
  
The enrolled Display instance will also now be listed in the Display instances console, which is accessible through the [[Entity Management]] console.
+
{{ent:Blue_note
<section end=enroll instance/>
+
|1='''Reassigning licenses'''<br/>At any time, licenses can be revoked from a given instance and reassigned to a different instance. However, if you need more licenses than you currently have to assign, you will have to purchase more Display Advanced licenses.<br/>You can view the total number of licenses you have available to assign within the Display instances console (as well as the expiration date of your subscription to these licenses).}}
 +
<!--add image of dashboard with licenses highlighted-->
  
 +
With Advanced licenses now assigned to your preferred instances, Display app users can now access Display Advanced features.
 +
<section end=assign licenses/>
  
 
----
 
----

Revision as of 12:06, 15 August 2022

Icon

The Entity Management console on myviewboard.com provides centralized administration and setup options for the myViewBoard Entity (such as a school or company). This console is only accessible to users set up as admins.

Contact your account manager or get in touch with us here if you require access to this service.

To sign up for an Entity account, visit the link below:

Under I'd like to..., select Sign up as Entity (for schools and organizations) from the drop-down menu.


Read about the benefits of being an entity with myViewBoard here: myViewBoard Entity

How to open the console

Before you can set up myViewBoard suite for your organization, you must first be registered for an entity account. This is a service offered to institutions which includes extra services and functionality such as Entity Management and myViewBoard Manager.

  1. Log in to myviewboard.com with your admin account.
  2. On the main page, click the Entity Management tile.

Layout and navigation

  1. Entity List – Enables you to select an entity if you are the admin of multiple entity accounts
  2. Entity Name – The name of the currently selected Entity
  3. Entity Main Domain – The main domain registered to the currently selected Entity
  4. Entity Insights – Access analytics dashboard for usage statistics
  5. Subscriptions – Access details of any additional add-on subscription services
  6. Domains – View and add additional verified domains
  7. Single Sign-On – Setup your SSO settings to connect with Microsoft Azure AD, Google Workspace (formerly Google G Suite), SAML or SCIM
  8. Users – Access your user list, upload CSV files or setup User Sync via SSO
  9. Managed Service Provider – provide access to a third party to manage your entity account as entity admin
  10. Software Instances – View and manage your installed software instances
  11. Cloud Services – Define which cloud services are permitted to integrate with myViewBoard
  12. Bookmarks - Customize your myViewBoard Whiteboard embedded browser favorites here.
  13. Manager – Access myViewBoard Manager for Device Management of compatible ViewSonic hardware
  14. Firewall Whitelisting – View firewall ports and whitelisting requirements
  15. Entity Onboarding Manual – Link to setup manual and support materials
  16. Main Window – This view changes depending on what is selected from the sidebar
  17. MSI Installer – Download the latest MSI installed for myViewBoard Whiteboard for Windows
  18. Install Instructions – View instructions for installing myViewBoard Whiteboard for Windows using the MSI file.
  19. myViewBoard Activator – myViewBoard Activator app for activating myViewBoard Whiteboard for Android via Google Admin Console


Whitelisting

To successfully setup myViewBoard users and the software suite, there are several things to consider:

  • Access - do you have access to Entity Management and any other required access to setup users and install or deploy the software on your systems?
  • Admin Rights - do you have admin rights to install software and/or access to Microsoft or Google admin for user setup with Single Sign On?
  • Firewalls - do you have the option to setup your firewall to allow myViewBoard access?
  • Filters - do you have any web filters that need to be setup to allow myViewBoard to function?
  • Whitelisting - are you able to whitelist myViewBoard websites and email addresses?


Firewalls


Mandatory Requirement
TCP Port 443 (HTTPS): outbound is required for general operation and activation.

Requirements for screen sharing

  • UDP and TCP port 3478 bidirectional to the WebRTC servers.
  • UDP Ports 50,000-65,535 (RTP/sRTP/RTCP) bidirectional to the WebRTC servers.

There ports are optional; if blocked, media will be proxied using TURN on port 3478. The WebRTC protocol is only used for screen sharing. Verify that these ports are open on your network firewall if you wish to use this feature.


Whitelisting

Whitelist Emails

  • service@myviewboard.com
    main automated email for notifications, security, and user account information.
  • letstalk@service.myviewboard.com
    myViewBoard Support team helpdesk email
  • myViewBoard@news.myviewboard.com
    myViewBoard news and promotions


Whitelist Domains

  • *myviewboard.com
    This is required for the web applications ecosystem to function
  • *myviewboard.cloud
    This is required for proper functioning of web service resources
  • myviewboardclips.com
    This allows proper functioning of myViewBoard Clips
  • *firebraseio.com
    Used by video and audio streaming features
  • *amazonaws.com
    Used by AWS services

Please be sure to include * asterisks where shown above.


IP Addresses


myViewBoard is hosted on Amazon AWS and uses load balancing, as such the destination IP for the myViewBoard server is subject to change without notice. Therefore, we are unable to provide a fixed IP address for whitelisting purposes.



Checking and adding domains

myViewBoard Entities are tied to specific registered domains. Check the "Domain" section of your Entity Management portal to see which domains are registered to your account. By default, a single main domain is registered. Please check to make sure your registered domains match with your end user email addresses. In some cases, you may have been assigned a virtual myViewBoard domain. An example virtual domain name will look like: dnmxntk5mdm4ody0mdqw.at.myviewboard.cloud


If any additional domains are needed, they can be added in the "Domains" section (#6 in the above image).


To add a new domain, click the Entity Management Add User in domain tab button.png add button. After adding the domain, click the Cog button Entity Management.svg cog to verify the domain. You can verify by either MX or TXT record.



Configure Single Sign-On

myViewBoard has the option to setup Single Sign-On (SSO) with Microsoft Azure AD, Google Workspace (formerly Google G Suite), SAML, and SCIM. You can configure this in the "Single Sign-On" section (#7 in the above image).


  1. Use the Single Sign-On Setting drop down menu to select your SSO type.
  2. Choose the option to install myViewBoard to your SSO provider.
  3. Login as the admin to your identity provider to grant access to myViewBoard.
  4. Confirm to use the Identity Provider with myViewBoard.


Following the above steps, your SSO settings should now be setup and show the corresponding Tenant Name or ID



Adding users

Only users within a registered domain can be added. Please make sure the correct domain is setup in the "Domains" section before attempting user onboarding.


myViewBoard has three options for adding users:

  • Automatically using "User Sync" from the Single Sign-On identity provider.
  • Manually via a CSV Import.
  • Discover Domain-related users outside the entity.


User Sync via SSO method

After setting up your Single Sign-On, you will see the option for User Sync.

  1. Select User Sync
  2. Sign in with the admin account for your identity provider
  3. If prompted, allow myViewBoard access to your account
  4. Choose your desired user list you wish to sync (All Users, Groups, or Units)
  5. Confirm to Sync your users


Manual CSV method

To manually add users to myViewBoard, you can use the provided CSV Template file to import multiple users. To do this you will need to be able to open a CSV file using software such as Microsoft Excel or Google Sheets.

Important note Email addresses will only be imported successfully if the email domain matches with a registered domain within the "Domains section". Please check the email addresses belong to domains that are currently registered with myViewBoard before attempting to upload the CSV file. The example below shows the registered domains within the entity, which will allow for any users within those domains to be added.

To add users via CSV file:

  1. Go to the "Users Section" (#8 in the above image).
  2. Click "download template file"
  3. Save and open CSV file in Excel
  4. Fill in all user details using the example fields
  5. Save the CSV file
  6. Click Entity Management CSV SVG.svg CSV Import to upload the file


Discover Domain-related users outside the entity

There may be occasion where individual users have already setup a myViewBoard account prior to the entity being established, or scenarios where users have been accidently deleted from the entity being established.

First open the Users view from the menu on the left, then click Entity Management Discover domain related users outside the entity.svg.


User Sync with Microsoft Azure AD

To add users:

  1. First set up Single Sign-On via Microsoft Azure AD. You can do this in the "Single Sign-On" section of Entity Management (#7 in the above image).
  2. Choose Azure AD from the drop-down menu
  3. Choose Sign in with Microsoft
  4. Login with your Microsoft Admin account
  5. Choose "Use this Azure Directory as Identity Provider"
  6. Click to confirm.


Your setup is complete when a Tenant Name or ID is displayed with the Azure AD application ID.


To sync Azure AD users into your myViewBoard Entity user list:

  1. Navigate to the "Users" section on the left side menu
  2. Choose "User Sync with Azure AD"
  3. Sign in with Microsoft Azure AD Admin account
  4. Choose to sync "All Users" or a "Group"
  5. Click "Keep Previous" to keep any previous users (deselecting this will wipe all existing users during the user sync)
  6. Click "Apply" to sync the users.


After authorizing myViewBoard with Azure AD, you will find myViewBoard-Connect installed in the Microsoft Azure Portal. This is the service used to sync users.

User Sync with Google Workspace (formerly Google G Suite)

To add users:

  1. First set up Single Sign-On via Google Workspace. You can do this in the "Single Sign-On" section of Entity Management (#7 in the above image).
  2. Choose Google Workspace from the drop-down menu
  3. Choose Install myViewBoard to your Google Workspace
  4. Login with your Google Admin account
  5. Choose "Use this Google Workspace as Identity Provider"
  6. Click to confirm.


Your setup is complete when a Tenant Name or ID is displayed.


To sync Google Workspace users into your myViewBoard Entity user list:

  1. Navigate to the "Users" section on the left side menu
  2. Choose "User Sync with Google Workspace"
  3. Sign in with Google Admin account
  4. Allow myViewBoard to access your Google Account
  5. Choose to sync "All User", a "Group", or a "Unit"
  6. Click "Keep Previous" to keep any previous users (deselecting this will wipe all existing users during the user sync)
  7. Click "Apply" to sync users.


User Sync with SAML and SCIM

User Sync with SAML

To set up SAML with myViewBoard:

  1. First set up Single Sign-On via SAML. You can do this in the "Single Sign-On" section of Entity Management (#7 in the above image).
  2. Choose SAML from the drop-down menu
  3. Fill in SAML URL, Logout Redirect and SAML Certificate
  4. Use Endpoint Login URL to sign in with SAML verification
  5. Set Audience URL (Entity ID)
  6. Set Assertion Consumer Service (ACS URL)
  7. Set Recipient URL in server settings
  8. Click to confirm.


User Sync with SCIM

To set up SCIM with myViewBoard:

  1. First set up Single Sign-On via SCIM. You can do this in the "Single Sign-On" section of Entity Management (#7 in the above image).
  2. Choose SCIM from the drop-down menu
  3. Download SCIM Instruction and follow steps from the documents
    1. Sign in to the Active Directory admin center
    2. Click Enterprise applications from the left panel
    3. Click New application
    4. Select Non-gallery application
    5. Enter a name for your application and then click Add to create
    6. In the application management page, click Provisioning and then click Get started
    7. In Provisioning Mode field, select Automatic
    8. Copy the URL and token from myviewboard.com and then paste them in Tenant URL and Secret Token
      • Click Test Connection to have Azure Active Directory try to connect to the SCIM endpoint. If the test fails, error information will be displayed.
      • If the test succeeds, click Save to save the admin credentials.
    9. in the Mappings section, there are two sets of attribute mappings: one for users object and one for groups objects. Select each one to review the attributes that are synchronized from Azure Active Directory to myViewBoard.
    10. Under Settings, the Scope field defines which users and groups are synchronized. Select Sync only assigned users and groups (recommended) to only synchronize the users and groups assigned in the users and groups objects.
    11. Once your configuration is complete, set the Provisioning Status to On.
    12. Click Save to start the Azure AD provisioning service and the synchronization will be executed automatically with the defined Provisioning interval.



Managing users

The initial account created for the entity is an Owner account. This has admin rights and cannot be changed. For all other users, myViewBoard has two types of roles:

  1. User: a standard user without access to the Entity Management console.
  2. Admin: has access to Entity Management to change settings.


These roles can be configured by selecting Users in the left side menu, and then clicking the drop-down menu in each user row.

Also in this row there are buttons to Entity Management Reset Password.svg Reset Password for a user, and Entity Management Delete user button.svg Delete a user.


Clicking on a user reveals activity logs for that user.

Software instances

What is a software instance?

A software instance is any instance of installation of Whiteboard (both Android and Windows versions). If the Whiteboard software is deleted and reinstalled, it will count as a separate instance as it will have to be enrolled again (requiring a new name and ID).




How to install instances of Whiteboard

Whiteboard can be downloaded from the myViewBoard website [1]. This page link includes MSI files for Windows, and APK for Android. The Android version can also be downloaded and installed from the Google Play store (search "myViewBoard Whiteboard"). Likewise, the iOS version can be downloaded and installed from the App Store (search "myViewBoard Whiteboard").

If using a ViewSonic ViewBoard, Whiteboard is likely preinstalled on the inbuilt Android OS.

Installing Whiteboard
On Windows On Android On iOS/macOS
End user Manual installation of MSI file from myViewBoard website Manual installation of APK file from myViewBoard website
Download from Google Play store
Download from the App Store
IT admin
  • Remote and background installation using Group Policy
  • Command Prompt msi install (see below)
Unnecessary for ViewSonic ViewBoards as Whiteboard comes preinstalled Currently, no IT support required


MSI installation script


Whiteboard for Windows is installed from an MSI file. This can be installed in batches or as a background process by, for example, using Microsoft Group Policy, SCCM, Microsoft Endpoint Manager, and third-party deployment software methods. However, these methods are not within the scope of these instructions.

Alternately, use Command Prompt (as administrator). If you do not know how to run "Command Prompt" as an administrator, please view this website.

Execute the following to install to the device:

   msiexec /qn /i $[MSI_PATH] VIEWBOARDNAME=$[VIEWBOARD_NAME] PURPOSE=$[PURPOSE] ORGANIZATION=$[ORGANIZATION]
Argument Description Required? Note
PURPOSE "Business" or "Corporation" or "Education" Yes This applies the theme for Whiteboard. If not set, the default is Education. Can be changed by users after installation.
ORGANIZATION Enter organization (entity) name. Yes If the organization is registered, the installer will automatically fill in the email address of the entity administrator, which cannot be modified. The instance will be linked to the myViewBoard entity and appear in the Entity Management console.
DOT_NET Indicates whether to install .NET framework. No Supported in v2.36.4.0 and above. Set DOT_NET = FALSE if these components are already installed on a device. If no argument is set in such a case, installation errors may occur.
VC_RUNTIME Indicates whether to install Microsoft Visual C++ redistributable packages. No Supported in v2.36.4.0 and above.

Command Prompt: msiexec options

  • /qn Specifies silent mode installation (no UI during installation).
  • /i Specifies normal installation, requiring a user to input settings manually.
  • For further parameters, see the msiexec guide.

If you are uncertain how to execute MSI installation via Command Prompt, we recommend enrolling your Whiteboard instances via entity user email. IT Admin should ensure all necessary users have been added under the Entity first, and then end users can enroll Whiteboard simply by signing in. For more information, review the adding users section above.


How to enroll software instances

If instances of Whiteboard are installed using the msi Command Prompt or Group Policy methods (see above), and the organization is correctly entered to match that of an existing entity, enrollment is automatic and no other manual action is required.

End users who install Whiteboard manually themselves can enroll the software instance of Whiteboard after opening it and viewing the Settings -> software information tab.


Warning.svg When enrolling instances of Whiteboard (for iOS and Android), make sure to use your myViewBoard email within your entity domain. This will ensure the software instance is automatically registered to that entity and will appear in Entity Management. Any user email address that is registered in the entity user list can enroll the software.


Method 1: Enroll instances with Whiteboard Enrollment Form (any entity user)
  1. The end user installs the instance of Whiteboard for Android or iOS to their device (link to download page).
  2. Open the software and sign in with your myViewBoard account.
  3. Click settings and click the i button for the software information tab.
  4. Click Enroll Software Instance under Entity.
  5. Complete the Whiteboard Enrollment Form by entering a Whiteboard name and a myViewBoard email address.
  6. After inputting the email address, await detection of the corresponding entity.
  7. A prompt should appear informing you of successful enrollment.


Method 2: Enroll instances with Whiteboard Enrollment via QR Code (Entity Admin only)
  1. The end user installs the instance of Whiteboard for Android or iOS to their device (link to download page).
  2. Open the software and sign in with your myViewBoard account.
  3. Click settings and click the i button for the software information tab.
  4. Click Enroll Software Instance under Entity.
  5. On the Whiteboard Enrollment Form, click Enroll via QR Code.
  6. Open the Companion app (make sure to be signed in with your Entity Admin account).
  7. Tap the QR code icon to open the scanner.
  8. Scan the QR code displayed on Whiteboard with your mobile device.
  9. On your mobile device, ensure you select your desired entity.
  10. Click Submit.
  11. A prompt should appear on Whiteboard informing you of successful enrollment.


How to create and assign groups of software instances

Instances can be grouped together for administrative convenience. This allows settings and jobs to be applied in bulk.

  1. First, click Software Instances from the side menu on the left of the Entity Management console. The new page will show a list of all instances registered in the entity. There are two ways to create a new group:
Option 1: click the checkbox next to all instances you wish to group. Then click the Entity management move.svg icon followed by Entity m template add.svgnew group. Enter a name for the group and click Create Group to finalize.
Option 2: from the side menu on the left, click Entity management group 111 .svgGroups, and then Entity m template add.svgnew group. Enter a name for the group and click Create Group to finalize.


Templates

A settings template can be made and applied to software instances in bulk. Settings that can be applied include:

Automatically check for updates and notify users (in-app only) when there is an update available.
Enable/disable local saving.
Enable/disable sign-in.
Enable/disable the embedded browser.
Set auto sign out duration.
Configure background.
Configure foreground.



How to create a template

  1. First, click Templates from the side menu on the left.
  2. Click Entity m template add.svg new template.
  3. Enter a template name and click next.
  4. Configure the settings for the template.
  5. Click Add to confirm.

How to add instances to a template

  1. Click the template from the drop-down menu under Templates on the side menu on the left.
  2. In the panel that appears on the right, click the 123.svg add icon.
  3. Select all instances you wish to apply the template to and click add.

To remove instances from the template, select the instances from the right panel and click Bx-reset.svg Reset to default.


Display instances

myViewBoard Display for Android and Windows turns a device into a wireless display, with presenters able to share their screen via myviewboard.com/display/. The Display Instances panel within the Entity Management console allows Admin to assign Display Advanced licenses to instances installed on Android or Windows.

How to install instances of Display

Display comes preinstalled on ViewBoards and ViewBoard Boxes, but it can also be downloaded for free from https://myviewboard.com/download/ for Android and Windows devices, and from the Amazon app store.

Review the system requirements sections of the Android and Windows pages for more information.

How to enroll instances of Display

After installation, IT Admin have the option to enroll the device.

To enroll a given Display instance, follow these steps:

  1. Launch Display on the desired device.
  2. A QR code will appear on the landing screen. IT Admin must scan the QR code with their Companion app.
  3. On the Companion app, ensure the correct entity is selected (if applicable).
  4. On the Companion app, click Submit.
  5. The Display landing page on the device should now no longer show the enrollment QR code.

The enrolled Display instance will now be listed in the Display instances console, which is accessible through the Entity Management console.

Assigning Display Advanced licenses to devices

In order to provide Display end users with access to Display Advanced features, licenses must be assigned to specific instances of Display.

To assign Display Advanced licenses to devices:

  1. Sign into https://myviewboard.com.
  2. Click the Entity Management tile.
  3. Click Display on the left-side menu.
  4. The Display software instances console will load.
  5. Locate the Display instance to which you want to assign a license. You will identify the instance by its corresponding Display Code.
    1. Browse the list, looking for the row with the corresponding Display Code.
    2. Or enter the instance's display code into the search bar at the top-right of the list table to filter for the instance.
  6. Check the box on the row with the corresponding display code.
  7. Click the Advanced licenses icon Display advanced license assign.svg on the top toolbar.
  8. This Display instance should now be assigned with a Display Advanced license. You will see AdvancedDisplay advanced license assigned.svg appear in the Mode column for this instance.
  9. Continue assigning licenses, with the option to assign multiple licenses at once.
Reassigning licenses
At any time, licenses can be revoked from a given instance and reassigned to a different instance. However, if you need more licenses than you currently have to assign, you will have to purchase more Display Advanced licenses.
You can view the total number of licenses you have available to assign within the Display instances console (as well as the expiration date of your subscription to these licenses).

With Advanced licenses now assigned to your preferred instances, Display app users can now access Display Advanced features.



Learn more 990000.svg Learn More

Access online resources to learn more about myViewBoard.


Social media 990000.svg Social Media

Follow us on social media and get notified of the latest news and updates.


Facebook-square.svg Facebook
Twitter-square.svg Twitter
Instagram.svg Instagram
Linkedin-square.svg LinkedIn
Youtube-play.svg YouTube channel

Learn more 990000.svg Learn More

Access online resources to learn more about myViewBoard.


Social media 990000.svg Social Media

Follow us on social media and get notified of the latest news and updates.


Facebook-square.svg Facebook
Twitter-square.svg Twitter
Instagram.svg Instagram
Linkedin-square.svg LinkedIn
Youtube-play.svg YouTube channel
Powered by
MyViewBoard Logo.svg
Built by
Logo.png

Disclaimer: All other trademarks are the property of their respective owners.

Powered by
MyViewBoard Logo.svg
Built by
Logo.png