Skip to main content

How to deploy SquaredUp DS Standalone from the Azure Marketplace

Documentation Team
  • Updated

How to deploy SquaredUp DS Standalone from the Azure Marketplace

Which installation method should I choose?

There are a couple of options for installing SquaredUp DS Standalone:

  • Deployment via the Azure Marketplace

  • Installation via the installer

Use the installer if you don't want to use the Marketplace (for example, because you want to install SquaredUp DS Standalone in AWS or an on-prem machine).

For step-by-step information about installing DS Standalone using the downloadable installer please see How to install SquaredUp DS Standalone using the installer

What you need

  • An Azure Active Directory account that can deploy applications to Azure Active Directory (AD).

Where to deploy

  • The Marketplace deployment will create a Windows virtual machine with the minimum requirements and lead you through the configuration process.

What we create

  • A virtual machine in your Azure tenant, running our web application and IIS, with a small data disk and a public IP address.
  • SquaredUp DS has a number of prerequisites that will be automatically installed by the setup process (e.g. the IIS Web Server role)

Azure Marketplace

  1. Browse to the Azure Marketplace using this link to deploy SquaredUp DS.

    Click here to register and we will email you a free forever license to get you started.

  2. If you have not already signed in, sign in with an Azure Active Directory account that can deploy applications to Azure AD.

  3. Click on the Get it now button.

  4. Enter your contact details and click Continue.

  5. Click the Create button.

  6. Select the Subscription you wish to use.

  7. Select an existing Resource Group, or create a new one.

  8. Select a suitable region, close to where most of the SquaredUp DS users will be located.

  9. Accept the suggested virtual machine name or rename if you prefer.

    Windows computer names cannot be more than 15 characters long in Azure, or contain special characters other than "-".

  10. The default virtual machine size suggested is based on a small test environment. If you are deploying for production use please select the appropriate virtual machine size required. See System Requirements, Server Spec and Sizing

  11. Click the Next button to move on to Administration.

  12. Here you need to enter details to create a new administrator account for the new Windows VM. You will not need this to use SquaredUp DS, but you will need it later to access the new VM, for example to update SquaredUp DS or view diagnostics logs.

  13. Click the Next button to move on to Networking.

  14. A public IP address is required and will be created automatically with the suggested label. Enter a domain name label for this virtual machine. This is the URL you will use to access SquaredUp DS for the first time.

  15. Click the Next button to move on to SSL.

    We recommend HTTPS to login to SquaredUp DS. For HTTPS you can either use a self-signed certificate, which may cause a browser warning that the website is insecure and users will need to explicitly agree to proceed, or you can use a Let's Encrypt® certificate.

    Using a Let's Encrypt certificate stops a browser warning appearing to users.

    If you choose to use a Let's Encrypt certificate then you need to provide an email address and agree to terms of service. The email is used to contact you if there is a problem with the renewal of the certificate. The Let's Encrypt certificate is valid for 90 days, but it will renew automatically every 55 days, as long as it is accessible through port 80, as that is how the http challenge is conducted.

    To install the Let's Encrypt certificate a self-signed certificate is temporarily installed, so a browser warning may appear in the first 2 minutes before the Let's Encrypt certificate is applied.

  16. Click the Next button to move on to Tags. It can be useful to tag resources now, or you can do this later in the Azure console.

  17. Click the Next button to move on to Configuration. Click on the URL displayed, which will open a new tab. The resource cannot be reached straight away because it hasn't been created yet, but once it has been created following this Marketplace deployment you will need to go to this address to complete the SquaredUp DS setup process.

  18. Click the Next button to move on to Review + create.

  19. Check the details and click the Create button to agree to the terms and create the virtual machine.

You will see a message that the deployment is underway. This may take a few minutes.

 

Logon to SquaredUp DS for the first time

Browse to the VM you created by using the new tab you opened from the Marketplace link.

Alternatively, browse to https://DNSName. You can find the DNS name by browsing to the VM in the Azure portal, click the Go to resource button and copy the name of the virtual machine.

If you are using a self-signed SSL certificate so you will see a browser warning and will need to explicitly agree to proceed. In Chrome this is done by clicking Advanced.

Before you can get started, SquaredUp DS has to complete some final configuration of your environment, which includes activating your license.

SquaredUp DS setup wizard

  1. Log in to SquaredUp DS as an administrator user.

  2. Paste in your activation key, and click Activate.

    You will have received your activation key by email following your request for your free forever license.

    If you have not received a license key please contact SquaredUp Support.

    If your server is not connected to the internet (or the online activation didn't work because of proxy settings) click offline activation (see How to activate your license offline (manual activation))

    If you have any problems activating see Troubleshooting licensing and activation or contact SquaredUp Support

  3. Click Import to install a set of pre-built dashboards to help you get started using SquaredUp DS.


  4. Setup is now complete and the Getting Started page will be displayed.

Next steps

  1. Take a look at the SquaredUp DS Getting Started playlist on YouTube.
  2. Invite users to view a SquaredUp DS dashboard: How to share a dashboard
  3. Manage which users can access SquaredUp DS: How to manage Named Users
  4. Set up a SquaredUp DS administrator(s). To manage SquaredUp DS you will need to be a SquaredUp DS administrator, see How to make a user a SquaredUp DS administrator
  5. Give dashboard authors permission to create dashboards. A SquaredUp DS administrator will need to give users or groups author permission to a Team Folder, within which they can create and edit dashboards. See Team Folders
  6. Get access to your API data: How to add a Web API provider
  7. Configure Open Access dashboards. Open Access enables easy sharing of dashboards, that do not require authentication to view. See Sharing Dashboards with anyone - Open Access
  8. Create your first dashboard: How to create a dashboard

Troubleshooting SquaredUp DS deployment

Submit a request

If configuration fails, a large volume of diagnostic text will be produced, followed by a red failure message. If you experience this, please contact SquaredUp Support and we can help diagnose the cause.

Note that the diagnostic text may reveal sensitive details - such as your username, installed AD applications and IDs. Please be conscious of this when sending us details - for example, it is not appropriate to send us this text over email.

 

Related articles

Comments

0 comments

Please sign in to leave a comment.