This appendix contains the following topics:
Creating an Update Package with the Visual Studio Runtime Library Feature
Building and Deploying an Update Package with the Visual Studio Runtime Library Feature
Installing the Visual Studio Runtime Library on an Enterprise Server
Note:
All references to Microsoft Visual C++ refer to the defined JD Edwards EnterpriseOne minimum technical requirement Microsoft Windows platform compiler. Please refer to the JD Edwards EnterpriseOne minimum technical requirements to identify supported versions of the Microsoft Windows platform compiler.This section discusses:
Microsoft Visual C++ runtime libraries background.
Redistribution of Microsoft Visual C++ runtime libraries.
When you build new packages using the Microsoft Visual C++ compiler, you must ensure that all machines receiving these packages have the corresponding runtime libraries installed. Assuming Microsoft makes a new service pack available or requires an update for its Microsoft Visual C++ compiler and it is installed on your JD Edwards EnterpriseOne Microsoft Windows build machines, you must do the following:
Ensure that all JD Edwards EnterpriseOne Microsoft Windows build machines, both servers and workstations, have the identical compiler service pack release levels installed.
Distribute the new Microsoft Visual C++ runtime libraries to all Microsoft Windows machines that are receiving packages built by Microsoft Visual C++ and do not have a compiler installed.
Note:
You can download the latest SP (service pack) from the Microsoft Download Center.All JD Edwards EnterpriseOne Microsoft Windows machines receiving application foundation packages require the runtime libraries to be installed.
The absence of the Microsoft Visual C++ runtime libraries from a machine using a JD Edwards EnterpriseOne application foundation package built by the same compiler will result in "Business function Library load failed..." error messages. Once the Microsoft Visual C++ runtime libraries are installed on a Microsoft Windows machine, only new service pack updates or Microsoft Updates to the Microsoft Visual C++ compiler require redistribution of new runtime libraries.
Note:
Please refer to the JD Edwards EnterpriseOne defined Microsoft Windows platform compiler minimum technical requirements.A Microsoft or third-party system management tool such as SMS can be used to distribute the Microsoft Visual C++ runtime libraries. This is generally the recommended approach for the distribution of Microsoft packaged products. The JD Edwards EnterpriseOne package build feature can also be used to push Microsoft's redistributable runtime library package to all Microsoft Windows client machines. Delivery of Microsoft Visual C++ runtime libraries for JD Edwards EnterpriseOne enterprise, logic, application, or batch servers is also explained in this appendix.
The JD Edwards EnterpriseOne package build feature makes it possible to distribute third party applications with the deployment of a client package. Create a package feature for the Microsoft Visual C++ compiler runtime libraries to leverage this facility.
The deployment server should have a copy of the compatible vcredist_x86.exe. For example, the Runtime Libraries path for the 2008 compiler release is C:\Program Files\Microsoft SDKs\Windows\v6.0A\Bootstrapper\Packages\vcredist_x86.
To create a Visual Studio runtime library package feature:
On the deployment server, open Windows Explorer and navigate to your JD Edwards EnterpriseOne solution's shared folder. For example, E900.
Expand the shared node and open OneWorld Client Installs\ThirdParty.
Under the folder ThirdParty, create a new folder with the name VS20xxRTL (xx is equal to the current version).
Locate and copy the vcredist_x86.exe file from your installed compiler path.
Copy the vcredist_x86.exe file into the VS20xxRTL folder.
Log into the deployment server's DEP900 environment.
Fast path to menu GH9083, Package and Deployment Tools, and select the Package Assembly application.
On the Work with Packages form, select Form and then Features.
On the Work with Features form, click Add.
Click Next to begin the Feature Based Deployment Director.
On the Feature Information form, complete these fields and click Next:
| Field | Value |
|---|---|
| Feature | VS20xx_RTL |
| Feature Type | 1 |
| Description | Visual C++ 20xx Runtime Libraries |
| Feature Installation Options | Required |
| Components | Additional Install Processes |
On the Additional Install Processes form, select the Execute After Install option.
Complete these fields and click Next:
| Field | Value |
|---|---|
| Third Party | VS20xxRTL |
| Description | Visual C++ 20xx Runtime Libraries |
| Sequence | 1 |
| Executable Name | vcredist_x86.exe
This is the name of the executable file found in the ...\ThirdParty\VS20xxRTL folder. |
| Source Path | \\<deploymentservername>\E900\OneWorld Client Install\ThirdParty\VS20xxRTL
Note: Do not use the Select Directory browse function to obtain the aforementioned path. Instead type the UNC path or cut and paste the Universal Naming Convention (UNC) path from Windows Explorer into the Source Path field. |
| Parameters | /Q
/Q denotes Quiet Mode and does not require any user intervention. |
Click Save to preserve the feature settings and then click Next to continue.
On the Feature Summary form, click End to complete the feature definition.
Note:
If you expand the nodes describing each package feature you may inspect the feature definition. You may notice that the UNC share path has been truncated for your newly created entry. This is NOT an issue as this line entry serves only as a description. The complete UNC share path has been properly preserved in System table F96604.Once the Visual Studio runtime library package feature has been created, it can be associated with either an update or full package. Creating an update package containing this feature will cause the full parent package assembly information to include this same feature.
To create an update package with the Visual Studio runtime library feature:
Go to menu GH9083, Package and Deployment Tools, and select the Package Assembly application.
On the Work with Packages form, click Add.
On the Package Assembly Director, click Next to begin the package assembly process.
On the Package Information form, select the Express option, complete these fields, and click Next:
| Field | Example Value |
|---|---|
| Package Name | DV20xxRTL |
| Description | Visual C++ 20xx RTL for DV |
| Path Code | DV900 |
On the Package Component Revisions form, select the Update option and type or select the parent package. For example, DV900FA.
Click the Features button.
On the Features Components form, click the Browse button.
On the Feature Component Selection form, click Find.
Highlight the entry associated with VS20xx_RTL and click Select to mark the entry with a check mark.
Click Close and Close again to return to the Package Component Revisions form.
Verify that the form shows "Individual Features Selected" and click End to complete the package assembly process.
On the Work with Packages form, select Row and Active/Inactive to activate the package.
After creating the update package, you will need to build and deploy the package. To build and deploy an update package with the VS2005 runtime library feature:
Highlight your package and select Row and Define Build.
On the Package Build Definition Director, click Next to begin the build definition process.
On the Package Build Revisions form, ensure that the Build Location Client check box is checked and click Next.
On the Build Features tab, select the Build Feature INFs option.
On the Package Build Revisions form, click End to complete the build definition process.
On the Work with Package Build Definition form, select Row and Active/Inactive to activate the package build definition.
Select Row and Submit Build to build the package.
On the Report Output Destination form, select On Screen and click OK.
Once the package build has completed, review the R9621 PDF report file to verify that the build completed successfully.
The successful package build with the included package feature results in the creation of a feature-specific INF file.
After building the package, the appropriate person must approve it for client deployment.
Afterwards, both the update and associated parent package will automatically include the Microsoft Visual C++ runtime libraries as part of the client installation process.
Since this feature was configured to install in Quiet Mode (/Q), it does not require any user intervention. If the Microsoft Visual C++ runtime libraries are already installed on the machine, the feature-specific installer will exit.
All JD Edwards EnterpriseOne Microsoft Windows machines receiving application foundation packages built by Microsoft Visual C++ require the runtime libraries to be installed.
Customers using a JDEdwards EnterpriseOne enterprise, logic, application, or batch server that does not have a Microsoft Visual C++ compiler installed, must install the associated Microsoft redistributable runtime library package (vcredist_x86.exe). Failure to install the runtime libraries while using a Microsoft Visual C++ built application foundation package on a machine without the supported compiler will result in "Business function Library load failed ..." error messages.
A Microsoft or third-party system management tool such as SMS could be used to distribute the Microsoft Visual C++ runtime libraries to these machines. This is generally the recommended approach for the distribution of Microsoft packaged products. In the absence of a system management tool, simply install the Microsoft redistributable runtime library package (vcredist_x86.exe).
To install the Microsoft redistributable runtime library package:
Locate the vcredist_x86.exe file. For example, if you are using MS Visual Studio 2008 for package builds, the runtime library executable will be found in the following path: C:\Program Files\Microsoft SDKs\Windows\v6.0A\Bootstrapper\Packages\vcredist_x86.
Copy the vcredist_x86.exe file to a folder on your local machine.
Double-click the vcredist_x86.exe file executable to install the Microsoft Visual C++ runtime libraries.