Before You Begin

Read these instructions completely before starting your installation or update.

Note: Skybot Scheduler has been renamed to Automate Schedule and is now part of the Automate suite of products. The existing Skybot Scheduler features and functionality are the same; only the product name has changed.

Prerequisite Software

To install an Automate Schedule IBM i agent, your IBM i server must be at V6R1 or higher.

You must also have the following software installed:

  • PASE (Portable Application Solution Environment)
  • Java 7 32-bit or Java 8 32-bit

Downloading the Installer

Whether you're doing a fresh install of an Automate Schedule agent on the IBM i system or updating an existing agent, you must first download the installer on a Windows system that can access the IBM i system on your network. Follow these steps:

  1. Log on to Automate Schedule on a Windows system.

  2. From the menu, click Server > Downloads to go to the Automate Schedule Downloads page.

  3. Click Agent for IBMi (Windows .exe installer) to download the installer.

Uploading the Install Files to the IBM i

For both installs and updates, after you download the installer on a Windows system, you must upload the install files to the IBMi system.

Running the Upload Wizard

To follow these steps, the IBMi system must have the FTP server enabled. If the IBMi doesn't have FTP enabled, follow the steps at the end of this topic for completing a manual installation.

  1. Double-click the IBM i agent installer executable for Windows (setupAutomateScheduleIBMiAgent.exe) that you downloaded in the previous section. Select Run, if necessary. This starts the Automate Schedule IBM i Agent Upload Wizard.

  2. Enter the IBM i Name or Connection Address for the IBM i system where you want to install the Automate Schedule agent.

  3. Enter the FTP Port number for the IBM i system and click Next.

  4. Enter the User Profile and Password for the IBM i system and click Next. Note: The user profile must be a member of the user class *SECOFR and have at least the following special authorities: *ALLOBJ, *SECADM, *JOBCTL, and *IOSYSCFG. The user profile should have Limit capabilities set to *NO.

  5. Review the information. If the information is correct, click Start to begin the upload. If the information is incorrect, click Back to change it.

  6. You can see the status of the upload on the next panel.

    When the upload is finished, make note of the commands that are shown in the panel. They're needed to complete the installation (or update) on the IBM i system.

  7. Click Finish to close the Wizard. If you need to upload the Automate Schedule agent install files to other IBM i systems, click Restart Wizard.

 

Installing an Automate Schedule Agent on the IBM i

Before installing, you need to know your Automate Schedule server name (Hostname) or IP address. You can find that information by logging on to Automate Schedule. Go to Server > Server Properties.

Standard IBM i Installation

Follow these steps for single agent installations into *SYSBAS and the default product library:

  1. Sign on to the IBM i under a user profile that is a member of the user class *SECOFR and has at least the following special authorities: *ALLOBJ, *SECADM, *JOBCTL, and *IOSYSCFG. The user profile should have Limit capabilities set to *NO.

  2. Pre-checker:
    Enter this command to run the installation pre-checker to verify the install environment:

    SKYINSTALL/SKYINST PRECHKONLY(*YES) SKYSRV(your.server.name) SKYSRVPORT(7472) AGENTPORT(portnumber) IFSPATH('/skybot') ASPGRP(*SYSBAS) PRODLIB(SKYAGENT) SBSD(*PRODLIB)

    where:
    • your.server.name is the Hostname or IP address for your Automate Schedule server.
    • portnumber is the port number you assign to the Automate Schedule agent.
  3. If your environment did not pass all the pre-check validations, resolve any issues before proceeding.

  4. Install:
    Enter this command to install the Automate Schedule agent on the IBM i:

    SKYINSTALL/SKYINST PRECHKONLY(*NO) SKYSRV(your.server.name) SKYSRVPORT(7472) AGENTPORT(portnumber) IFSPATH('/skybot') ASPGRP(*SYSBAS) PRODLIB(SKYAGENT) SBSD(*PRODLIB)

    where:
    • your.server.name is the Hostname or IP address for your Automate Schedule server.
    • portnumber is the port number you assign to the Automate Schedule agent.

For information on what to do after you have the agent installed, see "Getting Started with Automate Schedule."

Non-Standard IBM i Installation

The steps in this section are for other types of installations, such as:

  • Installing into a product library other than the default, SKYAGENT.
  • Installing multiple agents on a single IBM i partition (server).
  • Installing into an IASP (ASP group).

