Building an Installation Package

From OriginLab Wiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 21:43, 10 February 2012 (edit)
Barb (Talk | contribs)

← Previous diff
Revision as of 22:31, 13 February 2012 (edit) (undo)
Barb (Talk | contribs)

Next diff →
Line 54: Line 54:
This section shows how you can prepare a template Origin installation, for use in "snap shot roll out" distributions. This section shows how you can prepare a template Origin installation, for use in "snap shot roll out" distributions.
-===Procedure to clean a machine of Origin 8.5.1===+===Procedure to clean a machine of Origin 8.6===
-When preparing a template installation, you should start with a "clean" machine - one that has not previously had Origin 8.5.1 installed on it. This is because although you can un-install a previous Origin 8.5.1 installation, the un-install program does not delete all the Registry entries written by the Origin setup. So when you record or prepare your Origin distribution package from a second Origin 8.5.1 installation, you may not include some needed Registry entries if they already exist (and thus were not changed by the second installation). <br>+When preparing a template installation, you should start with a "clean" machine - one that has not previously had Origin 8.6 installed on it. This is because although you can un-install a previous Origin 8.6 installation, the un-install program does not delete all the Registry entries written by the Origin setup. So when you record or prepare your Origin distribution package from a second Origin 8.6 installation, you may not include some needed Registry entries if they already exist (and thus were not changed by the second installation). <br>
-If you have already installed Origin 8.5.1 on a computer, and would like to "clean" it, then do the following:+If you have already installed Origin 8.6 on a computer, and would like to "clean" it, then do the following:
-# Keep Origin installed, or re-install Origin. Run Origin to set default User Files Folder.+# Keep Origin installed, or re-install Origin. Run Origin to set the default User Files Folder.
-# Run system.path.appdata$= in Script window to find where the folder is. Record this folder so you can delete it later.+# Run system.path.appdata$= in the Script window to find where the User Files folder is located. Record this folder so you can delete it later.
-# Run system.path.license$= in Script window to find where the license folder is. Record this folder so you can delete it later.+# Run system.path.license$= in the Script window to find where the license folder is located. Record this folder so you can delete it later.
# Open a DOS window and change directory into the Origin folder. # Open a DOS window and change directory into the Origin folder.
# Run the following commands one by one from the DOS prompt (make sure you have Administrative privileges). <br>regsvr32 /u vsFlex8L.ocx<br>regsvr32 /u GSpcIOLib.dll<br>regsvr32 /u OSoap.dll<br>regsvr32 /u tx4ole12.ocx<br>regsvr32 /u ActiveQueryBuilderXControls.ocx<br>This will unregister the DLLs that Origin registered. You must have Origin installed to unregister them, because these files are installed into the Origin directory. # Run the following commands one by one from the DOS prompt (make sure you have Administrative privileges). <br>regsvr32 /u vsFlex8L.ocx<br>regsvr32 /u GSpcIOLib.dll<br>regsvr32 /u OSoap.dll<br>regsvr32 /u tx4ole12.ocx<br>regsvr32 /u ActiveQueryBuilderXControls.ocx<br>This will unregister the DLLs that Origin registered. You must have Origin installed to unregister them, because these files are installed into the Origin directory.
-# Now uninstall Origin and remove the install directory if it still exists..+# Now uninstall Origin and remove the install directory if it still exists.
# Delete the AppData folder you stored earlier. # Delete the AppData folder you stored earlier.
-# Delete the License folder you stored earlier. In Vista/Win7, please check if there is Compatibility Files folder and also go above one level above License and check if there is Compatibility Files folder there. If so, delete them.+# In Windows 7 and Vista, check if the License folder you stored earlier has a Compatibility Files folder. If so, please delete it. Also, browse one folder up from the License folder and also check if there is a Compatibility Files folder. If yes, delete the Compatibility Files folder as well.
 +# Delete the License folder you stored earlier.
