BSOFTINDIA APP DOCUMENTATION
USING IIS (MICROSOFT INTERNET INFORMATION SERVER)
HOW TO USE IIS RATHER THAN BSOFT APP DEFAULT WEB SERVERS
It can be a good idea to Update Terminal Service Plus to be sure that you get the latest Bsoft App programs.
1) IIS CONFIGURATION
- Install IIS with the following modules : CGI, ISAPI Extensions and ISAPI Filters.
- Configuring the IIS Port:
Access the IIS management console, expand the list below your server name, then Expand the “Sites” menu and right click on “Default Web Site” and click on “Edit Bindings”:
Click on “http” and “Edit”. Change the port to 81 and click Ok, and then click Close:
Then, restart the IIS Manager.
2) CREATE VIRTUAL DIRECTORY FOR CGI
In the left panel menu, expand the menu under your server, then “Sites,” and right-click on your site to add a new “virtual directory”, as shown in the image below:
On the window that will open fill in as follows:
Physical path: “C:\Program Files(x86)\Bsoft App\Clients\www\cgi-bin”
Then click “OK” and you will see that the “cgi-bin” virtual directory has been added to your IIS Web site. Now, right-click this “cgi-bin” virtual directory and click on “Convert to Application”. Click “OK” and accept the default settings.
Then select the “Handler Mappings” icon for this folder on the right side of the Manager window:
From the list of Handler Mappings, double click on “CGI-exe”.
Then, search the hb.exe executable from the Executable property box and click OK.
A prompt for confirmation appears. Click “OK” to allow this ISAPI extension.
Now click on “Edit Feature Permissions”:
Check the “Execute” checkbox and click OK:
Back to the “CGI-bin” Home, click on “CGI” to open the CGI properties:
On the “ISAPI and CGI Restrictions” page, click “Add …” on the right side of the window. Now specify the full path to the “hb.exe” file hosted in the TSplus folder. Be sure to check the “Allow extension path to execute” option, as Illustrate the following images:
4) ADD MIME TYPES IN IIS
Open a command prompt as an administrator and run the following commands:
%SystemRoot%\system32\inetsrv\appcmd set config /section:staticContent /+[fileExtension=’.dat’,mimeType=’text/plain’]
%SystemRoot%\system32\inetsrv\appcmd set config /section:staticContent /+[fileExtension=’.’,mimeType=’text/plain’]
5) CONFIGURE IIS DIRECTORY PERMISSIONS
Give full permission to the group “Everyone” in the directory “C:\inetpub\wwwroot”
6) CONFIGURE BSOFT APP
Go to the Web Server tab of the AdminTool, then choose the “Use a Different HTTP server” option:
Then, in the same window, click on “Select a new Web Server root path”, and put the path of the IIS directory, which should be something like: “C: \ inetpub \ wwwroot”. Now click on “Save and Restart the AdminTool”.
The following messages will appear:
Wait. The Admintool will be closed automatically. Then open the Admintool again and click on the Web tile.
Finally, restart the web servers:
7) TEST WITH LOCAL HOST
Warning: Use a different user account.
If you try with your current user account from your own RDP session to the server, then you will be disconnected and not be able to reconnect.