Infiniti Design Manual Deployment

Infiniti Design Manual Deployment

Infiniti design uses Microsoft ClickOnce technology, part of the Microsoft .NET Framework, for deployment when an authorised users clicks the Design button from within the Manage application. Most of the time this works extremely well, ensuring that the user is always using the current version of Design to match the Infiniti environment’s version – extremely useful for environments with multiple instances of Infiniti.

In some circumstances ClickOnce may fail, or may not be allowed within the environment. If it fails it may be useful to refer to the following Microsoft Developer Network (MSDN) article on troubleshooting ClickOnce deployments:

http://msdn.microsoft.com/en-us/library/fb94w1t5.aspx

In the case of ongoing failure, or not allowing ClickOnce in an environment, it may be useful to manually deploy Infiniti Design to a form designer’s PC. The steps below describe how to manually deploy Infiniti Design.

Considerations

The following considerations should be made before pursuing this deployment technique:

  • While this guide may provide a useful alternative for getting Design to work without ClickOnce, it’s not an official deployment technique and may not be supported.
  • WARNING - It’s critical that Infiniti Design remain in sync with the version of the Infiniti Manage site that it’s pointing to. Launching Design from within Manage via ClickOnce ensures this for you, so when deploying manually if you upgrade Infiniti you must then manually redeploy Design to match. Failure to match versions may result in unexpected behavior including loss of design work, and is not covered under support and maintenance.

What you’ll need before you begin

Before you begin manual deployment of Infiniti Design, ensure that you have the following:

  • Access to the file system on the Infiniti web server to copy files. Note these instructions assume you can use Windows Explorer to navigate to the web server from the target Design PC.
  • Full administrator access to the target Design PC.
  • The target Design PC should already meet the Design prerequisites installed:
    • Microsoft .NET 4 (full)
    • Microsoft Office Word 2007 or later
  • Access to run Microsoft Windows PowerShell on the target Design PC (or be willing to manually change a lot of file names).

The deployment steps

  1. On the Infiniti web server, open Windows Explorer and navigate to the ‘Manage\Design\Application Files’ folder. By default this is:

    c:\Inetpub\wwwroot\Infiniti\Manage\Design\Application Files
  2. Within this folder there is likely to be several subfolders, named ‘InfinitiDesign_n_n_n_n’ (where n is each part of a version number). Pick the subfolder with the latest version number, and open its contents in Windows Explorer. For example:

    c:\Inetpub\wwwroot\Infiniti\Manage\Design\Application Files\InfinitiDesign_8_4_0_13
  3. Select all files and subfolders and copy to the clipboard, either using the mouse or by using the ‘CTRL+A’ (select all) and ‘CTRL+C’ (copy) keyboard shortcuts.
  4. In Windows Explorer navigate to a suitable destination on the target Design PC, creating a new folder if necessary. Note that it is recommended that you use a folder for each Infiniti environment you wish to connect Design to, if you wish to design forms for multiple environments. For example, you may wish to copy files to a folder named ‘c:\Infiniti\design_dev’ for a development environment, and ‘c:\Infiniti\design_test’ for a test environment.
  5. Paste the copied files to the destination folder selected in step 4.
  6. From Windows Start run the PowerShell utility.
  7. In the command line within PowerShell, enter the following command. Note that for all command line instructions, <ENTER> represents pressing the Enter key on the keyboard rather than entering each letter literally.

    CD {Design Folder} <ENTER>

    Note: {Design Folder} refers to the full path of the folder where you copied the Design application files, e.g. ‘CD c:\Infiniti\design_dev’.
  8. Now enter the following command.

    Get-ChildItem -recurse -name | ForEach-Object { Move-Item $_ $_.replace(".deploy", "") } <ENTER>

    Note: The above command is wrapped in this document but should be one single line, and there is a single space character between ‘$_’ and ‘$_.replace’.

    Also note: When running this command, there may be an error message that appears many times with an error along the lines of ‘The process cannot access the file because it is being used by another process.’ If this happens, just check that the files in the target folder no longer end with ‘.deploy’ to know that the shell command has worked correctly despite this error. Strange, yes, but still significantly better than manually renaming each file.
  9. Using Notepad or similar text editor, open the file named ‘InfinitiDesign.exe.config’. Note that you may need to run Notepad as an administrator to allow saving changes, depending on your environment configuration.
  10. Find the <appSettings> node within the config file, and modify the value of the ServiceURL setting to the URL for Infiniti Manage for the environment you wish to design projects. For example:

      <appSettings>
        <add key="ServiceURL" value="http://infinitiserver/manage/" />
      </appSettings>
  11. Save and close notepad.

Test that it worked

Once you’ve completed the above steps you’re ready to run a test. Simply double-click the InfinitiDesign.exe application file and you should see a login prompt. Enter your Infiniti credentials to open Design.

To ensure there are no further issues with using Design, check that you can see a list of existing forms in the environment (if any exist) by clicking the ‘Open from Database’ option.

 

Related Articles

 

 

Keywords

 

design manual deployment .net framework clickonce technology