Chat now with support
Chat with Support

ChangeBASE 6.2.2 - Prerequisites and Getting Started Guide

Virtual Machines

Virtual machines (VMs) are utilized by ChangeBASE for the Repackaging of legacy installer files (whether in EXE, VBS, BAT or CMD format) into MSIs, and for the conversion of MSIs/EXEs into virtual formats (Virtualization).

The system requirements are as follows:

Virtual Machines used for Repackaging (EXE/BAT/VBS/CMD)

Table 4: Requirements for Virtual Machine used for Repackaging

Running under Hypervisor

Operating System

RAM (GB)

Minimum Display Resolution

Software

One of:

  • Microsoft Hyper-V
  • VMware
    Workstation 9
    (with shared VMs)
  • VMware Server 2.x/ESX Server 5.1

One of:

  • Windows XP SP3 32-bit (x86)
  • Windows 7 32-bit (x86)

Note: Windows Vista is not supported, even in its 32-bit version.

IMPORTANT: If 64-bit Repackaging is required, then you can use the version of MSI Studio that is bundled with ChangeBASE, provided that the repackaged applications undergo full testing prior to deployment, especially if they require COM (Component Object Model) servers.

4 or greater

1024 x 768 pixel array

As follows:

  • Microsoft.NET Framework 3.5 SP1 and:
    • .NET 4 or later (Full Version) for Windows 7
    • .NET 4.0.x (Full Version) for Windows XP
  • VMware Tools for a VMware-based VM.
  • Hyper-V Integration Services for a Microsoft Hyper-V-based VM.
  • CBVMTools (supplied with ChangeBASE).

Virtual Machines used for Virtualization

Table 5: Requirements for Virtual Machine used for Virtualization

Running under Hypervisor

Operating System

RAM (GB)

Minimum Display Resolution

Software

One of:

  • Microsoft Hyper-V
  • VMware
    Workstation 9
    (with shared VMs)
  • VMware Server 2.x/ESX Server 5.1

One of:

  • Windows XP SP3 32-bit (x86)
  • Windows 7 32-bit (x86)
  • Windows 7 64-bit

  • Windows 8 32-bit (x86)

  • Windows 8 64-bit

  • Windows Server 2003 R2

  • Windows Server 2008 R2

  • Windows Server 2012

Note: Windows Vista is not supported, even in its 32-bit version.

4 or greater

1024 x 768 pixel array

As follows:

  • Microsoft.NET Framework 3.5 SP1 and:
    • .NET 4 or later (Full Version) for Windows 7 and Windows 8
    • .NET 4.0.x (Full Version) for Windows XP
  • VMware Tools for a VMware-based VM.
  • Hyper-V Integration Services for a Microsoft Hyper-V-based VM.
  • One or more of the following:
    • App-V Sequencer 4.6 SP1/5.0 (also requires Windows 7 SP1)
    • ThinApp Setup Capture 4.6.1
    • Symantec Wise Composer with Symantec Workspace Virtualization Admin (Client) 6.1
  • CBVMTools (supplied with ChangeBASE).

