|
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
|
