COM+ Walkthrough

Creating a COM+ application with the Component Services GUI

JustFTP, the component itself (justftp.dll) must be registered in the Windows registry on the computer where JustFTP is installed.

By 'registered', we mean standard Microsoft COM ActiveX Server registration. This has nothing to do with whether or not JustFTP is a trial or registered version.

ActiveX Server registration is a simple process. Just change to the directory where justftp.dll is located and give the command "regsvr32 justftp.dll" from a command prompt. This will correctly register the component in the Windows registry of that computer.

This installation process works well if:

1. The JustFTP component is to be used from a script or client application on a computer that will be running under an account, (e.g. Administrator), that has network access and local file system access.

2. JustFTP will be used as a scheduled task, where JustFTP is activated in a script with the task set to run under an account with enough permissions to access the network and write to the local file system.

However, if JustFTP is called from an IIS ASP or ASP.NET page it will not have the correct privileges and will return an access denied error. For JustFTP to run correctly from IIS, it is necessary to place the JustFTP dll in a COM+ Application.

This is a simple process. Once completed, the JustFTP component can be called from IIS, VBScript etc. without any authentication issues. The COM+ application is given an "Identity" which it uses to authenticate itself with remote FTP servers and the local (or mapped path) file system.
 

The COM+ application correctly registers the justftp.dll component as part of step 17 shown below. There is no need to pre-register the dll.


We recommend that if you have already registered the dll as described in the installation of JustFTP, you should now unregister the dll before following the steps below.  To unregister JustFTP, open a command prompt, change to the directory where justftp.dll is located, give the command "regsvr32 /u justftp.dll".

You should get the success message as shown here:




If you have not yet registered the dll with the regsvr32 command, then simply proceed to the next section.


STEPS REQUIRED TO CREATE THE JustFTP COM+ APPLICATION.

The steps involved are detailed below. The Administrative tool "Component Services" is used to complete this process.

Based on the number of steps involved, one could think that this is a difficult process.
In fact it is extremely easy to do and should only take a few minutes.

NOTE: The screen shots below are from Windows Server 2003 (Windows XP also has this interface). For Windows 2000, the views are almost identical except that the "roles" screens are not shown in Windows 2000 for this sequence.


IMPORTANT NOTE:
For Windows 2003 only, be sure to follow the extra step required for component access checking changes at the bottom of this page after step 18.

(
This extra step is not necessary for Windows 2000.)
 

1. Create a directory called "JustFTP" in "C:\Program Files\ComPlus Applications". 
    i.e. "C:\Program Files\ComPlus Applications\JustFTP".

2. Copy the justftp.dll file into this directory.

3. Start the Component Services GUI  from the start menu: Start / Programs / Administrative Tools / Component Services. (Or, Control Panel / Administrative Tools / Component Services).

4. Expand "My Computer" as shown below. Select COM+ Applications and right click. Select New / Application as shown in Fig 1.
 


Fig 1.

 

5. The COM+ App. install dialog pops up as shown in Fig 2. Click Next.


Fig 2.

 

6. Click "Create an empty application". Fig 3.


Fig 3.

 

7.  As shown in Fig 4. enter the name JustFTP and ensure "Server application" is selected for the Activation Type. Click Next.


Fig 4.

 

8. At the Identity dialog, (Fig 5.) select "This user" and enter a valid domain or local computer account account username and password.
A local administrative user account is recommended.

(For Windows 2003 only, the "Network Service" account can be used,  however this account will only have "user" group rights).

We recommend, in this order that you either:

1. Choose an account that has the equivalent of local administrator rights.

    Or

2. Choose a domain account (if you have Active Directory deployed), and add that user to the local administrators group. When entering a domain the user, the full domain and username is required. This is typically entered as the "NetBIOS" name of the Microsoft Active Directory domain, a backslash, then the user ID (login ID). This can also be entered in domain DNS form "main.mycompany.com\Robot_user_42".

Click Next. NOTE: At this point, the credentials entered are checked. If you receive an error, the credentials are invalid for some reason.


Fig 5.

 

9.  For Fig 6. and Fig 7. no "roles" are modified. simply click Next.

NOTE: Windows 2000 does not prompt with these dialog boxes.


Fig 6.

 

AGAIN NOTE: Windows 2000 does not prompt with these dialog boxes.

10. Click Next.


Fig 7.

 

11. As shown in Fig 8. click Finish to create the empty COM+ application.


Fig 8.

 

12. The empty JustFTP 'package' should now be showing in the COM+ Applications tree. We will now add the JustFTP ActiveX component to this application.

Expand the JustFTP entry and select components as shown in Fig 9.


Fig 9.

 

13. Right click Components and select New Component as shown in Fig 10.


Fig 10.

 

14. The COM+ Component install dialog pops up as shown in Fig 11. Click Next.


Fig 11.

 

15. Click "Install new components" as shown in Fig 12.


Fig 12.

 

16. Select justftp.dll by browsing to the directory as shown in Fig 13. Double click it, (or select it and click "Open").


Fig 13.

 

17. The dialog shown in Fig 14. should open and the File and Components found will be populated with the correct entries automatically. Click Next to install and register the JustFTP component.


Fig 14.

 

18. Click Finish to end the component install process for JustFTP. As shown in Fig 15.


Fig 15.

 

18. Examine the JustFTP component tree. It should show all 9 methods of the component as shown in Fig 16.


NOTE: The above procedure correctly registers JustFTP in the registry. There is no need to give the manual regsvr32 command.


Fig 16.

IMPORTANT NOTE FOR Windows 2003:

Default security settings will restrict access to JustFTP. Access denied errors will occur unless this extra step is completed.
 
Perform this extra step on Windows 2003 installations of JustFTP in COM+.

Open Component Services, locate JustFTP and right click on JustFTP.

Select properties to open the property dialog.

Select the security Tab and uncheck the "Enforce access checks for this application" checkbox as shown below.

JustFTP can now be called by IIS, scripts and applications without "access denied" errors.

(There is no need to perform this step for Windows 2000.)

This completes the installation of JustFTP as a managed COM+ application.

See sample code.

Download the trial version 404 KB



 

Google
 
Web easterndigitalsoftware.com

Copyright 2006 Eastern Digital Pty. Ltd. Australia.  ABN 87 004 274 051
Home | Contact us | Products | Downloads | Support | Privacy Policy