About: This article covers installation and setup instructions for Construct Enterprise.
Table of Contents
- System Requirements
- Installing and Licensing Construct Enterprise
- Updating the Software
- Drivers and Credentials
- Share and Transfer Jobs
System Requirements
Server Requirements:
- Windows Server 2012 R2, or later
- .NET Framework 4.6.1 or later, and its requirements
- 2.6 GHz Intel Xeon CPU (E5-2650 v2) 64-bit (x64) processor or better
- 8 GB or more available system memory
- 500 MB or more available hard drive space
- 2 GB or more of graphics memory
- Internet access
Client Requirements:
- Windows 7, or later
- .NET Framework 4.6.1 and its requirements
- 2 GHz 32-bit (x86) or 64-bit (x64) processor
- 4 GB of available system memory
- 100 MB available hard drive space
- 32 MB of graphics memory
- Internet access
Installing and Licensing Construct Enterprise
Enterprise Server Installation
- On the server machine, use the link below to download the installer for the Construct Enterprise Server.
Construct Enterprise Server 64-bit:
- Run the Server installer file “VeeraConstructEnterprise64.msi” and follow the Setup instructions.
- Once the program has successfully been installed, a splash screen stating that the installation is complete will appear. Click Finish.
Note: The Enterprise Server service will start automatically when the installation successfully completes.
- When the Enterprise Server is launched for the first time, a License and Registration window will open. If this does not occur automatically, launch the Construct Enterprise Manager application to initiate the license and registration process. Click Install New License
- Paste or type the Server license key provided by Rapid Insight and click OK. Refer to your new software purchase email to locate your license key, or contact RI-Support@eab.com if you do not know your license serial number
- The serial number will be verified against the Rapid Insight license server. This requires an active internet connection and the ability to verify with the site through any firewalls or virus scan software.
Note: It may be necessary to add exceptions to a web filter for these sites: http://license.rapidinsight.com/RapidInsightLicensingService.asmx http://update.rapidinsight.com/RapidInsightUpdateService.asmx
- Once the serial number is verified, you will be prompted to enter your contact information to register the license in our system.
- After registration, the license has to be locked the machine’s hardware so that the license can only be used on the registered computer. Click Lock to continue. The software is ready for use.
Enterprise Client Installation
Enterprise Clients must be installed using the setup wizard that is included in a folder on the server machine.
- On the Enterprise server machine, locate this folder C:\Program Files\Rapid Insight Inc\Veera Construct Enterprise\VeeraConstructEnterpriseClient
- A Client is automatically installed on the server machine during the server install. To install a Client on another machine, copy the entire VeeraConstructEnterpriseClient folder to the computer that will host the Enterprise Client and run the VeeraConstructEnterpriseClient64.msi file from the folder. Follow the Setup instructions.
- Once the program has successfully been installed, a splash screen stating that the installation is complete will appear. Click Finish.
- Copy the file “EntClient.config” from the transferred VeeraConstructEnterpriseClient folder and paste it into the folder “C:\ProgramData\Rapid Insight Inc\Veera Construct\Configuration” on the client machine (overwrite any existing copies).
- Launch the Construct Enterprise Client application to initiate the license and registration process. If a license prompt does not automatically appear, go to Help > License & Register. Click Install New License.
- Paste or type the Client license key provided by Rapid Insight and click OK. Refer to your new software purchase email to locate your license key, or contact RI-Support@eab.com if you do not know your license serial number.
- Once the serial number is verified, you will be prompted to enter your contact information to register the license in our system.
- After registration, the license has to be locked the machine’s hardware so that the license can only be used on the registered computer. Click Lock to continue. The software is ready for use.
Relocating Enterprise Server and Clients to New Hardware
If the need arises to transfer the Enterprise Server to a new piece of hardware, there are several steps that should be taken in order to make the move as smooth as possible while avoiding any possible data loss. For assistance at any point, contact RI-Support@eab.com.
Relocating the Server
- Open the Enterprise Manager program on the existing server from the Windows Program List.
- Create a Database Backup all of the clients’ content (jobs and connections) and save the resulting .VCB file in a safe location (as a safety backup).
- Uninstall and unlock the Enterprise Server license by going to Check Server License in the Enterprise Manager and selecting Uninstall License. This will allow for it to be reapplied to the new environment.
- Install Construct Enterprise Server on the new server machine.
- Copy the folder “C:\ProgramData\Rapid Insight Inc\Veera Construct” from the original server machine and paste it in the same location on the new machine, overwriting any existing copies of that folder.
- Open the Enterprise Manager program on the new server and apply the license (Check Server License > Install New License) to the new environment.
- Stop and restart the service. See this article for more information the Program Service.
Relocating Clients
- Unlock and uninstall the client from the current machine.
- On the Enterprise Server machine, locate this folder C:\Program Files\Rapid Insight Inc\Veera Construct Enterprise\VeeraConstructEnterpriseClient
- Copy the entire VeeraConstructEnterpriseClient folder to the computer that will host the Enterprise Client and run the VeeraConstructEnterpriseClient64.msi file from the folder. Follow the Setup instructions.
- Copy the file “EntClient.config” from the transferred VeeraConstructEnterpriseClient folder and paste it into the folder “C:\ProgramData\Rapid Insight Inc\Veera Construct\Configuration” (overwrite any copies previously found there).
- Repeat these steps for each machine intending to host a Client connected to the Server .
Updating the Software
To check for updates to the Server, open the Enterprise Manager and click Check for Updates.
If one is found, the user will be given the opportunity to download and install the update. For clients to be updated, Client Folders should be shared from the Enterprise Manager for the update to become available for each individual client. This can be done in the Service Commands tab of the Enterprise Manager.
Drivers and Credentials
Construct Enterprise Drivers
Connections to data sources and data destinations (outputs) are all made from the vantage point of the Enterprise Server. As such, any required data drivers (Excel, Oracle, MSSQL, MySQL, etc.) must be present on the server machine rather than on the individual client PCs.
Construct Enterprise Server Service Credentials
The Construct Server Service runs under a set of credentials (username/password). The credentials that are used by default (“Network Services”) may or may not possess sufficient rights to access all the network and system resources required by users. To review and, if necessary, change these credentials to those with sufficient privileges, do the following:
- Open the Services window on the machine acting as the Construct Enterprise Server
- Right-click on the Construct Server Service in the list and select “Properties”
- Select the “Log On” tab
- Change the account information to a set of credentials with sufficient privileges
- Apply the new credentials
- Stop then Start the Construct Server Service as well as any active Enterprise Clients
Data Access Credentials
Certain nodes and functions like the Command Node, Run SQL Node, R Script Node, and some data connection and output nodes, as well as Scheduled Jobs require specific user credentials to be able to run successfully. Relying upon the credentials under which the Server Service is running is not adequate. Therefore, Client users have been given the option to “override” the standard server-side credentials with their own.
- Go to Tools > Options > User Credentials
- Click the Current User button to enter your Fully Qualified Domain Name and password
- Confirm these credentials are working correctly by clicking the Check button
Delegating Access Credentials
Access to some network resources may still be denied to users, even after configuring their systems to use their specific Windows credentials. This is because the network’s Active Directory Controller needs to be properly configured, “delegating” authority to the Enterprise Server to make such connections on behalf of individual Clients.
To do this, open the network’s Active Directory Admin Center. Select the computer on which the Construct Enterprise Server is installed and view its "Delegation" properties. Set this to trust delegation to any service and save the change.
Note: If there are no data sources that require users' Windows Credentials, then configuring the network to permit delegating credentials can be skipped.
Construct Enterprise Mapped Drives and UNC Paths
Mapped drives are associated with the Windows account that established the mapping. As the default, the Enterprise Server will not have any drives mapped and users may have difficulty finding their required data. Construct Enterprise adapts to this situation by attempting to swap out all references to mapped drives in its data connections with their corresponding explicit file paths (called UNC paths).
Unfortunately, scheduled jobs with such network connections will need their input and/or output connections to be refreshed. This can be done by:
- Right-clicking on the connection and selecting Edit Connection.
- In the Workbook folder pathname, the Mapped Drive letter is shown. Click on the ellipsis […] button to browse to the location.
- Once Construct has located the UNC Path that is associated with your mapped drive, click Open to refresh the connection with the UNC Path.
- Note the change in the Workbook folder field. Click Save.
Note: Output connections in scheduled jobs may require similar adjustments.
Share and Transfer Jobs
Sharing Jobs
The sharing jobs feature is only available in Construct Enterprise. Sharing jobs allow multiple users to access shared jobs with a specified delegation of rights configured by the job owner.
- To share a job right-click on the job in the Workspace tab > Edit Job Properties > Sharing > Add Shared User.
- There are four sharing delegation options – Not shared, Run Only, Run and Edit, Full
- Recipients with Run Only rights can’t open a job so they must run it by right-clicking the job in the Workspace tab
- A recipient deleting a shared job will un-share it
- A job can only be scheduled by the owner
- Renames can only be done by the owner
- Exports can only be done by the owner of the job or recipients with full rights
- Recipients cannot edit/add/remove a shared job’s input connections
- Only recipients with full or edit rights can view or preview a shared job’s data
Transferring Jobs
Construct Enterprise Admin users have the ability to transfer jobs from one client user to another. This action is performed within the Construct Enterprise Manager.
- Transferring a scheduled job transfers the schedule to the new user as well
- Transferring jobs that are shared with other users transfers the shares as well
- Transferring a shared job to the same user that the job is already being shared with voids the share
- Transferring a shared, scheduled job to the same user that the job is already being shared with voids the schedule for that job
- Any job may be transferred (including samples)
- Transferred jobs should disappear immediately from the giving user's jobs list and appear immediately in recipient's job list
Comments
0 comments
Article is closed for comments.