Installing the WAPT management console

Note

  • managing WAPT is done mainly via the WAPT console installed on the Administrator’s workstation;
  • the Administrator’s computer must be joined to the Organization’s Active Directory;
  • the host name of the Administrator’s workstation must not be longer than 15 characters. This is a limit of sAMAccountName attribute in Active Directory;
  • the Administrator’s computer will become critical for WAPT administration and WAPT packages testing;
  • if DNS records are properly configured, you should be able to access the WAPT web interface by visiting: https://srvwapt.mydomain.lan;

Downloading and launching the installation of the WAPT console on the Administrator’s computer

Attention

Warning, the WAPT console MUST NOT be installed on your Windows based WAPT Server.

The WAPT console must be installed on the workstation from which you manage your network.

WAPT Server web interface

WAPT Server web interface

  • if DNS records are properly configured, you should be able to access the WAPT web interface by visiting: https://srvwapt.mydomain.lan;
  • click on WAPTSetup link on the right-hand side of the WAPT Server web page;
  • start the executable installer as Local Administrator on the Administrator’s workstation;
  • choose the language and click on OK to install the WAPT console;
Choose the language for WAPT

Choose the language for WAPT

  • click on OK to go on to the next step;
Accept the WAPT license terms

Accept the WAPT license terms

  • accept the licence terms and click on Next to go to next step;
  • choose the WAPT destination folder (C:\Program Files (x86)\wapt by default);
Choose the WAPT destination folder

Choose the WAPT destination folder

  • click on Next and choose your installation options (default value should be right for most installations);
Choose the installer's options

Choose the installer’s options

Note

  • check Install WAPT service if you want to have the WAPT service running on your Administrator workstation;
  • check Launch notification tray upon session opening if you want to have the WAPT icon running in the tray by default;

Setting up the WAPT Server URL

Hint

Here, two choices become available to you, you may choose to be guided by the configuration wizard and go directly to Using the WAPT console, or you may choose to continue manually with the configuration.

Choose the WAPT repository and server

Choose the WAPT repository and server

Note

Example:

  • choose the language and click on OK to install the WAPT console;
  • click Next and then Install to launch the installation, wait for the installation to complete, then click on Finish (leave default options);
Installation Wizard has finished

Installation Wizard has finished

Note

  • check Register this computer onto WAPT server to register the computer with the WAPT Server;
  • check Update the list of available package on the main repository to download the list of available packages from the WAPT repository;

Configuring the verification of certificates

Attention

  • it is highly recommended for security reasons to keep HTTPS validation enabled;
  • HTTPS certificate validation ensures security, for more information please refer to this documentation on HTTPS certificate verification;
  • for a first time trial of WAPT, it is simpler not to enable this options. This security feature may be enabled later on;

To enable SSL/ TLS certificate validation of WAPT agent connections to the WAPT Server, use the following command in a cmd.exe shell with Local Administrator elevated privileges:

wapt-get enable-check-certificate
net stop waptservice
net start waptservice

Hint

HTTPS certificate validation ensures security, for more information please refer to the documentation on verifying certificates.

  • check that the HTTPS certificate is valid using the following command line:
wapt-get update -f

Starting the WAPT console

  • launch the WAPT console by looking for the binary C:\Program Files (x86)\wapt\waptconsole.exe
  • on first start, you must start the WAPT console with elevated privileges. Right-click on the WAPT console binary ‣ Start as Local Administrator;
  • log into the WAPT console with the SuperAdmin login and password;

New in version 1.5: Enterprise

Alternatively, you may choose to connect with an account that is a member of your Active Directory waptadmin security group (this behavior will work well if you have activated Kerberos on your WAPT Server).

WAPT Server connexion form

WAPT Server connexion form

if you have any issue logging into the WAPT console, please refer to the FAQ: Error message when opening the WAPT console;

Note

A message may appear indicating that your WAPT agent version is obsolete or not yet present.

Mismatch error between the versions of the console and that of the agent

Mismatch error between the versions of the console and that of the agent

Go to the next step to create your certificate!!