VimBiz Web Installation

VimBiz Web prerequisites

  1. Make sure IIS and all sub items are installed
  2. Make sure .NET framework is installed (v 3.5.1 with extensions)

Client Desktop

Enable Windows Authentication with Firefox (domain systems):

  1. Open Firefox.
  2. In the address bar type: about:config.

    NOTE: Firefox3.x, and later, requires you to agree that you will proceed with caution.

  3. In the filter box type enter: network.negotiate-auth.
  4. Double-click network.negotiate-auth.trusted-uris and enter yourdomain.com.
    Multiple domains can be added using comma delimitation, such as yourdomain.com, yourotherdomain.com.

VimBiz Web Installation

  1. Extract VimBizWeb.zip file to C:\inetpub.
  2. Right click and give the users NETWORK SERVICE and IIS_IUSRS full access to the folder.
  3. Navigate to the VimBizWeb Folder and open the web.config file.
  4. Enter database and model information.
  5. If performing a VimBizWeb update, copy and paste the existing web.config file into the VimBizWeb Folder.
  6. Launch IIS.
  7. Right-click on Sites and select Add Web Site
  8. Specify a site name such as VimBizWeb
  9. Point the physical path to the location specified in step 1. (C:\inetpub\ VimBizWeb)
  10. If port 80 is already in use, select a new port, such as 81. (To free up port 80 to use with VimBizWeb, change the port that the Default Web Site is using:
    1. Click on Default Web Site
    2. Select Bindings from the right menu
    3. Select port 80.
    4. Click the Edit button
    5. Change the port to another number.
  11. Click OK
  12. Click on VimBizWeb in the Sites list in IIS
  13. Double click Authentication.
    • Ensure only the following are set to Enabled:
      1. Anonymous Authentication
      2. ASP.NET Impersonation
      3. Windows Authentication
  14. Double click Default Document
    1. Delete everything from the list
    2. For SQL Authentication or Windows Authentication, add Login.aspx
  15. In the main IIS treeview, double click on Application Pools
  16. Select the application pool used by VimBiz Web

    NOTE: To determine what app pool is being used, click on VimBizWeb and select Basic Settings from the right menu.

  17. With the application pool highlighted, click Advanced Settings from the right menu
  18. Ensure that the setting Enable 32-Bit applications is set to True
  19. Ensure the Identity is set to NetworkService
  20. VimBiz Web is now enabled.

Enable Crystal Reports

  1. Install CRRuntime_12_0_mlb.msi and CRRedist2008_x86.msi
  2. Navigate to the system TEMP directory
  3. Give the users NETWORK SERVICE and IIS USER full access
  4. In IIS, right click on VimBizWeb and select Add Application
    1. Select the physical path: C:\inetpub\wwwroot\aspnet_client\system_web\2_0_50727\crystalreportviewers12
    2. Set the Alias to: crystalreportviewers12
    3. Make sure the Application Pool is Classic .NET AppPool
    4. Click OK
  5. Crystal Reports is now enabled.

Troubleshooting

Potential errors found on Client Desktop browsers:

  • Read/Write permission errors
    1. Navigate to the VimBizWeb folder
    2. Right click on the folder and ensure Read and Write access is granted to any Group or Username listed.
      Granting Full Control is the quickest and easiest way to solve this error.
  • IE8 – if a “Save & Close” button is clicked and a new window is opened, instead of refreshing the already opened page, it means IE8 needs to run in compatibility mode. This can be done by clicking “Tools – Compatibility View”. VimBiz Web should be configured to always run in Compatibility View by clicking “Tools – Compatibility View Settings” and then adding the url of the VimBiz Web to the list.
  • There is a known issue with Internet Explorer where a newly opened form hides itself behind an already opened form.
  • If you receive the error message, "Could not load file or assembly or one of its dependencies. Access is denied", this can be resolved by navigating to: C:\\Windows\Microsoft.NET\Framework\v3.5, right-click and select 'properties'. Under the Security, grant "Full Control" or "Modify" to the 'users' group.
  • Potential errors found when trying to open a Crystal Report on VimBiz WEB:
    • Error in File: <FILENAME>
      Access to report file denied. Another program may be using it.
      Description: An unhandled exception occurred during the execution of the current web request. Please review the stack trace for more information about the error and where it originated in the code.

    OR

    • Error in File: <FILENAME>
      Access to report file denied. Another program may be using it.
      (No Description)

    To resolve the error, follow these steps:

    1. Go to C:\Windows\Temp
    2. Give Modify access to the following user groups: IIS_IUSRS (System Name\ IIS_IUSRS), Network Service, Users (System Name\Users)