How to deploy a Visual Guard repository or an application |
There are 4 methods for deploying a repository:
The deployment tool is named vg_deployment.exe and is located in the directory <Visual Guard installation directory>\Bin\2.0. This tool needs the installation of the .Net 2.0 framework on the computer. It can be run as command line utility.
You can run this tool without any command lines argument to run a wizard that will walk you through specifying the connection information and selecting the deployment configuration file.
The following table describes the command line options supported by this tool.
Option | Description |
---|---|
-? | Prints vg_deployment.exe tool Help text in the command window. |
-w | Run the tool in Wizard mode. This is the default if no command line arguments are specified. |
-t repository type | Specifies the type of the repository (Oracle, SQLServer, File). This option is not necessary. If this option is omitted, the type of the repository is SQLServer. |
-s schema name | The Oracle schema name containing the Visual Guard tables. This option is necessary if the type of the repository is Oracle and when the user specified in the connection string is not the owner of Visual Guard tables. This value is case sensitive. |
-c connection string | The connection string to the computer running the database where the repository will be deployed. This option is necessary if do not use the option -W. The user specified in the connection string must have the permissions to update and delete data in Visual Guard table. When the type of the repository is File, the value must contain the path of the directory where the repository will be deployed. |
-f path | The path of the deployment configuration file used by the tool. This option is not necessary. By default the tool will use the file "deployment.config" located in its directory. |
When you deploy a repository, the deployment tool will first check if the database structure is already created. When the structure does not exist, the deployment process will fails. It is necessary to create the database structure before running the deployment tool.
You can create it by using the Visual Guard console to create an empty repository. You can also create it by using the SQL scripts installed with Visual Guard. These scripts are located in the directory <Visual Guard Installation Directory>\VisualGuardConsole\Database\<Repository Type (SQLServer or Oracle)>.
When you deploy a complete repository in an empty repository or in a repository without a registered license key (in evaluation mode), Visual Guard considers that you create a new repository.
This repository will have the same license key (with same limitation) as the source repository but you will not be able to add new applications or security actions in this repository. When you need to create new application or add new security action in the deployed repository or when you need more users than the source repository, you should request a new license key for this repository.
When you deploy a complete repository in a repository with a registered license key, Visual Guard will keep this license key and will not take into account the license key of the source repository.
When you deploy an application in a repository, the deployment process will fails if the license of the target repository is expired.
This functionality is used to deploy only the parameters of a repository.