If you're installing multiple agents on a single IBM i, each agent should be installed with a unique agent port, IFS path, and product library.

If you're installing into an IASP (ASP group):

  • You must specify a unique product library that is created on the IASP and a corresponding unique system library that is created in *SYSBAS for subsystem definition objects (job queue, job description, class, and subsystem description).
  • You must install the IFS object into a path that includes the ASP device for the IASP.
  • Installing into an ASP Group creates an additional user profile configured for accessing the ASP group from the Automate Schedule Java Processes (JDBC connections). The user profile name will match the system library name that you specified.
  • If you're installing into a secondary IASP in an ASP group, you must specify the specific ASP device and database.

Follow these steps for non-standard agent installations:

  1. Sign on to the IBM i under a user profile that is a member of the user class *SECOFR and has at least the following special authorities: *ALLOBJ, *SECADM, *JOBCTL, and *IOSYSCFG. The user profile should have Limit capabilities set to *NO.

  2. Pre-checker:
    Depending on the type of installation you're doing, enter one of the following commands to run the installation pre-checker to verify the install environment.

    If installing into a product library other than SKYAGENT:
    SKYINSTALL/SKYINST PRECHKONLY(*YES) SKYSRV(your.server.name) SKYSRVPORT(7472) AGENTPORT(portnumber) IFSPATH('/skybot') ASPGRP(*SYSBAS) PRODLIB(productlibraryname) SBSD(*PRODLIB)

    If installing multiple agents (each agent must have a unique agent port, IFS path, and product library):
    SKYINSTALL/SKYINST PRECHKONLY(*YES) SKYSRV(your.server.name) SKYSRVPORT(7472) AGENTPORT(portnumber) IFSPATH('/yourpath') ASPGRP(*SYSBAS) PRODLIB(productlibraryname) SBSD(*PRODLIB)

    If installing into an IASP (ASP group):
    SKYINSTALL/SKYINST PRECHKONLY(*YES) SKYSRV(your.server.name) SKYSRVPORT(7472) AGENTPORT(portnumber) IFSPATH('/ASPdevicename/yourpath') ASPGRP(ASPdevicename) PRODLIB(productlibraryname) SBSD(*PRODLIB) SYSLIB(systemlibraryname) ASPDEV(*ASPGRP) DATABASE(*ASPDEV)

    where:
    • your.server.name is the Hostname or IP address of your Automate Schedule server.
    • portnumber is the port number you assign to the Automate Schedule agent.
    • yourpath is the path to the IFS object.
    • productlibraryname is the name you assign to the product library.
    • ASPdevicename is the name of the ASP device of the IASP that the agent is being installed into.
    • systemlibraryname is the name you assign to the system library for this ASP group.
  3. If your environment did not pass all the pre-check validations, resolve any issues before proceeding.

  4. Install:
    Depending on the type of installation you're doing, enter one of the following commands to install the Automate Schedule agent on the IBM i:

    To install into a product library other than SKYAGENT:
    SKYINSTALL/SKYINST PRECHKONLY(*NO) SKYSRV(your.server.name) SKYSRVPORT(7472) AGENTPORT(portnumber) IFSPATH('/skybot') ASPGRP(*SYSBAS) PRODLIB(productlibraryname) SBSD(*PRODLIB)

    To install multiple agents (each agent must have a unique agent port, IFS path, and product library):
    SKYINSTALL/SKYINST PRECHKONLY(*NO) SKYSRV(your.server.name) SKYSRVPORT(7472) AGENTPORT(portnumber) IFSPATH('/yourpath') ASPGRP(*SYSBAS) PRODLIB(productlibraryname) SBSD(*PRODLIB)

    To install into an IASP (ASP group):
    SKYINSTALL/SKYINST PRECHKONLY(*NO) SKYSRV(your.server.name) SKYSRVPORT(7472) AGENTPORT(portnumber) IFSPATH('/ASPdevicename/yourpath') ASPGRP(ASPdevicename) PRODLIB(productlibraryname) SBSD(*PRODLIB) SYSLIB(systemlibraryname) ASPDEV(*ASPGRP) DATABASE(*ASPDEV)

    where:
    • your.server.name is the Hostname or IP address of your Automate Schedule server.
    • portnumber is the port number you assign to the Automate Schedule agent.
    • yourpath is the path to the IFS object.
    • productlibraryname is the name you assign to the product library.
    • ASPdevicename is the name of the ASP device of the IASP that the agent is being installed into.
    • systemlibraryname is the name you assign to the system library for this ASP group.

