# VConnect

1. Download the below installers and extract Vconnect.Zip file <https://cloudassertdownloads.blob.core.windows.net/vconnect/2.1.7/2.1.7.1/CloudAssert.WAP.VConnect.AdminExtension.Setup.msi> <https://cloudassertdownloads.blob.core.windows.net/vconnect/2.1.7/2.1.7.1/CloudAssert.WAP.VConnect.TenantExtension.Setup.msi> <https://cloudassertdownloads.blob.core.windows.net/vconnect/2.1.7/2.1.7.1/Tool.zip>
2. Install CloudAssert.WAP.VConnect.Service.Setup.msi
3. Update the Password in web.config of VConnect (Path: C:\inetpub\MgmtSvc-CloudAssert-Vconnect\Web.config). Password for dev purpose - CAAAANHhnqvpWD0oTkgG9K3lgho2t0PJl+Cvrj+lcgJWzj1CLQfKxJLhlxI=
4. Create database for VConnect
5. Execute the below command to update the database

   1. Navigate to the VConnect folder (extracted from VConnect.zip file)
   2. Execute the below command from command prompt

   `VConnect.exe UpdateDatabaseSettings {DB_SERVER_NAME} VConnect {DB_USER_NAME} {DB_PASSWORD} /isUseIntegratedSecurity:false /VConnectApiEndpoint:http://localhost:31101 /VConnectApiUserName:cloudassertadminuser /VConnectApiPassword:pass@word1`
6. &#x20;Insert queue URL in VConnect database. **Note:** This step is not required if VConnect is installed only for Work flow or Service notification handler is used
   1. Update shared access signature of Azure storage account queue in the below insert script and execute in VConnect DB. **Note:** Azure storage account queue is one of the prerequisites.`insert into [VConnect].[dbo].[AppSettings] ([Key], [Value],  [Group], UpdatedByUser, LastUpdatedTime, IsEncrypted) Values('ServiceNotificationQueueSasUri', '{queueUrl}', 'HybrSettings', 'Admin', GetDate(), 0)`
7. **VConnect - Service Notification Handler settings**
   1. Set below app settings with appropriate values
   2. If wanted to use the Service Notification Handler, set the `HybrApiEndpoint` as  [`https://local.admin.hybr.com/`](https://local.admin.hybr.com/) and set  `HybrServiceNotificationEventSource` setting to `trisulapi`

      OR

      If wanted to use the Azure Storage Queue, set `HybrServiceNotificationEventSource` setting to `azurestoragequeue` and give the Azure storage queue SAS URI for the setting `ServiceNotificationQueueSasUri`
   3. Add Hybr endpoint in etc/host file
   4. Setup event notifications for VConnect and Hybr Core components

{% file src="<https://2699384464-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LoVCDjvSJF03p2a5huX%2F-Lzpm4-PYZM70sX_xneP%2F-LzppzHZvKC0Ws0UZu8P%2FVConnect-setup-event-notification.bat.txt?alt=media&token=71f008c9-953f-43f6-acf8-c0d6b2b729fd>" %}
VConnect - Setup Event Notification
{% endfile %}

{% file src="<https://2699384464-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LoVCDjvSJF03p2a5huX%2F-Lzpm4-PYZM70sX_xneP%2F-LzpqhpPrLtPWuIrxnT7%2Fsetup-event-notification-for-hybr.txt?alt=media&token=9c383ff4-3c60-45ef-80db-4ee3ddd92f4a>" %}
Hybr Core - Setup Event Notification
{% endfile %}

| **Settings Name**                  | **Group**    | Value                               |
| ---------------------------------- | ------------ | ----------------------------------- |
| HybrApiEndpoint                    | HybrSettings | ex: <https://local.admin.hybr.com/> |
| HybrApiKey                         | HybrSettings | ex: hybrapiuser                     |
| HybrApiSecret                      | HybrSettings | ex: pass\@word1                     |
| HybrServiceNotificationEventSource | HybrSettings | (trisulapi/azurestoragequeue)       |
| ServiceNotificationQueueSasUri     | HybrSettings | (Azure storage queue sas uri)       |

\
8\. License Activation

* Download and extract [VConnect.zip](https://cloudassertdownloads.blob.core.windows.net/vconnect-rtm/VConnect.zip)
* Navigate inside the extracted folder and execute the below command from command prompt
* Command: `VConnect.exe ActivateOnline licenseKey emailId`
  * **Note:** Do not copy-paste the values directly into command prompt, paste it in notepad, remove spaces and add again before executing
* Once the command is executed successfully, .cal file will be generated in the same directory. Copy this file into C:\inetpub\MgmtSvc-CloudAssertBilling\bin

9\. Changes to support Custom Properties in Vconnect (Temporary)

* In Appsettings table of Vconnect DB , along with existing values in \[CustomPropertiesToDisplay] key , set the property display name with the below format
  * PropertyName : DisplayName
  * Example :- Description : Description