# 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**](https://www.cloudassert.com/Product/Microsoft-Azure-Stack-Hub/Multi-Stamp-Management-Free-Trial) and we will provide you with latest installer and trial license. 

    
2. Ensure 2 certificate files (.pfx and .cer) \[as in [Prerequisites](https://docs.cloudassert.com/azure-stack-hub-multi-stamp-management/installation/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](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MJkyIKdKiLS5_ahBkUI%2F-MJl0EDgUR539KQBO_Jo%2FAdminCreds.PNG?alt=media\&token=a88cdd94-6c35-4ba5-b7c5-8c4c378d78b3)

6\. Enter the default provider subscription ID.

![Default Provider Subscription ID](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MJkyIKdKiLS5_ahBkUI%2F-MJl12d6x3ZEamSafrnA%2FAdminSubId.PNG?alt=media\&token=34b21799-4002-4ab7-9889-26b9a452d5b9)

7\. Enter admin ARM endpoint.

![Admin ARM Endpoint](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MJkyIKdKiLS5_ahBkUI%2F-MJl2yZ3DdhEl57c5dh4%2Fadmin%20arm.PNG?alt=media\&token=5d3b94a5-f59e-4d0c-8e2a-f9f98b9384e4)

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

![Service Admin Directory Tenant Name](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MJkyIKdKiLS5_ahBkUI%2F-MJl3JL3ebagBB7k2gpc%2Fservice%20admin%20directory%20tenant%20name.PNG?alt=media\&token=b23cc7d4-c769-428a-8542-d1acbf3d6954)

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

![Service Tenant Subscription ID](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MJkyIKdKiLS5_ahBkUI%2F-MJl4JkCtGZMdWKlwNmM%2FService%20tenant%20sub%20id.PNG?alt=media\&token=c2e6fa26-958f-4d49-829a-4133ae23e147)

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.

![](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MJkyIKdKiLS5_ahBkUI%2F-MJl5QqiduxtD_tWe0hw%2Fuse%20admin%20login%20for%20tenant.PNG?alt=media\&token=c4d0e5f6-7e36-48be-b3a5-7472a338b294)

{% hint style="info" %}
Steps 11 & 12 will be only prompted if 'N' is typed in step 10 
{% endhint %}

11\. Enter the service tenant account credentials.

![Tenant User Credentials](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MJkyIKdKiLS5_ahBkUI%2F-MJl5jHxYJ_3XBeuDshS%2FTenantCreds.PNG?alt=media\&token=15a866e1-5d17-4bc5-829e-afede1a78464)

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.

![](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MJkyIKdKiLS5_ahBkUI%2F-MJlAJ1OLOnKsSlpapG2%2Fsame%20directory%20tenant.PNG?alt=media\&token=44392a31-234e-4e8b-96cf-f034c87bf400)

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](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MJkyIKdKiLS5_ahBkUI%2F-MJlAf9V2OKkAsw_c2Kr%2FRpVmCreds.PNG?alt=media\&token=5e7fd3ee-6f6f-4a81-8dea-97b10d1529af)

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

![Configure Multi Stamp Management](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MJkyIKdKiLS5_ahBkUI%2F-MJlB5fvdqeeAslee2IO%2Fconfigure%20msm.PNG?alt=media\&token=d0806bd4-fe43-4a45-87e0-a02974d4f442)

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](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MJkyIKdKiLS5_ahBkUI%2F-MJlBWGiMqaLY8PaE29v%2Fsetup%20billing%20and%20dacm.PNG?alt=media\&token=1ecbd896-3d23-41af-af7a-61bfcda06b1e)

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. 

![](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MJkyIKdKiLS5_ahBkUI%2F-MJlC6t0zQtWIgXI0cD0%2Fsetup%20sql%20in%20Rp.PNG?alt=media\&token=d441a358-0be2-4645-a25c-c618325ca30a)

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](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MJkyIKdKiLS5_ahBkUI%2F-MJlCcn693AmvbdbJZYS%2FBillingApiCreds.PNG?alt=media\&token=9c0a7a07-bb05-4ec9-a53b-ed8a096e3573)

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

{% hint style="info" %}
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'
{% endhint %}

![](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MKKKqk2aHSK3MMYOBpH%2F-MKKVCF4G2G8pGFqN4Kj%2Fsqlport.png?alt=media\&token=2ce60d5a-2a3f-4344-b222-9bcda1f18669)

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](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MJkyIKdKiLS5_ahBkUI%2F-MJlDgMWupmgeFDbkZyW%2FSqlCreds.PNG?alt=media\&token=62aba6a6-2e87-4ab1-92e7-e62149373ea4)

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.

