Steps for building the installer programs using Microsoft Visual Studio
Before you begin
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.
Perform the following steps to build the installer programs for a PKI Services ActiveX program.
Procedure
-
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 PKICEnrollDeploy.
- 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, PKICEnrollDeploy).
- Click Add > File.
-
On the AddFiles window, navigate to the directory where the files were stored on the
workstation in step 1.
For PKICEnroll select these files:
- PKICEnroll.dll
- PKICEnroll.tlb
- PKIActiveX.lic
_______________________________________________________
-
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, PKICEnrollDeploy).
- 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
andMicrosoft_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, PKICEnrollDeploy).
- 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
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, PKICEnrollDeploy).
- 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 andC:\Program Files(x86)
for a 64-bit operating system. You set the value of Manufacturer to IBM® and the value of ProductName to 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, PKICEnrollDeploy).
- 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, PKICEnrollDeploy) 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, PKICEnrollDeploy).
- 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 PKICEnroll.reg and click Open.
_______________________________________________________
-
Set the ActiveX dynamic link library (PKICEnroll.dll) to be registered during
installation.
- Click View > Solution Explorer.
- Right click PKICEnroll.dll.
- Click Properties.
-
Set the Register field to
vsdraCOM
.
_______________________________________________________
-
Set the ActiveX type library (PKICEnroll.tlb) to be registered during install.
- Click View > Solution Explorer.
- Right click 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, PKICEnrollDeploy).
- 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, PKICEnrollDeploy) 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 PKICEnrollDeploy is the project name:
- C:\PKICEnrollDeploy is the solution name.
- C:\PKICEnrollDeploy\PKICEnrollDeploy is the root project directory.
- C:\PKICEnrollDeploy\PKICEnrollDeploy\Release is the output directory.
- There are two output files: PKICEnrollDeploy.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.