|
Before you beginYou need to have a tool such as Microsoft Visual Studio that builds an
installer program.
About this taskThese instructions describe how to use Microsoft Visual Studio Software Application
Version 2010 to create a setup and deployment Visual Studio project.
The project creates a directory to save the project setup files along
with the output files. If you select C: as the location
where the setup project is to be created, and PKIXEnrollDeploy as
the project name, the directory structure created would be as shown
in Table 1. Table 1. Directory structure for a sample project named
PKIXEnrollDeploy created in the C: directoryDirectory or file |
Description |
---|
C:\PKIXEnrollDeploy |
solution directory |
C:\PKIXEnrollDeploy\PKIXEnrollDeploy.suo |
solution property file |
C:\PKIXEnrollDeploy\PKIXEnrollDeploy.sln |
solution file |
C:\PKIXEnrollDeploy\PKIXEnrollDeploy |
root project directory |
C:\PKIXEnrollDeploy\PKIXEnrollDeploy\PKIXEnrollDeploy.vdproj |
project property file |
C:\PKIXEnrollDeploy\PKIXEnrollDeploy\Debug |
Build on debug version |
C:\PKIXEnrollDeploy\PKIXEnrollDeploy\Debug\PKIXEnrollDeploy.msi |
|
C:\PKIXEnrollDeploy\PKIXEnrollDeploy\Debug\setup.exe |
|
C:\PKIXEnrollDeploy\PKIXEnrollDeploy\Release |
Build on release version |
C:\PKIXEnrollDeploy\PKIXEnrollDeploy\Release\PKIXEnrollDeploy.msi |
|
C:\PKIXEnrollDeploy\PKIXEnrollDeploy\Release\setup.exe |
|
Perform the following steps to build the installer
programs for a PKI Services ActiveX program.
Procedure- For Windows XP
and earlier versions of windows, download the following files from
the directory /usr/lpp/pkiserv/ActiveX/signsrc on
the z/OS® system to a working
directory on your workstation:
- PKIXEnroll.dll
- PKIXEnroll.tlb
- PKIXEnroll.reg
- PKIActiveX.lic
For Windows Vista
and later versions of windows, download the following files from the
directory /usr/lpp/pkiserv/ActiveX/signsrc on the z/OS system to a working directory
on your workstation:- PKICEnroll.dll
- PKICEnroll.tlb
- PKICEnroll.reg
- PKIActiveX.lic
Note: Ensure that the files are transferred in binary format
so that they are not modified in transit.
_______________________________________________________
- Open Microsoft Visual
Studio Software Application Version 2010 from the Windows Start menu, and create a new setup
and deployment project.
- Click File > New Project.
- In the New Project panel, under Other Project Types select Setup
and Deployment.
- In the "Visual Studio installed templates" pane
(on the right) click Setup Project.
- In the Name field, enter the name of the project,
for example PKIXEnrollDeploy.
- In the Location field, enter the directory where
you want the project created, or click Browse to select a directory.
- Select Create directory for solution.
- Click OK. A new project directory
is created in a separate file directory in the path given in the Location field.
_______________________________________________________
- Add the required ActiveX Dynamic link library, the ActiveX
Type library file, and the ActiveX license file (PKIActiveX.lic) to
the current project to create the installer program.
- Click View > Solution Explorer.
- Right click the name of the project that you just created,
(for example, PKIXEnrollDeploy).
- Click Add > File.
- On the AddFiles window, navigate to the directory where
the files were stored on the workstation in step 1. For PKIXEnroll select
these files:
- PKIXEnroll.dll
- PKIXEnroll.tlb
- PKIActiveX.lic
For PKICEnroll select these files:- PKICEnroll.dll
- PKICEnroll.tlb
- PKIActiveX.lic
Click Open. The files you selected are listed under the
project on Solution Explorer. The DLL file has a dependency on Microsoft .NET Framework. Microsoft Visual Studio automatically
lists the dependency under the project.
_______________________________________________________
- Add the Microsoft C
Runtime Library and Microsoft Active
Template Library merge modules to be packaged in the installer program.
- On the Solution Explorer pane, right click the project
name (for example, PKIXEnrollDeploy).
- Click Add > Merge Module. A window opens listing
all the merge modules that were installed when Microsoft Visual Studio was installed.
- Click Microsoft_VC100_CRT_x86.msm and Microsoft_VC100_ATL_x86.msm and
click Open to add these files to the project.
_______________________________________________________
- Modify the project properties.
- From the Solution Explorer pane, click the project name
(for example, PKIXEnrollDeploy).
- On the toolbar click View > Other Windows > Property Window. A list of
properties with default values is displayed.
- For the Author property, enter IBM.
- For the InstallAllUsers property, enter True.
- For the Manufacturer property, enter IBM.
- For the ProductName property, enter PKIXEnroll or PKICEnroll.
- For the RemovePreviousVersions property, enter True.
_______________________________________________________
- Determine the default location where the ActiveX program
will be installed.
- Click View > Solution Explorer.
- Right click the project (for example, PKIXEnrollDeploy).
- Click View > File System. A File System pane
opens on the right side.
- In the File System pane, right click Application
Folder.
- Click Properties Window.
- Note the value listed in the Default
Location field. This is the location where the ActiveX program
will be installed. The default value is [ProgramFilesFolder][Manufacturer]\[ProductName].
The value of ProgramFilesFolder has been set by Microsoft Visual Studio to
the Program Files folder for the operating system: C:\Program
Files for a 32-bit Windows system
and C:\Program Files(x86) for a 64-bit operating
system. You set the value of Manufacturer to IBM® and the value of ProductName to
PKIXEnroll or PKICEnroll when you set the project properties in step 5. Do not modify any of these
values. The ActiveX DLL will look for the license file (PKIActive.lic)
in this directory. If it can't find it there, the ActiveX program
will not be instantiated on the browser and certificate renewal processing
might not work properly.
_______________________________________________________
- The User Interface command provides the interface for the
user during installation. It allows the user installing the ActiveX
program to select a directory for installation. Disable the folder
selection step, so that the location listed in step 6.f is used.
- Click View > Solution Explorer.
- Right click the project (for example, PKIXEnrollDeploy).
- Click View > User Interface. A User Interface
pane opens on the right side.
- Under Install, click Installation Folder and
click Delete.
- Under Install, under End right click Finished and
click Properties. Modify the UpdateText property to include
instructions to be displayed to the user after the installation of
the ActiveX program: Please refresh the PKI Certificate Renewal
web page to use the newly installed PKI ActiveX Control.
- Under Administrative Install, click Installation
Folder and click Delete.
- Under Administrative Install, under End right
click Finished and click Properties. Modify the UpdateText
property to include instructions to be displayed to the user after
the installation of the ActiveX program: Please refresh the
PKI Certificate Renewal web page to use the newly installed PKI ActiveX
Control.
_______________________________________________________
- The setup and deployment project (for example, PKIXEnrollDeploy)
can create registry entries for the ActiveX program. Once the ActiveX
program is installed on the target machine the ActiveX program is
registered and the browsers accessing this ActiveX program will instantiate
looking at the windows registry. The registry entries are created
using the Registry setup interface.
- Click View > Solution Explorer.
- Right click the project (for example, PKIXEnrollDeploy).
- Click View > Registry. A Registry pane opens
on the right side.
- Right click Registry on Target machine .
- Click Import. The Import Registry File window
opens.
- Click PKIXEnroll.reg or PKICEnroll.reg and click Open.
_______________________________________________________
- Set the ActiveX dynamic link library (PKIXEnroll.dll or
PKICEnroll.dll) to be registered during installation.
- Click View > Solution Explorer.
- Right click PKIXEnroll.dll or PKICEnroll.dll.
- Click Properties.
- Set the Register field to vsdraCOM.
_______________________________________________________
- Set the ActiveX type library (PKIXEnroll.tlb or PKICEnroll.tlb)
to be registered during install.
- Click View > Solution Explorer.
- Right click PKIXEnroll.tlb or PKICEnroll.tlb.
- Click Properties.
- Set the Register field to vsdrfCOM.
_______________________________________________________
- Build the setup and deployment project.
- Click Build > Release for the Build.
- Right-click the project (for example, PKIXEnrollDeploy).
- Select Properties. The Property Pages window
opens.
- Select Release in the Configuration list.
- On the right pane of the window that opens, click Prerequisites.
- Select the Create setup program to install prerequisite
components check box.
- In the list of prerequisites, select the .NET Framework
4.0 Client Profile (x86 and x64) check box if it is not already
selected.
- Select the Visual C++ 2010 Runtime Libraries (x86) check
box.
- Click OK. The Prerequisites window closes.
- Click OK. The Property Pages window closes.
- Click Build PKIXEnrollDeploy (project name: PKIXEnrollDeploy).
If the build is successful, the application creates an output
directory under the root project directory which will be under the
main solution directory. If PKIXEnrollDeploy is the project name: - C:\PKIXEnrollDeploy is the solution name.
- C:\PKIXEnrollDeploy\PKIXEnrollDeploy is the root project directory.
- C:\PKIXEnrollDeploy\PKIXEnrollDeploy\Release is the output directory.
- There are two output files: PKIXEnrollDeploy.msi and setup.exe.
_______________________________________________________
Results When you are done, you have built the installer program
for a PKI Services ActiveX program. Continue with step 2.c to sign the
installer program.
|