1 / 109

NETConductor Getting Started

NETConductor Getting Started. Covered. Installation requirements NETConductor installation NETConductor license files Starting the DataTier in client Starting the DataTier in NAS Accessing MiddleTier How does it work? How fast is it? Invoker. On to installation requirements.

mika
Download Presentation

NETConductor Getting Started

An Image/Link below is provided (as is) to download presentation Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author. Content is provided to you AS IS for your information and personal use only. Download presentation by click this link. While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server. During download, if you can't get a presentation, the file might be deleted by the publisher.

E N D

Presentation Transcript

  1. NETConductor Getting Started

  2. Covered • Installation requirements • NETConductor installation • NETConductor license files • Starting the DataTier in client • Starting the DataTier in NAS • Accessing MiddleTier • How does it work? • How fast is it? • Invoker

  3. On to installation requirements.

  4. Installation requirements • The following slides show the requirements that must be installed before the NETConductor can be installed !

  5. Dynamics NAV Server NAV Database Server • NETConductor requires a NAV Database Server both Native and SQL servers are supported NAV

  6. Dynamics NAV Server NAV Application Server • For production we suggest NAV Application Server but a NAV Client is fine for initial setup and testing. NAV NAS NAS

  7. NAS Dynamics NAV Server IIS Internet Information Service (IIS) • NETConductor requires Internet Information Service NAV NAS IIS

  8. NAV NAS IIS NAS Dynamics NAV Server IIS Microsoft .NET Framework 2.0 Microsoft .NET Framework 2.0 .NET Framework 2.0 • In order for the installation and execution of the NETConductor, the .NET Framework must be properly installed on all machines where the NETConductor is going to be running.

  9. On to NETConductor installations.

  10. NETConductor installation • The following slides describe what application components are installed when the two NETConductor installation wizards are run.

  11. NAV NAS IIS NAS Dynamics NAV Server IIS Microsoft .NET Framework 2.0 Microsoft .NET Framework 2.0 NETConductorDataTier being installed. • When installed, the DataTier registers an OCX that is then started by the NAS. DT

  12. DataTier Wizard • You start the installation of the DataTier by double-clicking on the .msi file, located on the distribution media. • %DistributionMedia%\NETC_XXX\DataTier\NETConductorDT.msi

  13. DataTier Wizard Page 1 Press ‘Next’ The start page of the NETConductorDT installation wizard !

  14. DataTier Wizard Page 2 This is the folder where the OCX and accompanied files will be stored. Just use the default ! You should always select ‘Everyone’ so that any Windows user can start the DataTier ! Press ‘Next’ Select folder for OCX and accompanied files !

  15. DataTier Wizard Page 3 Press ‘Next’ Page to indicate that the installation is about to start !

  16. DataTier Wizard Progress The installer will wait a bit to start with and then run through the progress bar a couple of times –just be patient ! Installation is currently underway !

  17. DataTier Wizard Reminder This is a small Readme file just to notify the developer that he must have a valid rdn.rlf and fin.flf files to use the NETConductorDataTier. Press ‘Next’ Remember that you have to install license files !

  18. DataTier Wizard Complete Press ‘Close’ You are done !

  19. NAV NAS IIS NAS Dynamics NAV Server IIS Microsoft .NET Framework 2.0 Microsoft .NET Framework 2.0 NETConductorDataTier installed ! • To complete the DataTier installationyou have to load the DataTier .fob file into NAV. • C:\Program Files\Rue de Net\NETConductor\DT\fobs DT NB: If running with SQL Server, you need to re-compile the objects in the fob, because the Session table (2000000009) is different !

  20. NAV NAS IIS NAS Dynamics NAV Server IIS Microsoft .NET Framework 2.0 Microsoft .NET Framework 2.0 NETConductorMiddleTier being installed. • When installed, the MiddleTier createsWeb Services that are hosted by the IIS. DT MT

  21. MiddleTier Wizard • You start the installation of the MiddleTier by double-clicking on the .msi file, located on the distribution media. • %DistributionMedia%\NETC_XXX\MiddleTier\NETConductorMT.msi

  22. MiddleTier Wizard Page 1 Press ‘Next’ The start page of the NETConductorMT installation wizard !

  23. MiddleTier Wizard Page 2 When using the NETConductoroperations, without providing a DataTier, this is the DataTier that will be used. Location of the rdn.rlf file. Defaults to the installation directory of the DataTier (convenient when both are installed on the same machine) Press ‘Next’ Location of the fin.flf file. Again, defaults to the installation directory of the DataTier. License file directories (can later be found in Web.config) !

  24. MiddleTier Wizard Page 3 This is the site onto which you want to install the MiddleTier. Usually this is the “Default Web Site” but you may have configured your IIS with other sites that you may want to use for the MiddleTier. This is the directory to install the MiddleTier to. This means that you access it using a URL like: http://localhost/NETConductor. Press ‘Next’

  25. MiddleTier Wizard Page 4 Press ‘Next’ Page to indicate that the installation is about to start !

  26. MiddleTier Wizard Progress Page 5 The installer will wait a bit to start with and then run through the progress bar a couple of times –just be patient ! Installation is currently underway !

  27. MiddleTier Wizard Reminder Page 6 This is a small Readme file just to notify the developer that he must have a valid rdn.rlf and fin.flf files to use the NETConductorMiddleTier. Press ‘Next’ Remember that you have to install license files !

  28. MiddleTier Wizard Complete Page 7 Press ‘Close’ You are done !

  29. NAV NAS IIS NAS Dynamics NAV Server IIS Microsoft .NET Framework 2.0 Microsoft .NET Framework 2.0 NETConductorMiddleTier installed ! • Both tiers of the NETConductor have now been installed. Before you can use the NETConductor you have to install license files ! DT MT

  30. On to NETConductor license files.

  31. NETConductor license files • The following slides show how the license files are loaded by the DataTier and the MiddleTier.

  32. NAV NAS IIS NAS Dynamics NAV Server IIS Microsoft .NET Framework 2.0 Microsoft .NET Framework 2.0 Location stored in NAV fin.flf rdn.rlf NETConductorDataTier license file ! • When the DataTier is started, directories are given, in which it searches for the rdn.rlf and fin.flf license-files. • C:\Program Files\Rue de Net\NETConductor\DT • C:\Program Files\Rue de Net\NETConductor\DT\CFront370 DT MT The DataTier will not start without valid license files !

  33. C:\Program Files\Rue de Net\NETConductor\DT • C:\Program Files\Rue de Net\NETConductor\DT\CFront370 Same as for the DataTier ! NAV NAS IIS NAS Dynamics NAV Server IIS Microsoft .NET Framework 2.0 Microsoft .NET Framework 2.0 Location stored in NAV fin.flf rdn.rlf NETConductorMiddleTier license file ! • The MiddleTier uses a Web.config configuration file to store the directories used to find the rdn.rlf and fin.flf. DT MT Location stored in Web.config fin.flf rdn.rlf

  34. NAV NAS IIS NAS Dynamics NAV Server IIS Microsoft .NET Framework 2.0 Microsoft .NET Framework 2.0 Location stored in NAV fin.flf Location stored in Web.config fin.flf rdn.rlf rdn.rlf NETConductorMiddleTier license file ! • You can verify the validity of the MiddleTier license file using a browser. • http://localhost/NETConductor/Configs.asmx/GetLicense DT MT Browser License should have ‘Valid’=True and ‘Expired’=False !

  35. On to starting the DataTier in client.

  36. Starting DataTier in client • The following slides show, first, how to start the DataTier in a NAV Client. • The next section will then show how to start it in a NAV Application Server.

  37. NETConductorDataTier being started. To start with you want to run the DataTier in a NAV client because then you can see errors and respond to them more quickly. You must remember to have a NAV Database running and you must have loaded the .fob file of the DataTier into that database. When you are ready, you start by runningForm 84920 NETConductor NB: If running with SQL Server, you need to re-compile the objects in the fob, because the Session table (2000000009) is different !

  38. Form 84920 NETConductor Create Config. Just leave the ID empty and press enter to create a new DataTier configuration.

  39. Form 84920 NETConductor Create Config. Your new configuration, with ID NC0001, has now been created and many default values have automatically been entered. The configuration has been given a default description that you should change to your liking.

  40. Form 84920 NETConductorDataTier Each DataTier has a service-name that the MiddleTier uses to hook up with it. Many running DataTiers can have the same service-name, in which case the MiddleTier will do load-balancing between them (in a Round-Robin fasion) When the DataTier is running it will accept TCP/IP connections, from Middle-Tiers, on this port. Only one DataTier can be accepting connections on each port on each machine.

  41. Form 84920 NETConductor DataTier The ‘Base Path’ is the location of license files, configuration and log files. Calculated location of the rdn.rlf file based on the given ‘Base Path’.

  42. Form 84920 NETConductor XML Specifies the limit on records in a response from the NETConductor. The nodes in the XML reply can either have their original names or simply use the names Record or Field. XSD Schemas can be included inline or externally. Value format can be local NAV or Universal. Verbosity settings specify how detailed the xml reply will be. These are presets for XML settings.

  43. Form 84920 NETConductor Mail When the DataTier is running and a call is made into a CodeUnit (for example) an error may be raised. If this happens when running the DataTier in a client, it will simply open up the well-known ERROR dialog. But if running in a NAS the ERROR is written into the Windows Event Log. Now, by indicating a Mail Server here, an administrator can get an e-mail on every such error. Ask your administrator for the machine name of the SMTP server on you local network. When you have the SMTP server name or IP, you can check if the SMTP is running by using ‘telnet servername 25’ in a DOS command prompt. If there is no server running on the machine you will get an error. Otherwise, you will have a connection.

  44. Form 84920 NETConductor Mail This text will be the subject of the e-mail if an error occurs. It is therefore convenient to have a string that identifies this DataTier from others (even though the e-mail body will contain the complete configuration of the DataTier as well as the request being made when the error occured) The address, from whom the error e-mails will be sent. The addresses, to whom the error e-mails will be sent, can be either simple e-mail addresses or they can contain display names.

  45. Form 84920 NETConductor DataTier When the DataTier is running it can do logging of requests. If checked, the log-file will be created in the directory indicated by ‘Base Path’.

  46. NETConductorDataTier being started. • When you have created a valid configuration (like the NC0001 described before) you can start the DataTier.

  47. Form 84920 NETConductor Starting ... Press ‘Start’

  48. Form 84920 NETConductor Started ! When the DataTier is successfully started it will open up this message dialog when running in a NAV client.

  49. Form 84920 NETConductor Started ! If the DataTiers are running on other machines you can also see on what machines they are running. This indicates whether a session is online or not. The DataTiers send a heartbeat to indicate that they are alive/online. This shows the time of the last heartbeat. Number of requests processed by the DataTier. Number of records returned by the DataTier.

  50. On to starting the DataTier in NAS.

More Related