For information on what to do after you have the agent installed, see "Getting Started with Automate Schedule." 

Updating an Automate Schedule IBM i Agent

Updating a Standard Installation

Follow these steps for updating a single agent that was installed into *SYSBAS and the default product library:

  1. Sign on to the IBM i under a user profile that is a member of the user class *SECOFR and has at least the following special authorities: *ALLOBJ, *SECADM, *JOBCTL, and *IOSYSCFG. The user profile should have Limit capabilities set to *NO..

  2. Enter the following command to stop the Automate Schedule agent:

    SKYSTOP

  3. Pre-checker:
    Enter this command to run the update pre-checker to verify the update environment:

    SKYINSTALL/SKYUPDATE PRECHKONLY(*YES) ASPGRP(*SYSBAS) PRODLIB(SKYAGENT)

  4. If your environment did not pass all the pre-check validations, resolve any issues before proceeding.

  5. Update:
    Enter this command to perform the update:

    SKYINSTALL/SKYUPDATE PRECHKONLY(*NO) ASPGRP(*SYSBAS) PRODLIB(SKYAGENT)

Updating a Non-Standard Installation

Follow these steps if the Automate Schedule agent was installed into an alternate product library name or into an IASP (ASP group):

  1. Sign on to the IBM i under a user profile that is a member of the user class *SECOFR and has at least the following special authorities: *ALLOBJ, *SECADM, *JOBCTL, and *IOSYSCFG. The user profile should have Limit capabilities set to *NO.

  2. Enter the following command to stop the Automate Schedule agent:

    SKYSTOP

  3. Pre-checker:
    Enter this command to run the update pre-checker to verify the update environment:

    SKYINSTALL/SKYUPDATE PRECHKONLY(*YES) ASPGRP(ASPdevicename) PRODLIB(productlibraryname)

    where:
    • ASPdevicename is the name of the ASP device of the IASP that the agent was installed into.
    • productlibraryname is the name you assigned to the product library.
  4. If your environment did not pass all the pre-check validations, resolve any issues before proceeding.

  5. Install:
    Enter this command to perform the update:

    SKYINSTALL/SKYUPDATE PRECHKONLY(*NO) ASPGRP(ASPdevicename) PRODLIB(productlibraryname)

    where:
    • ASPdevicename is the name of the ASP device of the IASP that the agent was installed into.
    • productlibraryname is the name you assigned to the product library.

Cleaning Up after an Install or Update

Installs and Updates

Follow these steps on the IBM i to clean up the files after an install or an update:

  1. Enter this command to delete the SKYINSTALL library:

    DLTLIB LIB(SKYINSTALL)

  2. Enter this command to open Qshell:

    QSH

  3. Enter this command to delete the Automate Schedule IFS directory:

    rm -R '/skyinstall'

  4. Press F3 to exit Qshell.

Updates Only

Follow these steps on the IBM i to clean up files after you do an update:

  1. Enter this command to delete the backup library (where ):

    DLTLIB LIB(SKYyymmdd)

    where yymmdd represents the date the update ran.
  2. Enter this command to open Qshell:

    QSH
  3. Enter this command to delete the agent.backup recovery directory in the installed path (usually '/skybot/'):

    rm -R '/skybot/agent.backup'

Running an Automate Schedule IBM i Agent

The Automate Schedule agent process runs as jobs in the Automate Schedule subsystem (SKYAGENT by default). You can start and stop the agent process with the SKYSTART and SKYSTOP commands in the product library (SKYAGENT by default).

Run the command, WRKACTJOB SBS(SKYAGENT), to view the Automate Schedule subsystem. The image below shows an example of an Automate Schedule subsystem when the Automate Schedule IBM i agent is running normally.

 

Setting the Automate Schedule Agent to Start on IPL

The Automate Schedule agent starts each time the SKYAGENT subsystem starts. Add the following command to your initial program load (IPL) procedures to start the SKYAGENT subsystem each time you IPL:

