HTTP Commander 6.0 (Active Directory
version) installation.
Server's system requirements:
Installation 1-4 steps:
1. Creating application:
- For package with Windows Installer (Setup.exe file): run
Setup.exe, Click "Next" and install HTTP Commander to HTCOMNET virtual directory.
After that setup creates virtual C:\Inetpub\wwwroot\HTCOMNET folder, copies
all files to this folder and creates web-application in it.
For package without Installer: Copy HTCOMNET folder to your
web server's wwwroot\ folder (in most cases it is C:\Inetpub\wwwroot\) ,
Also you need to create "Application" in vitrual HTCOMNET folder in IIS console:
See screeshots at HTCOMNET\WebApp.htm
Description: Open Control panel->Administrative tools->
Internet Information Services->Expand "Default web site", right mouse click
at the "HTCOMNET" folder and select "Properties" in context menu.
In the HTCOMNET properties dialog box open "Directory" tab and click "Create"
button (create Application), click "ok" .
- Set content expiration for HTCOMNET application. It is needed for fast
upload images and .js files from users browser's cache. It is very important
becouse HTTP Commander has a lot of images and Java Script functions (in .js
files) and this data must be stored in cache and dont checked for new versions!
Images and pages will blink if content expiration willn't
be seted!
See screenshots at HTCOMNET\ContentExpiration.htm
Description: Open Control panel->Administrative tools->Internet Information
Services->Expand "Default web site", right mouse click at the "HTCOMNET"
folder and select "Properties" in context menu.
In the HTCOMNET properties dialog box open "HTTP headers" tab, check "Enable
content expiration", select "Expire on" and enter date 1.1.2010, click "ok".
- You need to set either Basic or Windows Authentication for HTCOMNET application
in IIS. See screenshots at HTCOMNET\windowsauth.htm.
- For Windows 2003 Server you need to allow ASP.NET running. Open Control
Panel->Add and Remove programs->Add/remove Windows Component->Select
Application Server in list, click "Details" button. In new window check ASP.NET
and click Ok.
Check that ASP.NET execution enabled on server. Open Control panel->Administrative
tools-> Internet Information Services->Web Sirvices Extensions->
Select "ASP.NET v #.#" in list and click "Allow" button.
2. Settings: Open HTCOMNET\web.config
file in XML editor or Windows Notepad or WordPad. This is XML based file and it
stores most part of settings for application. Keep in mind that XML is case
sensitive , data between <!-- --> tags are comments.
We are strongly recommend to make backup copy of web.config file before modify
it!
- Find <add key="ADMIN_NAME" value= "A" /> element and change default
name "A" for Administrator. Only Administrator will have access to Admin panel
of HTTP Commander.
- Find <add key="ADMIN_PASSWORD" value="A" /> element and change default
password for Administrator.
Run HTCOMNET/HashPassword.aspx to hash password.
Don't use here name and password of real Administrator on server! It is
not secure!
- Find <add key="DATABASES_DIR" value="C:\HTCOMNET_DATA\" /> element.
DATABASES_DIR is folder that will store databases and log files. By default
it is C:\HTCOMNET_DATA\, Change it if you want to use another folder.
Create DATABASES_DIR folder and Set NTFS "Modify", "Read and execute",
"List folder contents", "Read", "Write" permissions for ASPNET user and
your AD users to this folder!
- Find <add key="TEMP_DIR" value="C:\HTCOMNET_TEMP\" /> element. TEMP_DIR
will store temporary files for Upload operations. By default it is C:\HTCOMNET_TEMP\,
Change it if you want to use another folder.
Create TEMP_DIR folder and Set NTFS "Modify", "Read and execute", "List
folder contents", "Read", "Write" permissions for ASPNET user and your AD
users to this folder!
- Find <httpRuntime maxRequestLength="1048576" executionTimeout="3600"
/>. Set executionTimeout's value (in seconds) greater than the amount of
time you expect uploads or downloads to take.
Also find <sessionState timeout="60" /> and set timeout's
value (IN MINUTES!) greater than the amount of time you expect uploads or
downloads to take.
- You can make your version as Personal i.e. it will work more than 30 days but only 3 accounts available. Find <add key="IS_PERSONAL" value="no" /> key and replace with the <add key="IS_PERSONAL" value="yes" />
- Also you can set some other values. See comments for all settings in web.config
file (between <!-- --> tags).
3. Administration:
-
Run http://localhost/HTCOMNET/adminpanel.aspx to login to Admin Panel. In HTTP
Commander authentication form enter Administrator's name and password (defined
by ADMIN_NAME and ADMIN_PASSWORD parameters).
-
Click "Set folders for user or group" link to setup folders for users and
groups.
4. Run:
-
Your users should run http://localhost/HTCOMNET/Default.aspx in their browsers
to run HTTP Commander. Change "localhost" with "computername" or
"www.yoursite.com" if your users running HTTP Commander from Local Network or
Internet.
5. Upgrade version 5.1 to 6.0
- web.config files are not compatible. You need to set values in web.config
file of 6.0 version again. Set the same DATABASES_DIR and TEMP_DIR as in 5.1
version
- Databases compatible except for one new "Properties" field. Open
file DATABASES_DIR\FoldersAD.xml of 5.1 version in Notepad. Under each <user>
node add "<properties />" or "<properties>|</properties>"
if 2 folders defined for user or "<properties>||</properties>"
if 3 folders defined, etc. Save file and run. If records added correct 6.0
version will work with this database.
Troubleshooting:
- To Restart application! 1) Close all w3w.exe or Aspnet_wp.exe procceses. 2) Delete C:\WINDOWS\Microsoft.NET\Framework\v1.1.4322\Temporary
ASP.NET Files\HTCOMNET folder 3) Open file HTCOMNET\web.config in NotePad
and save it without changes.
- Error like "Column 'properties' does not belong to table user."
after user login. You are running version 6.0, but it uses folders database
of old 5.1 version. Change DATABASES_DIR key in HTCOMNET\web.config file or
upgrade your database (See section 5.).
- Error like "Access to path '...' is denied." while running
or working with application. Check that ASPNET and your AD users(who works
with HTTP Commander) has READ, WRITE, MODIFY NTFS permissions to specified
path.
- Error like "Network path not found" while
trying to get access to UNC paths (folders of other PCs in LAN). Read following
article http://support.microsoft.com/default.aspx?scid=kb;EN-US;207671
Try to set Basic kind of authentication for HTCOMNET application.
- You got page with top "<%@ Page Language="vb" AutoEventWireup="false"
Codebehind="adminpanel.aspx.vb" Inherits="HTCOMNET.adminpanel"%>
If you see this label then you need to install .NET Framework 1.1 or enable
running it on server for correct running .ASPX pages. See ReadMe.htm"
while running adminpanel.aspx then you don't have .NET framework installed
or need to allow ASP.NET run on web server.
- Error "Access is denied" while first running
any page of HTTP Commander.
How to fix: 1. Open the Domain Controller Security Policy from the Administrative
Tools folder. 2. Navigate through Security Settings / Local Policies / User
Rights Assignment. 3. In the right-hand pane, double-click Impersonate a client
after authentication. 4. Select Define these policy settings in the Security
Policy Setting dialog. 5. Press Add. 6. Press Browse. 7. In the Select Users
or Groups dialog, select the IWAM_MASHINENAME account name and press Add.
8. Press OK, OK, and OK. 9. Restart server.
- Error like "Can't get group names of the logged on user" or error in HCADSI module. Logon users havn't permissions to read own group membership info from AD.
Most easy way to fix this problem described in file HCADSI_FREE.htm. Also available solutions described in HCADSI_COM.htm or HCADSI_USER.htm files. If you have something problems write to developer sprunsky@http-com.com . Attach error's description to email.
Optional:
-
You can translate all messages of HTTP Commander to your own language. See
HTCOMNET\Languages\Readme.txt
-
Run http://localhost/HTCOMNET/groupsinfo.aspx to get list of users and groups
in your Domain.
-
Your users can run HTTP Commander using fomat of URL:
http://localhost/HTCOMNET/Default.aspx?path=locationhere
Users will have access to path automaticaly if it is enabled for them in
Admin Panel . You can use this format to make direct access or link on other
pages to folder.
-
You can add extra file types that users can to Edit or View in
HTCOMNET\Data\Properties.xml file.
-
You can add extra icons for files in HTCOMNET\Data\Properties.xml file and
HTCOMNET\Images\EXT folder.
-
You can use your own Text files Editor (See HTCOMNET\Editfile.aspx for deatils)
Extra modifications:
-
Please write to developer if you need to have extra features of to fix
something. Extra customizations costs 20$/hour or free in some cases. We
are always ready to help.
HTTP Commander group.
WEB: http://www.http-com.com
Support e-mail: sprunsky@http-com.com