![](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MKKVT8e8wsHYbPUeUEg%2F-MKKWzzdpbqaAP-C8p7X%2Fdefaultdb.png?alt=media\&token=6ee33522-b6a1-44fc-9e8c-12243c48661c)

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.

![](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MJkyIKdKiLS5_ahBkUI%2F-MJlKNmkGJk8pkOBrfDV%2Fdefault%20VM%20image.PNG?alt=media\&token=864dab9c-4feb-46cd-8a10-52a923961e92)

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

![](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MJkyIKdKiLS5_ahBkUI%2F-MJlKbCI8WF2vvklpZQr%2Fis%20disconnected.PNG?alt=media\&token=2165edbb-bd2e-4889-933d-4ed7d8d83cfc)

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

![](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MJkyIKdKiLS5_ahBkUI%2F-MJlL2qk5eImlWaoxBSk%2Fpfx%20pass.PNG?alt=media\&token=31865920-922b-4b89-9561-7cefce728b68)

24\. Type 'Y' to validate [SMTP settings](https://docs.cloudassert.com/azure-stack-hub-multi-stamp-management/installation/configuration/configure-smtp-settings) which will be used post deployment to configure.

![](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MKEn-T3uilO3nkZyjdu%2F-MKEqIETig8zpd3RbkPw%2Fvalidatesmtp.PNG?alt=media\&token=13b3f987-e92d-473e-b0eb-df3bd80ec80c)

25\. Enter the SMTP host name.

![SMTP Host](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MKEn-T3uilO3nkZyjdu%2F-MKEqqEaO_KZwvizmkns%2Fsmtphost.PNG?alt=media\&token=9c76d9a6-08ce-4abc-81af-5e6903a2c4ef)

26\. Enter SMTP credentials

![SMTP Credentials](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MKEn-T3uilO3nkZyjdu%2F-MKEr25RIGfYQBIUybmB%2Fsmtpcreds.PNG?alt=media\&token=e7c96fe8-4f8d-4d11-92de-1d681cf28cb9)

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

![](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MKEn-T3uilO3nkZyjdu%2F-MKErgLprOH-30j1DFZ9%2Fsmtpto.PNG?alt=media\&token=07373246-186a-4115-ac05-c88e5cdb0663)

28\. Specify the port used by the SMTP server.

![SMTP Port](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MKEn-T3uilO3nkZyjdu%2F-MKErE1VILRAYE2OlfWI%2Fsmtpport.PNG?alt=media\&token=bb902eca-59d0-47f9-a4b7-41c21eda701f)

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

![Use SSL](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MKEn-T3uilO3nkZyjdu%2F-MKErPv7-ih4DUUdKxiF%2Fusessl.PNG?alt=media\&token=7b6bac5b-9041-498d-baa1-03d663aab3f1)

30\. Type 'Y' to validate [offline repository settings](https://docs.cloudassert.com/azure-stack-hub-multi-stamp-management/installation/configuration/configure-offline-marketplace-download) which will be used post deployment to configure.

![](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MKEn-T3uilO3nkZyjdu%2F-MKEsDMYNxtRoBfd3hrU%2Fofflinerepo.PNG?alt=media\&token=5c0e9cd0-eb99-4607-b669-af0e2e8511d1)

31\. Enter the shared folder path.

![Shared folder path](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MKEn-T3uilO3nkZyjdu%2F-MKEsYxVVxd9OLTJxng3%2Fsharedpath.PNG?alt=media\&token=7f6ad2f1-b7ff-45d0-a6ce-0be7a0d7bdd0)

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

![Credentials for accessing shared folder](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MKEn-T3uilO3nkZyjdu%2F-MKEsMtCpwbL80nyxaqD%2Fsharedcreds.PNG?alt=media\&token=6b403e9d-a819-4c12-abb5-de42209fe165)

### 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.

![](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MKEn-T3uilO3nkZyjdu%2F-MKEsmQyCtbF4Qx0XTv2%2Fvalidationcomplete.PNG?alt=media\&token=60601e90-5412-4899-91c7-69d15376ee06)

![InputParameters.dat File](https://2459906120-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6voWNOkQYKxJnx1zI4%2F-MJkyIKdKiLS5_ahBkUI%2F-MJlLh33GhaD88Jh3KVr%2Fdatfile.PNG?alt=media\&token=230acdc8-5b91-44ba-9caa-b4c31c46afd2)