About this task
These 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.
- 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 that is 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
is going to 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 is going to 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 looks for the license file (PKIActive.lic)
in this directory. If it cannot find it there, the ActiveX program
is not 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.
_______________________________________________________
- 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 instantiates
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 View > Solution Explorer.
- Right-click the project name from the
Solution Explorer (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.
- Right-click the project (for example,
PKIXEnrollDeploy) and select Build.
If the build
is successful, the application creates an output directory under the
root project directory that is 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.
_______________________________________________________