# Go to the Origin program folder in the Start menu and find the User Files Folder link. Click it to find the User Files Folder. Delete the User Files Folder. Then delete the link. # Go to the Origin program folder in the Start menu and find the User Files Folder link. Click it to find the User Files Folder. Delete the User Files Folder. Then delete the link.
# Click the autosave shortcut, and delete the folder. Then delete the shortcut. # Click the autosave shortcut, and delete the folder. Then delete the shortcut.
# Delete the whole Origin Start folder. # Delete the whole Origin Start folder.
# Open the registry key HKEY_CURRENT_MACHINE/Software/OriginLab # Open the registry key HKEY_CURRENT_MACHINE/Software/OriginLab
-# Check the following registry key: HKEY_CURRENT_USER\Software\OriginLab\Origin 8.5.1\. If found, delete it.+# Check the following registry key: HKEY_CURRENT_USER\Software\OriginLab\Origin 9\. If found, delete it.
# Run a registry editor with administrative privileges, and search and delete all the occurrences of the string vsFlex8L. # Run a registry editor with administrative privileges, and search and delete all the occurrences of the string vsFlex8L.

Revision as of 22:31, 13 February 2012


Go back to Multi-user Site Deployment

Contents

Things to consider before getting started

Methods for distributing Origin

There are two ways you can build an Origin installation package for distribution:

  • Preparing an MSI Installer: In this case you can use an MSI transform to pre-set the license management, the User Files Folder, registration, and other properties. You can include a batch file to run the MSI and the transform.
  • Template Installation: In this approach, you can install Origin on a "template" machine and then prepare an Origin package for distribution. As with the MSI package, you can pre-set the license management and other properties.

Post installation settings you can pre-configure in your distribution package

It is optional to configure the following settings in your installation package:

User Files Folder

The User Files Folder is the default file open and save location in Origin.
You can pre-set the User Files Folder by editing the Path key in the [User Files] section of the Origin.ini file, located in the Origin program folder. Comments are provided in the Origin.ini file to assist you.
If you do not pre-set the User Files Folder in your installation package, then each Origin user (each log in user) will be asked to select their own User Files Folder when they first start Origin. The user's Windows log in account does NOT need Administrator permissions to complete this step.

License management

If you have the Multi-seat Node Locked (Group) package, then you cannot pre-set the license management because each Origin computer requires a computer-specific license. The license is obtained from the OriginLab website using a dialog that opens when you run an unlicensed Origin. You can thus skip this section.
If you have the Concurrent Network package, you can pre-set the location of the FLEXnet license server so that the Origin users are not asked to specify this when they start Origin.
To configure this in your installation package, you must first create a text file named use_server.lic. You must then have your installation package install this text file into the Origin program folder \License folder that is created on the user computer by your installation package.
The use_server.lic text file you create must have the format:

SERVER <FLEXnet server Host Name or IP Address> ANY
USE_SERVER

Example:

SERVER main_server ANY
USE_SERVER

If you do not pre-set the location of the FLEXnet license server in your installation package, then when each user runs Origin on their computer, they will see a license dialog asking them to enter the Host Name or IP address of the FLEXnet server. The user's Windows log in account must have Administrator permissions to complete this step.

Registration

If you have the Multi-seat Node Locked (Group) package, registration occurs automatically when you license Origin on each computer. Thus you would not register Origin in your installation package. You can thus skip this section.
If you have the Concurrent Network package, you can register the Origin in your installation package so that Origin users are not asked to (optionally) register their Origin at start up.
To configure this in your installation package, you must first create a registration file using Origin. To do this, install Origin with your Concurrent Network serial number and then start Origin and connect to your FLEXnet server. Then select Help:Register Online. Complete the registration process by entering or pasting your Registration ID back into the Registration dialog. When you do this, Origin creates a registration file named RegID.lic. You can then locate this file on your computer, and include it in your installation package you plan to distribute. To find the RegID.lic file that Origin created, in Origin, open the Script window (Window:Script Window) and type in the following command and then press ENTER:

system.path.license$=

Origin will return the path to the License folder. The RegId.lic file is in the folder right above the License folder.
For example, on Vista/Win 7, if the License path is

