1. Installation Setup
System Requirements
- Operating System: Windows Server 2012, 2016, 2019, 2022
- Hard Drive: 512 GB to 1 TB Fast drive recommended – ideally SSD.
- CPU: Minimum of 4 cores, operating at 3 GHz or higher.
- RAM: At least 8 GB.
- Software:
- Web browser with JavaScript support.
- .Net 8, you can download the hosting bundle from the ASP.NET Core Runtime section from the official Microsoft website. (https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
- IIS with the necessary Windows features should be installed as described below.
- VGRepository
- Require SQL Server 2012 or later, with a minimum of the Standard Edition.
- Require Oracle Database with Oracle9i or later. Please ensure the Oracle Driver is installed.
- Install Internet Information Services (IIS): IIS is a web server software package designed for Windows. It’s used for hosting websites and other content on the web. You can install it through the “Turn Windows features on or off” menu in the Control Panel. The below screenshot shows which functions should be checked and vice verse.
2. Restart IIS: After installing the ASP.NET Core Runtime, you should restart the IIS to ensure the changes take effect. You can do this by opening a command prompt as an administrator and running the command iisreset
.
3. Verify the Installation: You can verify that ASP.NET Core Runtime are correctly installed by opening a command prompt and running the following commands:
- For ASP.NET Core Runtime:
dotnet --list-runtimes
These commands should display the versions of ASP.NET Core Runtime that are installed on your machine.
4. Install Visual-Guard WebConsole: Once IIS, ASP.NET Core Runtime are installed, you can proceed with the installation of Visual-Guard WebConsole. Follow the instructions provided by Visual-Guard for this process.
Installation Guide
The Visual Guard WebConsole needs to be installed on your server. Follow these steps for a successful installation:
- License Agreement: Accept the license agreement to proceed with the installation.
- Installation Details: Provide the necessary information, including:
- The site
- The virtual directory
- The application pool (“No Managed Code” as .NET CLR Version)
- Confirmation: Confirm to initiate the installation of the console on your server.
- Installation Process: Please be patient while the installation process is underway.
SQL Server settings
To provide appropriate login rights to create a new repository, follow the below steps to be configured in the SQL server platform.
Step 1: Go to the user properties in the SQL server, select master under the default database –> Click OK
Step 2: Under the user properties, select Server roles –> Select dbcreator and public to provide roles rights –> Click OK
Installation
- Step 1: The Visual Guard WebConsole needs to be installed on your server. Follow these steps for a successful installation:
- Step 2: License Agreement: Accept the license agreement to proceed with the installation.
- Step 3: Installation Details: Provide the necessary information, including:
- The site
- The virtual directory
- The application pool
Click ‘Next’ to continue with the installation.
- Step 4: Confirmation: Confirm to initiate the installation of the console on your server.
- Step 5: Installation Process: Please be patient while the installation process is underway.
- Step 6: Installation Complete.
Once the installation is complete, Go to the installation folder that is created automatically –> open the folder –> Right click on the webconsole folder and select properties –> Click on Security section –> Add IIS_IURS if not added –> Click on IIS_IURS –> ensure to allow the below mentioned permissions –> Click OK
1.1 Configure HTTPS Binding
Setting up HTTPS binding is essential for securing the communication between the Visual Guard Web Console and its users.
HTTPS ensures that all data exchanged is encrypted, protecting sensitive information from potential threats.
To enable HTTPS, you must configure SSL certificates, which authenticate the identity of the web server and establish a secure, encrypted connection. This guide will take you through the steps to bind your website to HTTPS, ensuring both encryption and trust through the proper use of certificates.
To configure an IIS website for HTTPS binding with a certificate specifically for the Visual Guard WebConsole, follow these steps:
1. Obtain an SSL Certificate
- Ensure you have a valid SSL certificate issued by a trusted Certificate Authority (CA). This certificate must include both the public and private keys.
2. Install the SSL Certificate on the Server
- Open IIS Manager on the server where Visual Guard WebConsole is installed.
- In the left-hand Connections pane, click on the server name.
- Double-click on Server Certificates in the middle pane.
- In the Actions pane on the right, click Import if you have the .pfx file or Complete Certificate Request if you have a .cer file.
- Browse to your certificate file, provide any required password (for .pfx), and complete the import process.
3. Configure HTTPS Binding for Visual Guard WebConsole
- In IIS Manager, expand the server node, then expand Sites, and select Visual Guard WebConsole site.
- Click on Binding in the right-hand Actions pane under Edit Site.
- In the Site Bindings window, click Add.
- In the Add Site Binding dialog:
- Type: Select https.
- IP address: Choose the appropriate IP address or leave it as All Unassigned.
- Port: Enter 443 (default port for HTTPS).
- Host name: Optionally specify the hostname if applicable.
- SSL certificate: Select the SSL certificate you imported earlier.
- Click OK to add the binding.
4. Enforce HTTPS on Visual Guard WebConsole (Optional)
- Select the Visual Guard WebConsole site in IIS Manager.
- Double-click SSL Settings in the feature view.
- Check the box labeled Require SSL to enforce HTTPS.
- Click Apply in the Actions pane on the right.
5. Restart the IIS Services
- After configuring HTTPS binding, restart IIS to apply the changes. Select the server node in IIS Manager and click Restart in the Actions pane.
6. Test the Configuration
- Open a web browser and navigate to your Visual Guard WebConsole using
https://yourdomain.com/webconsole
. Ensure that the connection is secured by the certificate and that the site loads correctly over HTTPS.
By following these steps, you will ensure that the Visual Guard WebConsole is properly configured to use HTTPS, securing communication between users and the web application.