Navigate
Wasp Helpdesk
  • Register

  • or
  • Login
    Need a password reminder?
or
Contact Us
  • Get in touch

    Send us an email

  • Start a chat session

  • Knowledgebase Read help articles
  • News News & updates
  • Contact Us We are here to help
  • Training View our options
  • Portal
  • Knowledgebase
  • InventoryCloud Getting Started
  • Cloud On-Premise Install Quick Start Guide
Subscribe Download PDF

Cloud On-Premise Install Quick Start Guide

Nathaniel Summers
2023-01-19
in InventoryCloud Getting Started

Issue: Install process for AssetCloud or InventoryCloud On-Premise Software

Preparing to Install

1. System Requirements

Operating System: 64-bit, Windows 8.1, Windows 10 (Pro or higher), Windows Server 2012 R2 and Windows Server 2016 (or newer)
Cloud On-Premise is not compatible with the Home or Standard editions of Windows 10 or 11. It is compatible with Standard editions of Windows Server.
Memory: 8GB Minimum (16GB Recommended)
Free Disk Space: Min. 60GB HD Space, 256 GB recommended
Processor: Min. i7 2.8 GHz

**Note: There is a known issue with Windows 11 and SQL when using NVMe SSD hard drives. For more information, please refer to:
https://support.waspbarcode.com/kb/articles/1716

2. Verify the PC is NOT a Domain Controller

AssetCloud and InventoryCloud On-Premise should not be run on a Domain Controller.

3. Verify Local Admin User

The logged-in installing user must be a Local Administrator.
This user CANNOT be a Domain user.
A Domain Admin with Local Admin rights is insufficient.
There is not currently a workaround for this.
Installing as a domain user will cause the software to install incorrectly, if it allows it to install at all.

If you are unsure if your currently logged-in user is a Local Administrator, open a command prompt (Start > Run > Type: cmd > OK), type whoami and press enter. The result should be Domain\UserName. If you are logged in as a local account, the “Domain” will show as your PC Name instead.


OP-Install-001-Run.png

OP-Install-002-WhoAmI.png

**Note: In the example above, the PC Name is “win10v1903x64”.

4. Verify PC Name

When the software is installed, the PC it is installed upon will act as a web server hosting a website on that PC. The URL will be something like http://PCNAME:8702
Where “PCNAME” is the name of the PC you are installing the software on.
  • If you would like the URL to be different, rename the PC accordingly (before installation).
  • If the PC Name is longer than 15 characters, this will need to be shortened.
  • PC Names longer than 15 characters will not function properly.

5. Download the most recent installer

The disc from the box may have been burned at any time. The download link provided by your support or sales agent will be the most recent installer


6. Unblock the Zip file

Right-click on the zip file, select “Properties”.
If “Unblock” is present, check that check box (or click the button), then select “Apply”
If this is not done, the zip file will not contain all of the necessary files for the install.
OP-Install-003-Unblock.png
If “Unblock” is not present in the properties as shown above, then the file is already unblocked.


7. Extract the Zip file to the C:\ Drive

Many Downloads folders and Desktops are now on network drives (which can cause issues when installing SQL). Additionally, if troubleshooting must be done, this may require command-line work. The best way to prevent extra work is to extract the zip to the c:\ drive.


OP-Install-004-Extract.png
**Note, this is just the location of the installer, not the location the software will be installed.

8. Install the IIS Prerequisites

The following article covers the steps for installing the IIS Prerequisites:
https://support.waspbarcode.com/kb/articles/1525


9. Set the PowerShell Execution Policy

The following article covers the steps for setting the PowerShell Execution Policy:
https://support.waspbarcode.com/kb/articles/1510
An Execution Policy of Unrestricted or RemoteSigned will be necessary for the AssetCloud or InventoryCloud On-Premise installer to properly install.


10. Reboot, Update, and Verify All of the Above