SKYAGENT/SKYSTART

The Automate Schedule agent should be shut down whenever you power down your system. To make sure this occurs, insert the following command in your power-down or save program procedures:

SKYAGENT/SKYSTOP

Automate Schedule Authorization

When installed by default, the Automate Schedule agent creates two user profiles:

  • SKYBOTUSR
    • Limited authority *PGMR user class profile.
    • Owns most of the Automate Schedule objects.
    • Runs the agent processes.
    • Most programs adopt the SKYBOTUSR authority to access Automate Schedule data.
  • SKYBOTADM
    • *SECOFR user class with high authority.
    • Owns the SKY163 program that submits the user jobs.
    • The SKY163 program adopts the authority of SKYBOTADM to allow it to submit jobs using any configuration in the product.

Note: Installing into an ASP group creates an additional user profile that is configured specifically to reference the ASP group. The Automate Schedule agent process runs as that user profile. That user profile references the SKYBOTUSR user profile as a group profile to have authority to access the Automate Schedule objects.

If you're concerned about how much authority SKYBOTADM has on your system, you can reduce the authority of that profile and selectively grant authority to the system objects required to submit user jobs. To reduce the authority, use this command:

CHGUSRPRF USRPRF(SKYBOTADM) USRCLS(*USER) SPCAUT(*USRCLS)

If you reduce the authority of SKYBOTADM, you should make SKYBOTADM reference SKYBOTUSR as a group profile so it has access to all Automate Schedule objects. Use this command to do so:

CHGUSRPRF USRPRF(SKYBOTADM) GRPPRF(SKYBOTUSR)

After reducing the SKYBOTADM authority, you will need to provide SKYBOTADM with appropriate authority to any/all objects specified by the IBM i agent environments you define in Automate Schedule for running user jobs. Automate Schedule will not be able to submit jobs that reference any objects on the SBMJOB command that SKYBOTADM is not authorized to use.

Manual Installation Instructions

Follow these steps if your IBM i system does not have the FTP server enabled:

  1. Download the IBM i agent installer executable for Windows (setupAutomateScheduleIBMiAgent.exe) as described above.

  2. Open the executable file with a .zip archive utility such as 7-Zip. Save these two files out of the archive. Note: SKYINST.HS is an archive file in the archive.

    \Automate Schedule IBM i Agent Wizard\SKYINST.HS\SKYAGENT

    \Automate Schedule IBM i Agent Wizard\SKYINST.HS\setupSkybotSchedulerIBMiAgent.jar

  3. Sign on to the IBM i under a user profile that is a member of the user class *SECOFR and has at least the following special authorities: *ALLOBJ, *SECADM, *JOBCTL, and *IOSYSCFG. The user profile should have Limit capabilities set to *NO.

  4. Enter the following command to create the Automate Schedule library in the IBM i:

    CRTLIB SKYINSTALL

  5. Enter the following command to create a save file in the Automate Schedule library:

    CRTSAVF SKYINSTALL/SKYAGENT

  6. Upload the SKYAGENT file you extracted in step 2 to the SKYINSTALL/SKYAGENT save file.

  7. Enter the following command to open Qshell:

    QSH

  8. Enter the following command to create an IFS install directory named '/skyinstall':

    mkdir '/skyinstall'

  9. Copy the setupSkybotSchedulerIBMiAgent.jar file you extracted in step 2 to the '/skyinstall' IFS directory.

  10. Enter the following command to restore the SKYINSTALL/SKYAGENT save file:

    RSTOBJ OBJ(SKYUPD* SKYINST*) SAVLIB(SKYAGENT) DEV(*SAVF) SAVF(SKYINSTALL/SKYAGENT) MBROPT(*ALL) ALWOBJDIF(*ALL) RSTLIB(SKYINSTALL)

  11. Enter the following commands to set the current library for the SKYINST and SKYUPDATE commands, so that the library list will be set automatically:

    CHGCMD CMD(SKYINSTALL/SKYINST) CURLIB(SKYINSTALL)

    CHGCMD CMD(SKYINSTALL/SKYUPDATE) CURLIB(SKYINSTALL)

  12. Follow the instructions for installing or updating the Automate Schedule agent (above).

 


Still have questions? We can help. Submit a case to Technical Support.

Last Modified On: March 11, 2019