C:\ProgramData\OriginLab\86\License\

then the RegId.lic file is in the path

C:\ProgramData\OriginLab\86\

Once you locate the RegID.lic file, then prepare your Concurrent Network installation package so that this RegID.lic file is written to the Origin program folder.
If you do not register Origin in your Concurrent Network installation package, then when each user runs Origin, they will see a Registration dialog requesting that they register Origin. Registration is optional - the user can choose not to register. If they do want to register, the user's Windows log in account must have Administrator permissions to complete this step.

The Origin Group Leader

The Group Folder / Group Leader feature allows you to set up a group leader which can serve as a source for distributing custom Origin files and patches to members of the group. Then once you have done this, you can set up the Origin in your installation package so that it is predefined to receive updates from the group leader.

Distributing your Origin installation package

Once you have your Origin installation package prepared, you can use a software distribution environment / software such as NetInstall or SMS to distribute the MSI package or the template installation.

Preparing an MSI installer

Preparing a Template installation

This section shows how you can prepare a template Origin installation, for use in "snap shot roll out" distributions.

Procedure to clean a machine of Origin 8.6

When preparing a template installation, you should start with a "clean" machine - one that has not previously had Origin 8.6 installed on it. This is because although you can un-install a previous Origin 8.6 installation, the un-install program does not delete all the Registry entries written by the Origin setup. So when you record or prepare your Origin distribution package from a second Origin 8.6 installation, you may not include some needed Registry entries if they already exist (and thus were not changed by the second installation).
If you have already installed Origin 8.6 on a computer, and would like to "clean" it, then do the following:

  1. Keep Origin installed, or re-install Origin. Run Origin to set the default User Files Folder.
  2. Run system.path.appdata$= in the Script window to find where the User Files folder is located. Record this folder so you can delete it later.
  3. Run system.path.license$= in the Script window to find where the license folder is located. Record this folder so you can delete it later.
  4. Open a DOS window and change directory into the Origin folder.
  5. Run the following commands one by one from the DOS prompt (make sure you have Administrative privileges).
    regsvr32 /u vsFlex8L.ocx
    regsvr32 /u GSpcIOLib.dll
    regsvr32 /u OSoap.dll
    regsvr32 /u tx4ole12.ocx
    regsvr32 /u ActiveQueryBuilderXControls.ocx
    This will unregister the DLLs that Origin registered. You must have Origin installed to unregister them, because these files are installed into the Origin directory.
  6. Now uninstall Origin and remove the install directory if it still exists.
  7. Delete the AppData folder you stored earlier.
  8. In Windows 7 and Vista, check if the License folder you stored earlier has a Compatibility Files folder. If so, please delete it. Also, browse one folder up from the License folder and also check if there is a Compatibility Files folder. If yes, delete the Compatibility Files folder as well.
  9. Delete the License folder you stored earlier.
  10. Go to the Origin program folder in the Start menu and find the User Files Folder link. Click it to find the User Files Folder. Delete the User Files Folder. Then delete the link.
  11. Click the autosave shortcut, and delete the folder. Then delete the shortcut.
  12. Delete the whole Origin Start folder.
  13. Open the registry key HKEY_CURRENT_MACHINE/Software/OriginLab
  14. Check the following registry key: HKEY_CURRENT_USER\Software\OriginLab\Origin 9\. If found, delete it.
  15. Run a registry editor with administrative privileges, and search and delete all the occurrences of the string vsFlex8L.

Installing Origin

Your Origin distribution package must include all the files installed by the Origin setup, as well as the Registry entries written by the Origin setup. When running the setup, please keep the following points in mind:

  • On the Origin Setup | Customer Information page, the User Name and Company Name that you enter will display in the About Origin dialog box for all users you distribute to.
  • On the Origin Setup | All Users or Current User? page, select All Users.

Post-installation settings

Please review the Post installation settings you can include in your package above to learn about settings you can pre-configure in your template installation.

Final notes

At this point your Origin template installation package should be ready to distribute. If you started Origin and selected a User Files Folder, you can omit your User Files Folder from the package.