Important:

  • Do not disable Internet Protocol Version 4 (TCP/IPv4) on any of the Virtual Machines.

  • The VMware VIX library only allows connections to one type of provider per process. This means that you can only configure ChangeBASE to use either Workstation- or Server-based Virtual Machines, not both.
  • If you are running ChangeBASE on a Machine that does not have VMware Workstation installed and you want to connect to an ESX/vCenter server, or if you encounter errors connecting to ESX servers 5.1 and above, download and install the VIX SDK (http://www.vmware.com/support/developer/vix-api/).
  • The App-V 5.0 Sequencer requires the prior installation of Microsoft.NET Framework 4.0 Full and PowerShell 3.0. The latter is automatically installed with Windows 8 and Windows Server 2012. Alternatively, you can download it from http://www.microsoft.com/en-gb/download/details.aspx?id=34595 or http://www.microsoft.com/en-us/download/details.aspx?id=34595.

Recommended Configuration for Optimal Performance

For optimal performance it is recommended that:

  • If you are using VMware Workstation (with shared VMs), you use 64-bit Windows for the host machine.
  • If you are using 64-bit Windows for the SQL Server machine, you use 64-bit SQL Server.

Space requirements for the database are 16 GB per 400 packages (40 GB per 1000).

Note: When large numbers (more than 2000) of packages are imported into ChangeBASE, you may experience a degradation of import speeds. Over the course of time, the indexes on some tables can become fragmented which has a negative impact on performance. In this situation, please refer to the Dell Knowledge Base article 135255 for more details.

Best Practice Setup using Active Directory

The following procedure is recommended if your site uses a client/server environment and is able to take advantage of the Active Directory (AD) service included in most Windows Server Operating Systems.

To set up using Active Directory

  1. Assuming that SQL Server has already been installed centrally, create an AD group related to ChangeBASE.
  2. Create a user account (for example SVC_ChangeBASE) that will be used to connect to the ChangeBASE service, and ensure that the password is set to never expire.

Note: This account will be prompted for when you select the ChangeBASE service during installation.

You will associate the account with the SQL Server dbcreator and sysadmin roles via the Login Properties of the AD group at the step starting Set up SQL Security as follows:

  1. Ensure that this SVC_ChangeBASE account has the Log on as a Service Right so that it can access the ChangeBASE service.
    1. To add the Log On as a Service Right to the account if it is on your local computer:
      1. Select Control Panel > Administrative Tools > Local Security Policy.
      2. In the console tree, double-click Local Policies, and then click User Rights Assignment.

      3. In the details pane, double-click Log On as a Service.

      4. Click Add User or Group, and then add the account to the list of accounts that possess the Log On as a Service Right.

    1. To add the Log On as a Service Right to the account if it is not on your local computer:
      1. Select Start > Run, type mmc, and then click OK.
      2. Select File > Add/Remove Snap-in.

      3. In Add/Remove Snap-in, click Add, and then, in Add Standalone Snap-in, double-click Group Policy Object Editor.

      4. In Group Policy Object, click Browse, move to the GPO (Group Policy Object) that you want to modify, click OK, and then click Finish.

      5. Click Close, and then click OK.
      6. In the console tree, click User Rights Assignment.
      7. In the details pane, double-click Log On as a Service.
      8. If the security setting has not yet been defined, select the Define these policy settings check box.
      9. Click Add User or Group, and then add the account to the list of accounts that possess the Log on as a Service Right.
  1. Add this service account to the ChangeBASE AD group.
  2. Add the machine account of the server hosting IIS (Internet Information Services) to the ChangeBASE AD group. This server will be used for ChangeBASE Web reporting.
  3. Set up a central reports directory that can be accessed by the IIS server, for example My Reports.

  1. To set up the virtual reports directory on the server hosting IIS:
    1. Open IIS.
    2. Right-click on Sites and then Add Web Site.
    1. Give your Site a name and set the Physical Path to the virtual directory that you created above. Leave all other settings as default.

    Note: If you receive a warning about port binding you should increment the Port until the warning ceases.

    1. Right-click on your Website and select Properties.
    2. Share the virtual directory to allow ChangeBASE to export your reports. To do this, go to Sharing and click Share.

    Note: If you have specific report authors, then you can explicitly share with them, but, as a minimum, you will need to add the account that will be used to connect to the ChangeBASE service. If this account is already in a ChangeBASE Active Directory group, simply add this group in place of Everyone in the above example.

    1. Click on your Website, followed by Directory Browsing.
    1. Click on Enable.

Note: The final step will be to link the Physical Path (D:\My Reports) to ChangeBASE. This will be done at the end of this Best Practice Setup, as the last part of the product setup.

  1. Open SQL Server Management Studio and connect to the SQL Server instance.

TIP: If you want to know the name of the SQL Server instance, open the Services window and select SQL Server. The instance name is given in brackets.

  1. Set up SQL Security as follows:
    1. Browse to Security > Logins.
    2. Right-click Logins and select New Login.
    3. Use Search to find the ChangeBASE group you created.
    4. Once you have located the group, click OK.
    5. Select Server Roles.
    6. Check dbcreator and sysadmin.
    7. Click OK.

  1. Install ChangeBASE on the central server that is to run the ChangeBASE service. Install both the service and client features.
  2. Apply permissions to C:\ProgramData\ChangeBASE, as follows:
    1. Open Windows Explorer.
    2. Type C:\ProgramData\ChangeBASE into the address bar and press Return.
    3. Select the Security Properties and click Edit.
    4. Click Add and add the ChangeBASE group.
    5. Check Allow next to Modify to give the group Modify permissions on the folder.
    1. Click OK.
  3. Set up shares and permissions to each of the Package Sources that you are going to set up in ChangeBASE, as follows:
    1. Locate the Package Source.
    2. Right-click on it and select Properties.
    3. Move to the Sharing tab and select Advanced Sharing.
    4. Check Share this folder.
    5. Click Permissions.
    6. Add the ChangeBASE group to the share permissions.
    7. Check Allow next to Change.
    8. Click OK to return to the Sharing tab.
    9. Note the Network path.
    10. Select the Security tab and click Edit.
    11. Click Add and add the ChangeBASE group.
    12. Check Allow next to Modify to give the group modify permissions on the folder.
    13. Click OK. This may take some time to apply.
    14. Repeat the process for the next package source or select to run ChangeBASE.

Pre-Installation Steps

  1. Ensure that you have met all the system requirements.
  2. ChangeBASE will verify that the user account under which you log onto the SQL Server instance is associated with the SQL Server dbcreator and sysadmin roles, so you need to ensure that the account is associated with these roles before starting to set up ChangeBASE.

    If you are going to use Windows Authentication, then you can associate the logon with the dbcreator and sysadmin roles via Server Roles in the SQL Server Login Properties. If you followed the Best Practice Setup using Active Directory, then you will have associated this account with the necessary rights via the ChangeBASE AD Group. Refer to Set up SQL Security as follows:

  1. Ensure that the necessary shares have been created to the folder(s) containing the packages to be imported (refer to Best Practice Setup using Active Directory).
  2. If you are running SQL Server and ChangeBASE on separate machines, check the following:
    • The SQL Server Browser service must be running, and set to Automatic on the machine where SQL is installed.
    • Both the SQL Browser service and SQL Server must be allowed through your firewall.
    • The TCP/IP protocol must be enabled.

Note: Both "SQL Server Browser" and "TCP/IP" can be configured in SQL Server Configuration Manager:

  1. If you are going to be importing Web data for assessment, having specified a browser platform, and wish to first capture the data using the Web Capture utility, then install and use it in accordance with the section on Web Capture.
  2. Ensure that you have your Site's Dell License Key and Site Message.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating