Lesson 7: Configure the Agent on the remote device

In this lesson, you run the MobiLink Agent. The MobiLink agent must be running on each remote device that is centrally administered. For this tutorial, the Agent runs on the same machine where the server is running.

 To configure the agent on the remote device

  1. Start by creating a directory that contains the files that would normally be on the remote device.

    md c:\cadmin_demo\remote
cd c:\cadmin_demo\remote

  2. Next, run the MobiLink Agent in configuration mode as follows:

    mlagent -cr -db . -x tcpip{host=localhost;port=2439} -a AID_JOHN  -u JOHN -p sql

    This step creates an agent database and stores some configuration information in it. Once the specified options are stored in the database, the Agent shuts down. Following is a summary of the options you used:

    • -cr   Specifies that the Agent should run in configuration mode and that it should discard any settings stored during previous runs in configuration mode.

    • -db   Specifies where the Agent should create application databases. This becomes the value of the {db_location} macro.

    • -x   Specifies how the Agent should connect to the MobiLink server to synchronize its agent database (to receive new tasks and upload results of tasks it has run). If you are adding central administration to an existing synchronization system, you need to change the value specified for this option to an appropriate string for connecting to your MobiLink server.

    • -a   Specifies the Agent ID for this Agent. Notice that you specified the same Agent ID that you previously created in the consolidated database using Sybase Central.

    • -u   Specifies the MobiLink user the Agent uses when synchronizing the agent database. This value is used by the server primarily to authenticate the Agent.

    • -p   Specifies the password that goes with the MobiLink user specified with the -u option.

  3. Lastly, you need to run the MobiLink Agent on the remote device. For this tutorial, you explicitly start the Agent running as follows: 

    start mlagent -v9 -ot agent.txt

    Following is a summary of the options used to run the Agent in this lesson:

    • -v9   Use maximum verbosity. This is great for a tutorial but in a production environment you might want to choose lower verbosity except when you are troubleshooting.

    • -ot   Specifies the file where the Agent logs its output.

  4. You should now have the MobiLink Agent running and it should be synchronizing successfully. To check, return to Sybase Central. In the Folders view, under Central Admin Tutorial » Consolidated Databases » Tutorial » Agents » click AID_JOHN and look at the Events tab in the right pane. You should see an entry that indicates the Agent's first synchronization.

 Production considerations for Agent configuration
Copyright © 2010, iAnywhere Solutions, Inc. - SQL Anywhere 12.0.0