Validating Prerequisites

Before installing VConnect resource provider, it is advised to validate the prerequisites to ensure successful deployment.

HOST VM

On AzS Development Kits, sign in to the physical host.

On multi-node integrated systems, the host must be a system that can access admin and tenant endpoints.

  1. Open a new elevated (administrative) PowerShell console and change to the directory where the files have been extracted (c:\CloudAssert\VConnectMSM). Use a new window to avoid problems that might arise from incorrect PowerShell modules that are already loaded on the system. If you don't have this installer please reach out to our team and we will provide you with latest installer and trial license.

  2. Ensure 2 certificate files (.pfx and .cer) [as in Prerequisites -> Certificate section] are present in the Cert folder as follows:

  • The file name must not contain any special characters

  • Only a *.cer and *.pfx exists in this Cert folder

  • The certificates must be placed in this folder every time before retrying the deployment

3. Backup the Cert folder, in case we have to retry the deployment need the files to be replaced here

4. Run following command to validate the prerequisites.

.\InstallVConnect.ps1 -ValidateOnly

5. Provide the service admin credentials that has access to the default provider subscription ID.

Service Admin Credentials

6. Enter the default provider subscription ID.

Default Provider Subscription ID

7. Enter admin ARM endpoint.

Admin ARM Endpoint

8. Enter directory tenant name in which the service administrator account resides.

Service Admin Directory Tenant Name

9. Enter the tenant subscription ID where the Cloud Assert resource provider components will be provisioned.

Service Tenant Subscription ID

10. For the following prompt, If the service admin account has access to the tenant subscription ID, type 'Y' or type 'N' if the tenant subscription ID is only accessible by a different user.

Steps 11 & 12 will be only prompted if 'N' is typed in step 10

11. Enter the service tenant account credentials.

Tenant User Credentials

12. For the following prompt, type 'Y' if the service admin account and service tenant account reside in the same directory tenant. Typing 'N' will open another prompt to get the directory tenant name of the service tenant user.

13. Enter user name and password for the VM that will be created during the deployment. These credentials can later be used to access the VM.

Resource Provider VM Credentials

14. To configure multi-stamp capabilities, type 'Y' and 'N' to skip.

Configure Multi Stamp Management

15. To configure Billing service and it's dependent components within the VConnect VM type 'Y', type 'N' to skip.

Setup Billing Service in VConnect VM

16. To setup SQL server within VConnect resource provider VM, type 'Y'. If the SQL server is setup externally, type 'N'. If opted to setup SQL server within VConnect resource provider VM, When prompted to use default SQL port number (1433), type 'Y' or type 'N' to configure port number.

17. The following prompt to get the Billing API service credentials will appear only if 'Y' is types in step 15. The credentials will be set to the Billing API service during the deployment.

Credentials for Billing API Service

18. The following prompt will appear to get the SQL server name only if 'N' is typed in step 16.

Supported SQL server input formats:

E.g.: '192.168.102.100', '192.168.102.100,1435', '192.168.102.100\SqlInstane' & '192.168.102.100\SqlInstance,1435'

19. Enter the SQL server credentials to access the server. If the SQL server is yet to be setup within the VConnect VM (option to set it up in step 16), these credentials can later be used to access the SQL server in VConnect resource provider VM.

SQL Server Credentials

20. By default, the installers will create databases with name 'CloudAssert.VConnect', 'CloudAssert.Billing' and 'CloudAssert.DACM'. Type 'Y' to use the same database names or type 'N' to specify different database names. The databases will be created during the deployment if it is not already created.

21. By default, the installer will try to deploy the VConnect resource provider using Windows Server 2016 Datacenter VM image. To use a different image, type 'N' in the following prompt and provide the image SKU, offer and publisher in the prompts that follow. Type 'Y' to use the default image.

22. Type 'Y' if the stamp is disconnected and 'N' if it is connected.

23. Enter the password for the .pfx file in step 2.

24. Type 'Y' to validate SMTP settings which will be used post deployment to configure.

25. Enter the SMTP host name.

SMTP Host

26. Enter SMTP credentials

SMTP Credentials

27. Specify the email ID to which test email should be sent.

28. Specify the port used by the SMTP server.

SMTP Port

29. Specify if the SMTP server uses SSL for validation.

Use SSL

30. Type 'Y' to validate offline repository settings which will be used post deployment to configure.

31. Enter the shared folder path.

Shared folder path

32. Enter the credentials used to access the shared folder.

Credentials for accessing shared folder

Successful Validation

Once all the parameters are validated, the validation result will be visible in the PowerShell window. A 'InputParameters.dat' file will be created in the root folder which will be used for installing or uninstalling VConnect resource provider.

InputParameters.dat File