Reboot the PC, and make sure to apply any pending Windows Updates.
Once logged back in as a local administrator, verify that all of the above is still correct. In some rare cases, the above changes might not have gone all the way through (particularly if the PC Name was changed, or the IIS Prerequisites didn’t fully install). Verify that this has been done prior to moving forward.


11. Verify the World Wide Web Publishing Service is Running

Open your list of services and verify that the service called “World Wide Web Publishing” shows the status of “Running”. If the status is blank, right-click the service and start it.
OP-Install-005-Services.png




Installing AssetCloud or InventoryCloud On-Premise

1. Where to Install?

Rather than installing on a temporary server, then moving the database to the final server, we recommend performing the installation on the Cloud OP's destination server.


2. Run the Installer as Admin

Navigate to the folder you previously extracted the installer to.
If the above directions were followed exactly, this location should be:
c:\WaspOnPremise\
Right-click setup.exe, then Run As Administrator.
OP-Install-006-SetupExe.png


3. Initial Installer Prompts You May See

During the install, there will be several components which will need to be installed.
OP-Install-007-Prompt1.png

If prompted to reboot, do so.
OP-Install-008-Reboot.png

If the installer does not start back up on its own, navigate back to that install path and run the installer as admin again.


4. This is a new setup.

OP-Install-009-NewSetup.png


5. Enter Your License Key

Enter your license key, validate, and select “Next”. Be sure to click in the left side of the License key box. If you click in the middle, the box will run out of space for characters.
OP-Install-010-EnterKey.png


OP-Install-011-Next.png

OP-Install-012-Agree.png

6. Select Express Install

Select Express and then Next.

OP-Install-013-Express.png

7. Verify Ports

Select “Verify Ports”. If all three ports are available, select “Install”.
OP-Install-014-Ports.png
*Note: If you are installing the Complete Edition, you may be presented here with the option to install SQL Express, or to install using your own SQL Instance.


8. Common Sticking Point

If you find that you have been stuck on a screen for a long time, verify that there are no windows that have popped up beneath this, by clicking the title bar and moving it out of the way:
OP-Install-015-MoveWin1.png

OP-Install-016-MoveWin2.png


9. Installing SQL Compact 3.5

After several command prompt screens, you will be presented with the installer for SQL Server Compact 3.5. This is used to facilitate communication between the software and Windows Mobile CE devices.
OP-Install-017-SQLc1.png

OP-Install-018-SQLc2.png

OP-Install-019-SQLc3.png

OP-Install-020-SQLc4.png

This will happen again for the 64-bit version of SQL Compact 3.5.

**Note: At this time, the install for SQL Compact Edition cannot be skipped. However, if you are not using Windows Mobile CE devices, this can be safely uninstalled (after the full Cloud OP installation completes) without affecting operations.


10. Installing SQL Express Instance

SQL Server Express should now begin to install
OP-Install-021-SQLe.png


11. Software Validates Itself

At this point, the software will run some checks to validate the install went smoothly. Several progress windows like this will appear as the software validates itself.


OP-Install-022-ValidateSelf.png


12. Install Finished (keep going after this)

After SQL installs, the install will validate itself. When finished, it will present you with this:
OP-Install-023-Finished.png


After Installing On-Premise

1. Reboot the PC

After installation is complete, reboot the machine.


2. Set IIS Performance Settings

Use the following performance settings to ensure the web interface will move as fast as possible with your system:
https://support.waspbarcode.com/kb/articles/1523


3. Bounce The Services, Sites, and Application Pools

This step is a common troubleshooting step (the equivalent of “Have you turned it off and back on again”). In this case, it is being used to verify that all the sites and services are present and operating as expected.

Stop and restart the services and sites, then recycle the application pools, using the instructions in the following article:
https://support.waspbarcode.com/kb/articles/1590
**Note: This easiest way to do this is by creating a BAT file as described in the article. Be sure to use the BAT file which is appropriate to your version number and edition of the software.


4. Validate Everything in the Wasp Config Tool

