Getting started with xfNetLink .NET

This topic lists all the steps that need to be completed to successfully create a distributed system using xfNetLink .NET. Note that these steps may not all be done by you, the Synergy developer. For example, you may create the Synergy assembly and give it to a .NET developer to create a web front‑end for your application. The .NET developer may also work with a web‑page developer to create the HTML portions of the user interface. However, these steps should give you a feel for everything that needs to be done, regardless of who does it.

1. Install Visual Studio and the .NET Framework.
2. Install the necessary Synergy software. The components you need to install vary depending on your set‑up (e.g., what OS your source files are on, where you intend to do the development, and so on).
3. Modularize your existing Synergy code for the routines that you want to access remotely and encapsulate them in ELBs or shared images. See Preparing Your Synergy Server Code.
4. Populate the Synergy Method Catalog with information about your Synergy routines. We recommend that you do this by attributing your code and running dbl2xml (see Using attributes to define Synergy methods). Alternatively, you may use the Method Definition Utility to enter the data (see Using the MDU to define Synergy methods). As you do this, you’ll group the routines into interfaces.

If you choose to put the SMC somewhere other than DBLDIR, set the XFPL_SMCPATH environment variable. See Defining Your Synergy Methods.

5. In the xfpl.ini file, set logging options for the xfServerPlus log and set logicals that point to the ELBs you specified in the SMC. You may also need to set other options in the xfpl.ini file; see Appendix A: Configuration Settings for a complete list of xfpl.ini configuration settings.

If you choose to put the xfpl.ini file somewhere other than DBLDIR, set the XFPL_INIPATH environment variable.

For information on the log and XFPL_INIPATH, see Using server‑side logging and Setting the XFPL_INIPATH environment variable. See Defining logicals for information on setting logicals that point to your ELBs.

6. Create a user account on the xfServerPlus machine to run xfServerPlus sessions and then start xfServerPlus. See the topic for your operating system:
7. Generate the C# classes:
8. (optional) Modify the generated C# source files and the metadata for the assembly as necessary. See Editing the generated C# files.
9. (optional) Set the SYNCSCOPT environment variable to include C# compiler options that you want added to the command line when the assembly is built.
10. Build the assembly:
11. (optional) Generate the API documentation for the methods in your assembly using a third‑party utility. See Generating API documentation.
12. Distribute the assembly and other necessary files to the .NET developer, who will then use the assembly when writing the client‑side code for your distributed application. See Setting up your environment for development and Using your Synergy .NET assembly: The basics.  

1. Steps in creating an xfNetLink .NETxfServerPlus application.