This Quick Start is intended for Administrators to quickly get the Agent Control Center up and running with a couple of Sequentum Enterprise servers that participate in a cluster to provide load balancing and redundancy if a server fails or needs maintenance. If you only have a single Sequentum Enterprise server, you can still follow this guide, but just add a single Sequentum server to your cluster. You can easily add more Sequentum servers to your cluster later.
We also explain how to check-in agents to the Agent Control Center, and how to deploy them to a cluster and run or schedule them on the cluster.
You must have SQL Server 2016+ pre-installed on your Windows Server before your start the Agent Control Center installation on your server as the Agent Control Center will connect to the SQL Server database only. You can use the Express Edition of the SQL Server database as it is free to use and the Agent Control Center database does not require an Enterprise edition or paid edition of the SQL Server database.
Installing the Agent Control Center on Windows Server 2016
Enable the Web Server (IIS) server role and establish role services.
1. Open the Add Roles and Features wizard from Server Manager. If the link shown below is not available, use the Manage menu at the top right corner.
2. On the Server Roles step, check the box for Web Server (IIS).
If the following popup opens, click Add Feature to add the IIS Management Console.
3. After the Features step, the Role services step loads for Web Server (IIS). Accept the default role services provided.
4. Proceed through the Confirmation step to install the web server role and services. A server/IIS restart isn't required after installing the Web Server (IIS) role.
Install the .NET Core 3 Hosting Bundle
Download the installer using the following link:
1. Run the installer on the server.
2. Restart the server.
Install the Agent Control Center Web Portal
1. Run the latest Agent Control Center installer on the server.
2. Make sure the checkbox Configure Agent Control Center is checked and then click Finish.
The following web page will open if everything has been installed correctly. If you’re getting an error at this point, please make sure you restarted your server after you installed the .NET Core Hosting Bundle.
If you need to get back to the configuration page (if you need to restart your server for example), use the URL http://localhost:8010/config
3. The default URL for your ACC (Agent Control Center) will be your external IP address with port 8010. If you have a domain name mapped to your external IP address, then you can enter it here, but leave it as default for now, and you can come back and edit the URL later.
4. Enter an Organization name. This will be the name of you first organization, but you can edit this organization and add more organizations later. The organization name will normally be the name of your company, but can be any name.
5. Add a Super Admin user to your organization. The Super Admin user will have access to every thing in the ACC, including adding new organizations and users.
6. Generate an encryption key. The encryption key is used to encrypt sensitive information such as database and SMTP passwords. Choose Generate Key if you're performing a new ACC installation. This will generate a new encryption key and an unencrypted copy of this key will be placed in a file key.dat in the ACC installation folder. You should move this file to a secure location, since it's not required by the ACC unless you move your installation to a new server. If you later need to move your ACC installation to a new server or recover from a server failure, you can use this key to ensure the ACC can continue to read encrypted data.
7. The ACC needs to use a SQL Server database to store information. You can use your own SQL Server instance or install SQL Server Express which is free. If you want ACC to create a new database for you, the database user you specify must be authorized to create new databases. You can also enter the name of an existing database and let ACC create required database tables in your database. We recommend you create a dedicated database for ACC.
8. If you want to receive email notifications on certain events, such as when a job fails for example, you need to enter the details of an email SMTP server that can send out these emails. This could simply be your Gmail account or any other online email account you have, but we recommend you use a dedicated SMTP service if you have a large number of agents, since online email accounts often limits the number of emails you can send during a given time period.
The Sender Address is the email address that will send out the emails. Make sure your SMTP server allows this email address to send emails.
You can always come back to this page and configure your email settings later.
9. Click the Save button once you have completed configuration.
10. Once you save the configuration you’ll be redirected to the ACC login page. You can always reach the ACC portal on http://localhost:8010.
11. Use the username and password you specified during configuration to login to the Agent Control Center.
After logging in you’ll see the ACC Dashboard, which will be empty because you have no agents in the ACC.
12. We now need to add Sequentum Enterprise servers to the Agent Control Center. The Sequentum Enterprise servers only need Sequentum Enterprise installed, so no other configuration is required.
We’ll add two Sequentum Enterprise servers to the ACC, so we can create a cluster consisting of two servers. This will give us some redundancy if a servers fails or needs maintenance.
The ACC communicates with Sequentum servers on port 8004 by default, so make sure you first open port 8004 in the Windows firewall on the Sequentum servers. See Connecting a Sequentum Server to the ACC to learn how to open port 8004 in the Windows Firewall.
On each server, install the Sequentum Enterprise server edition, and then open the Sequentum Enterprise Editor. In the Sequentum Enterprise Editor open the Agent Control Center menu in the top right corner and select Login.
Enter the ACC URL configured in step 3 and the user name and password configured in step 5.
Open the Agent Control Center menu again and select Connect This Server.
Enter a server name and a local path, and then click Add. The local path is the directory where agents will be deployed on this server.
13. We now have two Sequentum servers connected to the Agent Control Center, so we can create a cluster consisting of those two servers. Open the ACC Portal again and then open the Servers menu and select Clusters.
14. Click the Add New Cluster link.
Enter a cluster name and select the two servers available.
15. We now need to give our Demo organization access to this new cluster. Select the Demo organization from the All Clusters drop down menu.
A new drop down menu will appear. Select the new cluster from this drop down menu and click the Add button next to the drop down menu.
The new cluster is now available to the Demo organization, and we can use it to deploy and run agents.
Running and Monitoring Agents
1. Before we can start running agents from the ACC, we need to check-in a couple of agents to the ACC Agent Repository. The ACC Agent Repository is a collection of agents organized in a directory structure similar to a normal file system. Each organization in the ACC has its own repository and users in the organization can check-in and check-out agents from the repository. All agents checked in to a repository are under version control, and the last 10 agent versions will be stored by default.
We’ll start by creating the following 3 sub-directories in our repository.
User access and privileges are given to directories, so the way agents are organized in the repository is important. You can organize the agents in any way you like, but we recommend you have a directory Dev where agent developers check-in agents that are under development. Only agent developers will have access to this directory. Once agents are ready for quality assurance, they’re moved into the QA directory, and once ready for production they are moved into the Prod directory. Configure the directories so that only agents in the Prod directory will generate failure tickets and send out email notifications. You may give data consumer users limited access to the Prod directory, so they can view the status of agents.
You may want to add more top level directories. For example, if you’re extracting data for multiple customers, you may want a top level directory for each customer, and then have the 3 directories Dev, QA and Prod under each customer directory.
Open the agent repository and click Add Directory to create a new directory.
Create the directories Dev and QA with default options. Create the directory Prod and set the options to generate tickets when jobs or agent runs fail.
A Job consists of one or more job schedules and each job schedule runs the agent once every time the schedule is triggered, so a single job run may consist of many agent runs. You use multiple job schedules when you want to limit load on a target website and spread out data extraction from the website over multiple days. A job run does not complete before all job schedules have run once, and the job only succeeds if all individual job schedules succeed.
2. Develop two agents using the Sequentum Desktop Edition or just use your existing agents if you have any.
Open the Sequentum Desktop Editor, and for each agent, open the agent in the editor and select Check-In Agent from the File menu.
Click the Browse button and select the Dev directory.
You must enter a version number and we recommend you start with version 1.0.0. If the agent is already in the Agent Repository, you’ll be able to see the latest version number. Version 1.0.0 is used by default if the agent is not in the Agent Repository.
After checking in the agents, open the ACC Web Portal and verify the two agents are now available in the Dev directory.
3. We’ll now deploy the two agents to our cluster. For each agent in the Agent Repository, click the context menu and select Deploy to Cluster.
Select the available cluster and deploy the agent.
The two agents are now deployed to both servers in the cluster and we’re ready to run the agents.
The ACC will automatically run an agent on the most appropriate server in the cluster. If all servers in the cluster are online, the most appropriate server will be the server with the least load.
We’ll run both agents at the same time, so we should see the ACC try and spread the load by running one agent on each server.
Servers in a cluster are sending resource usage data to the ACC every minute, so we'll run the second agent at least one minute after the first one, so the ACC has a chance to work out which server is best suited for the second agent run.
4. For each agent, select Run Agent on Cluster from the agent’s context menu.
Change the log level to High and click the Run button.
5. For each agent, click on the Running link to navigate to the Run History page. On the Run History page, verify the agent execution by looking at the server IP addresses, Data count, Action counts,Page loads, Execution Status.
You can click Refresh on the Run History page to see updated progress of each agent, but the ACC will only poll agent status data every one minute, so a refresh will only show updated data if it has been at least a minute since the last refresh. If you want to update status for a particular agent run directly from the Sequentum server, select Server Refresh from the context menu.
Once the agent runs are completed, open the context menu for each run, and click on Get Log. The log file will automatically get downloaded in the background for you and it will open in the logs file in a new browser tab allowing you to examine the logs without having the need to go to the server and check the logs.
If the agents or servers are configured to keep data backups, the context menu will also contain a Get Data menu which will allow you to download the extracted data in a zip file and in case you are your requirement is to generate small JSON output file then by using the Get Data option you will be able to open and explore the data file in the new browser tab only.
6. We’ll now move one of the agents into production by moving it into the Prod directory. The Prod directory is configured to generate tickets, so a ticket will be generated if the agent fails.
7. We’ll try and force an agent run failure by setting the Success Criteria for the agent to an impossible value.
Edit the agent in the Sequentum Desktop Editor and set the success criteria Min. data count to 1000 (make sure your agent never completes with 1000 data count). Then check-in the agent to the ACC Agent Repository.
Run the agent again and wait for it to fail.
The failure ticket links are now available under the Tickets column and you can directly click on the O:(Open Tickets) or the s: (Tickets waiting for supporter) link and you will be redirected to the Tickets page and the filter option will be selected by default to display all the open tickets or all the tickets waiting for the supporter. You can also open the Ticketing page and click the Filter link and then select the Prod directory and click Search, and you should now see the generated ticket.
8. We’ll now set up a job schedule to run one of the agents automatically.
Open the agent repository page and select Job Schedules from the agent’s context menu.
Click Add Job Schedule and accept the default values.
The agent is now scheduled to run once every day.