On your desktop should be a shortcut for the Wasp Config Tool.
Otherwise, you can navigate to:
C:\Program Files\Wasp Barcode Technologies\Wasp On-Premises Software\License\configure\Wasp.Installer.Configure.exe
**Note: Always right-click and Run this as Admin.
OP-Install-024-Config.png
  • On the SQL Tab: Validate the WaspConfig and WaspAuth databases
    In the bottom section “WaspTrack Database Connection”, copy/paste the Writer and Reader passwords from below into the appropriate box, then click each Update button.
    Username: dbo_Writer
    Password: db0-Wr1ter_P455w0rd
    Username: dbo_Reader
    Password: db0_Re4der-P455w0rd
    **Note: If you would like to set your own Writer and Reader user credentials, this is where you would do so.
  • Continue to validate each of the tabs from left to right. Some tabs will not have a validate button; those can be skipped.
  • For most users, one tab will be blank, depending on which product is installed. This is expected. For instance, if you have AssetCloud On-Premise (only), the InventoryCloud MVC tab will be blank. If you have InventoryCloud On-Premise (only), the AssetCloud MVC tab will be blank.
  • If there are any errors such as “A task was canceled”, wait for 30 seconds and attempt to validate again (this may need to be done several times).
  • Once all tabs are validated, save and exit the Wasp Config Tool.


5. Activate Your Product

Log in using the default admin credentials (seen in 12. Install Finished above). Then click “Ready to Activate? Click Here.”
This will open a new window with a ten-character machine key.
Send the following information for the person you would like the product registered under to techsupport@waspbarcode.com:
Proof of Purchase (receipt or invoice):
Name:
Company Name:
Email:
Phone:
Machine Key:
We suggest sending a screenshot with the machine key for confirmation.

Once Tech Support gets this information, they will respond with an activation key which can be entered on this page. While you are waiting for this key, the software will continue to work as a trial for up to 30 days.


6. Antivirus Exceptions

It is recommended to add the following folders as exceptions in your antivirus software to insure no critical files are deleted.
C:\Program Files\erl10.2
C:\Program Files\Microsoft SQL Server
C:\Program Files\RabbitMQ
C:\Program Files\Redis-3.0.504-64bit
C:\Program Files\Wasp Barcode Technologies
C:\ProgramData\Wasp Barcode Technologies
C:\inetpub\wwwroot\WaspAPI
C:\inetpub\wwwroot\Wasp_AC
C:\inetpub\wwwroot\Wasp_IC
C:\inetpub\wwwroot\WaspSTS

**Note: Depending on which product you installed, you will be missing the Wasp_AC or Wasp_IC folder. This is expected.


7. Adding Additional Users and SMTP Settings

The following article covers the process for adding your SMTP settings to send out new user invites, and alternately, how to add users without using SMTP:
https://support.waspbarcode.com/kb/articles/1571


8. Adding an Additional Binding in IIS for your IP Address

Mobile devices (such as the DR5, HC1, or your Mobile Phone) often have difficulty resolving PC Names across a domain. For this reason, we recommend adding an additional binding for your IP Address into IIS, and using this IP address as your Service URL on the mobile devices:
https://support.waspbarcode.com/kb/articles/1532
**Note: If you’re not using a mobile device, you can skip this step.


9. You're All Done!

You have successfully installed Cloud On-Premise

10. Note on Sample Data

The software installs with sample data already populated in the database. The intent of this is to allow users to begin exploring the software immediately with examples. When you are ready to use your own data, be sure to reset all data to get you to a blank slate. This can be done by navigating to: Settings > Reset > Erase All Data.
It is important not to skip this step, because failure to do so will result in this sample data showing up in your reports and audits.


Rate the quality of this page

This page was helpful :) :( This page was not helpful

Quick Jump
  • Wasp Helpdesk
  • Knowledgebase
  • News
  • Contact Us
Top
Helpdesk software provided by Deskpro