Deployment Options

Option 1: Install OKTOPUS to an image template (Windows and Mac)

1. Download and install OKTOPUS from the main downloads area to your image template. This will install the software and all necessary prerequisites.

2. Create an XML file called custom.xml with the following information. The XML tags are case specific. Product keys are not case specific and will be accepted whether they include the dashes or not, as shown:

<custom>
<installConfig>
<pKey>XXXX-XXXX-XXXX-XXXX</pKey>
<pKey>XXXXXXXXXXXXXXXX</pKey>
</installConfig>
</custom>

3. Enter your product keys, one on each line as above. Add as many lines as you require.

4. Save the file.
For Windows images, place this file in %PROGRAMFILES(X86)%\Qwizdom\AP Connect
For macOS images, place this file in ~/Library/Application Support.Qwizdom

Your image template now has everything you need for OKTOPUS to automatically activate when opened on the target machine.

Please Note: Do not open OKTOPUS after step 4 before deploying your image. Doing so will automatically activate the software and will cause it to fail an anti-piracy check on the target machines, force-closing the software.

Option 2: MSI and DMG Deployment

 Prerequisite Preparation

If your deployment software supports EXE files, you may prefer to download OKTOPUS from the main downloads area however please note that if you have multiple licenses and need to use the custom.xml method as documented below for automatic licensing, then you should use the MSI. You can also refer to the “Additional Information” section at the bottom of this page for supported switches.

Whether you are rolling out the EXE or MSI, OKTOPUS requires additional prerequisites not normally included within Windows. Run the EXE on a sample target machine to inspect which prerequisites are required (installation can be cancelled once the list is shown).

We strongly advise installing all latest updates for your Microsoft Products prior to installing Qwizdom OKTOPUS.

After ensuring that these prerequisites have been installed, download the installer you require for deployment. If your school or company uses the Qwizdom RF handsets or has licenses for QVR (Qwizdom Virtual Remote), deploy the OKTOPUS with Actionpoint installer. Otherwise, use the standalone version.

 

 

Deployment of the MSI
(How to roll out multiple keys for automatic activation)

Please Note:

  • The method where multiple keys can be rolled out is only supported by the MSI installer.
  • Computers must be online when OKTOPUS is opened to activate automatically. If the target computers are behind a proxy, activation may need to be carried out manually.

1. Download and extract the contents of the zip file above

2. After extracting the MSI download from above, look in Program Files > Qwizdom > AP Connect. Edit custom.xml to contain the required product key(s). Add as many tags as are necessary to hold the key information. Please note, the tags are case sensitive. Product keys are not case specific and will be accepted whether they include the dashes or not, as shown:

<custom>
<installConfig>
<pKey>XXXX-XXXX-XXXX-XXXX</pKey>
<pKey>XXXXXXXXXXXXXXXX</pKey>
</installConfig>
</custom>

3. Deploy the software using your deployment tool. The updated custom.xml file will be included in the rollout. On the target machine, when OKTOPUS is opened, it will read the custom.xml file and attempt to activate automatically using the first key it finds with an available activation.

Please Note: We do not supply instructions or support for any specific deployment tool.

 

Additional Information

Deploying EXE installers

If you prefer to deploy the EXE from the main downloads area, the following InstallShield switches are supported:

  • /L language ID
  • /S Hide installation dialogue. For silent mode use /S /v/qn
  • /V parameters to MsiExec.exe
  • UA
  • UW
  • /UM
  • /US

For more information see the InstallShield Help Article (external website)

Turn off auto-update (Windows Only)

Create this key in the registry of target machines to turn off auto-update

Key (32bit): HKLM\SOFTWARE\Qwizdom\Connect
Key (64bit): HKLM\SOFTWARE\WOW6432Node\Qwizdom\Connect
String value: AutoUpdate
Value: false

Download the DMG installer you require for deployment from the main Downloads area. If your school or company uses the Qwizdom RF handsets or has licenses for QVR (Qwizdom Virtual Remote), deploy the OKTOPUS with Actionpoint installer. Otherwise, use the standalone version.

Deploy the DMG with your normal deployment mechanism.

If you want OKTOPUS to automatically activate when a user opens it for the first time, create a custom.xml file as below and deploy to your target macs with a script to /Library/Application Support/Qwizdom

The XML tags are case specific. Product keys are not case specific and will be accepted whether they include the dashes or not, as shown:

<custom>
<installConfig>
<pKey>XXXX-XXXX-XXXX-XXXX</pKey>
<pKey>XXXXXXXXXXXXXXXX</pKey>
</installConfig>
</custom>