The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
The installation procedure differs depending upon whether the database being used is Microsoft SQL Server or Oracle.
To install the master component using a Microsoft SQL database:
The File Download-Security Warning dialog displays.
Step 2 Click Run. The Internet Explorer-Security Warning dialog displays.
The Installation Type panel displays.
Step 5 Select the Master option, then click Next.
TES Super User panel displays.
Step 6 Enter the domain name for your master into the Domain field.
Step 7 Enter the name of the Super user for this master.
Step 8 If you have a demo code, enter the code into the If you have a demo code enter it here: field.
The Destination Folder panel displays.
Step 9 Select the directory where the Scheduler files will reside.
The Database Type dialog displays.
Step 11 Select the MSSQL Server option, then click Next.
The Database Server dialog displays.
Step 12 Identify the Microsoft SQL database and logon you are using:
Note The master should not be installed on hosts with underscores in their names or the JMS connections will fail between components.
Note The Oracle SID and Service Name should be the same on the database. However, if they are different, then provide the Oracle Service Name as the SID in this field.
– Login ID – Enter the login credentials for the database administrator.
– Password – Enter the password for the database administrator.
The Admiral Database and Transaction Log File Path panel displays.
Step 14 Click Next to accept the default paths.
The Database Size panel displays.
Step 15 Enter database and log file sizes:
The Ready to Install the Program panel displays.
Step 17 Click Install to start the installation process.
The Installing Tidal TES - Master panel displays.
The progress of your master installation is displayed in the form of a progress bar.
Warning Do not click Cancel once the installation process begins copying files in the Setup Status screen. Canceling the installation at this point corrupts the installation program.
You will not be able to install the component without the help of Support. If you decide you do not want to install the component, you must complete the installation and then uninstall.
The Setup Completed dialog displays.
The procedure for installing a master running an Oracle database is very similar to the procedure used when running a Microsoft SQL database. The differences are described in the following procedure.
To install the master component using an Oracle database:
The File Download-Security Warning dialog displays.
Step 2 Click Run. The Internet Explorer-Security Warning dialog displays.
The Installation Type panel displays.
Step 5 Select the Master option, then click Next.
The TES Super User panel displays.
Step 6 Enter the domain name for your master into the Domain field.
Step 7 Enter the name of the Super user for this master.
Step 8 If you have a demo code, enter the code into the If you have a demo code enter it here: field.
The Destination Folder panel displays.
Step 9 Select the directory where the Scheduler files will reside.
The Database Type panel displays.
Step 11 Select the ORACLE Server option, then click Next.
The Database Server panel displays.
Step 12 Identify the Oracle database and logon you are using:
Note This information is available from the Oracle Database Administrator.
Step 14 Specify the name and location of the Data, Index and Temp tablespaces so Scheduler can access the files. By default, Scheduler calls the datafiles, ADMIRAL_DATA, ADMIRAL_INDEX and ADMIRAL_TEMP. You can retain the default name or replace the default values with different names but you must type the directory path to each datafile location.
The Ready to Install the Program panel displays.
Step 16 Click Install to start the installation process.
The Installing Tidal TES - Master panel displays.
The progress of your master installation is displayed in the form of a progress bar.
Warning Do not click Cancel once the installation process begins copying files in the Setup Status screen. Canceling the installation at this point corrupts the installation program.
You will not be able to install the component without the help of Support. If you decide you do not want to install the component, you must complete the installation and then uninstall.
The Setup Completed dialog displays.
Use the Service Control Manager to verify that the master is running.
Step 1 From the Start menu on the master machine, select Programs >TIDAL Software > Scheduler > Master > Service Control Manager.
The Tidal Service Manager dialog displays.
Step 2 From the Service list, select Scheduler Master.
The master status displays at the bottom of the dialog.
Step 3 Click Start to start the master if it is not running.
Step 1 Copy install.bin to the target machine.
Step 2 Change the permissions on the copied install.bin file to make the file executable by entering:
Step 3 After copying the file to the directory, begin the installation program by entering:
When the installation program starts, the installation splash screen displays.
The Introduction panel follows.
Step 4 After reading the introductory text that explains how to cancel the installation or modify an previous entry on a previous screen, click Next.
The Choose Installation Folder panel displays.
Step 5 Enter the directory path to the location where you wish to install the master files or click Choose to browse through the directory tree to the desired directory.
The Select Appropriate Master panel displays.
Note The master machines, both primary and backup, must have mirror configurations, meaning that both machines must use the same version of operating system and JVM for fault tolerance to operate correctly.
Step 7 Select whether you are installing a primary or backup master.
The only instance you would select the Backup option is if you are installing fault tolerance, which requires a special license. If you are installing fault tolerance, install the primary master before you install the backup master.
The Select Admiral Database Creation Option panel displays.
Step 9 Select Automatic or Manual.
TES requires its own database to store job information. The installation program will create the database automatically unless you select the Manual option. The automatic database creation process creates a schema called ‘tidal’ and three tablespaces:
If the schema name or any of the names of the tablespaces is used already, the installation will fail.
The Enter DBA UserName and Password dialog displays.
TES must be able to access the Oracle database. You must provide the user name and password required to access the database. Your DBA can provide this information. The DBA user name is usually the ‘system’ user. The specified database user will create the ‘tidal’ schema and its three tablespaces.
The JDBC Driver Information panel displays.
Step 12 Supply the following information so the Unix master can connect to the database:
Note The master should not be installed on hosts with underscores in their names or the JMS connections will fail between components.
Note The SID is case-sensitive.
Test JDBC Connection panel displays.
Step 14 Click Test JDBC Connection to verify that the information configuring the database connection is correct.
The installation program must be able to connect to the database before the installation can continue.
Note If the connection to the database cannot be established, an error message displays explaining what needs to be fixed. If the database cannot be accessed you must resolve the issue before proceeding with the installation SID is case-sensitive.
When the program accesses the database, a “Connection Successful” message displays.
The Admiral Tablespace Installation panel displays.
Step 16 Specify the location for the Oracle tablespace directories to be created.
To use Oracle’s default tablespace directory location, click Next.
To use any location other than the default location, enter the directory paths to the ADMIRAL_DATA, ADMIRAL_INDEX and ADMIRAL_TEMP tablespaces. Do not change the actual datafile names. Change only the directory paths.
If your database is on a Windows platform, be sure to use Windows pathname syntax (for example, C:\Program Files\Microsoft SQL Server\MSSQL\Data).
If your database is on the Unix platform, use the proper Unix directory syntax (for example, /opt/oracle/oradata/Admiral/ADMIRAL_DATA).
The Master Host Name panel displays.
Step 18 Enter the hostname (or machine name) of the machine that you are installing the Unix master on. Do not use the domain name.
The SNMP Information panel displays.
Step 20 Enter the name of the SNMP server machine.
If you want to use SNMP to send traps in TES, you must tell the Unix master how to connect to the SNMP server.
Step 21 Enter the port number of the SNMP server machine.
The default port number is 162.
This information can be changed later if necessary.
Step 22 Click Next to continue the installation or to skip this step if you are not using SNMP traps.
The TES SuperUser dialog displays.
Step 23 Enter the domain name of the initial TES configuration Super User.
Step 24 Enter the name of the initial TES configuration Super User.
Step 25 If you have a Demo license, enter the license number, then click Next.
The Pre-Installation Summary panel displays.
This screen summarizes the information entered during the installation procedure.
Step 26 Review the information to ensure it is correct.
Step 27 If any information is incorrect, retrace your steps and correct the information by clicking Previous until you reach the desired screen.
If the information is correct, click Install to start the installation of the Unix master files.
After the installation process completes, a screen provides a database status report. This report lists the various steps during the creation of the database and if the step was successful.
Step 28 Review the database report for any error notices.
Step 29 If the database was created without any errors, click Next.
If the report displays any errors during database creation, note the errors. You can correct the errors later by manually creating the database. Click Next.
Once installation is complete, the Installation Complete screen displays.
Step 30 Click Done to exit the installer.
You should verify that the installation program installed all of the required files.
Verify that all of master files were installed by going to the directory location that you designated during installation and listing the directory contents with the following command:
The seven main file directories (not counting the UninstallerData directory) are listed at the top with the contents of the bin, lib and config directories also displayed.
In the basic TES network, the master uses a centralized database, containing all calendar and job scheduling information. One or more agent machines execute the production schedule. One or more client machines provides the TES user interface or console. The only prerequisite for the master/agent relationship is that the machine acting as the master must be on the same TCP/IP network as the machines serving as agents.
Scheduler provides agents for Windows environments and agents for Unix environments. This section discusses both installations.
Step 1 Load the installation DVD into your machine’s DVD-ROM drive.
Note If you are not running the install from the installation DVD, skip to Step 4.
The Scheduler Installation screen displays.
Step 2 Click the Tidal Agent for Windows link.
Step 3 When the dialog display asking to save the file, click Save File.
Step 4 Double-click the Agent_windows_TIDAL Agent.msi file.
The Security Warning dialog displays.
Note If any other agents are running on the machine, a dialog notifies you that the agent(s) must be stopped before the installation can continue.
The Choose Destination Location panel displays.
Step 7 Select the directory where the Scheduler files will reside:
The Agent Port Number panel displays.
Step 9 Enter the port number that the agent will listen on.
The Ready to Install the Program panel displays.
Note Do not click Cancel once the installation process begins copying files in the Setup Status screen. Canceling the installation at this point corrupts the installation program.
You will not be able to install the component without the help of Support. If you decide you do not want to install the component, you must complete the installation and then uninstall.
The Setup Completed panel displays.
Before installing the Tidal Agent for Unix, backup your files and gather the following information:
To install the agent from the command line:
Step 1 Insert the installation DVD-ROM into the machine you want to install the agent on.
Step 3 Copy the install.sh and install.tar files from the directory on the DVD-ROM (<DVD-ROM>/agent/unix/command s/b /agent/unix/cmdline) to your temp directory.
Note Do not unpack the install.tar file. The file will automatically unpack during the installation process
Step 4 Change the permissions on the install.sh file in the directory to make the file executable:
chmod 755 install.sh install.tar
Step 5 Begin the installation by entering:
An introduction screen displays as the installation program begins.
Step 6 Type Y to continue the installation and press Enter.
The Select the Owner panel displays.
The top of the screen shows the users defined on the machine you are installing on. In some cases, you may want to select a user who is not defined on the local machine but is defined as a NIS user allowing the user to install over the network.
Step 7 Enter the name of the user to own the agent.
Note Carefully consider which user to run the agent as. It may be desirable to create a user specifically for this purpose.
The Select the Location panel displays.
Step 9 Type Y, then press Enter.
The Agent Configuration Menu panel displays.
Step 10 Type 1 to select the Add Instance option, then press Enter.
The Select the Location for the Agent Files panel displays.
Step 11 Enter the information you gathered before beginning installation:
A confirmation summary screen displays the information that you entered.
Step 13 If the information is correct, press Enter.
If the information is not correct, type n. You are prompted again for the name, port number and directory path for the agent.
Step 1 Click Start > All Programs > TIDAL Software > TIDAL Service Manager.
The Tidal Service Manager dialog displays.
Step 2 Select AGENT_1 from the Services list.
If the Tidal Service Manager displays the message AGENT_1: Running at the bottom, then the agent is running and the installation was successful.
Note If you want to edit the service parameters, click the ellipsis button to access the Service Configuration dialog.
Step 1 Transfer the appropriate installation files to the target machine (binary mode).
Step 2 Double-click setup.exe.
The Security Warning dialog displays.
The Internet Explorer-Security Warning dialog displays.
The InstallShield Wizard Welcome dialog displays.
The Destination Folder panel displays.
Step 6 Select the directory where the TES files will reside.
TES DSP Name and Master IP panel displays.
Step 8 In the TES DSP NAME field, enter the name of your Data Source (TES 6.2) Plug-in.
This value can be anything you want it to be. The default is tes-6.2.
Note Architecturally, the Client Manager is written to be a generic container of plug-ins and is not TES-specific. The TES-specific parts of the UI are in TES plug-in.
Step 9 In the Primary Server IP field, enter the host name or IP address for your primary master. The default port is 6215.
Step 10 If using Fault Tolerance, in the Backup Server IP field, enter the IP address for your backup master.
Step 11 Click Next. The Cache Database Server panel displays.
By default, Internal Cache DB server is selected. Alternatively, external DB servers may be provisioned to run Cache Database.
The Database Server Credentials panel displays if you selected an external database server.
Step 13 Enter the credentials for the selected external database, then click Next.
The Active Directory/LDAP Authentication panel displays.
Step 14 Select an option, then click Next.
If configuring the Client Manager to use the Active Directory option, the Active Directory Authentication panel displays.
If configuring the Client Manager to use the LDAP option, the LDAP Authentication panel displays.
Step 15 For Active Directory, enter the following information:
For LDAP, enter the following information:
The Ready to Install the Program panel displays.
The Installing Tidal Client Manager panel displays.
Step 18 If any information is incorrect, retrace your steps and correct the information by clicking Back until you reach the desired screen.
If the information is correct, click Install to start the installation of the Client Manager files.
The Installing Tidal Client Manager panel displays.
The status of your client installation is displayed with a progress bar.
The Setup Completed panel displays.
Note The first time the Client Manager is started, it initializes its data from the master. Depending upon the amount of data, this could take up to 20 minutes.
You should verify that the installation program installed all of the required files.
Verify that Client Manager files were installed by going to the directory location that you designated during installation.
The seven main file directories (not counting the UninstallerData directory) are listed at the top with the contents of the bin, lib and config directories also displayed.
To install Client Manager for Unix:
Step 1 Copy install.bin to the target machine.
Step 2 Change the permissions on the copied install.bin file to make the file executable by entering:
Step 3 After copying the file to the directory, begin the installation program by entering:
When the installation program starts, the installation splash screen displays.
The Introduction panel follows.
Step 4 After reading the introductory text that explains how to cancel the installation or modify an previous entry on a previous screen, click Next.
The Choose Installation Folder panel displays.
Step 5 Enter the directory path to the location where you wish to install the master files or click Choose to browse through the directory tree to the desired directory.
The Get TES DSP Name and master IP panel displays.
Step 7 In TES DSP NAME field, enter the name of your Data Source (TES 6.2) Plug-in.
This value can be anything you want it to be. The default is tes-6.2.
Note Architecturally, the Client Manager is written to be a generic container of plug-ins and is not TES-specific. The TES-specific parts of the UI are in TES plug-in.
Step 8 In the Primary Server IP field, enter the host name or IP address for your primary master. The default port is 6215.
Step 9 If using Fault Tolerance, in the Backup Server IP field, enter the IP address for your backup master.
The Get Cache Database Location panel displays.
By default, the legacy internal embedded server is selected. For Enhanced performance, select Oracle as the Cache CB server.
If the Oracle server is selected, the Get External Oracle Database Server Info Panel displays.
Step 12 Enter the required authentication information, then click Next.
The Active Directory/LDAP Authentication panel displays.
Step 13 Select an option, then click Next.
If configuring the Client Manager to use the Active Directory option, the Active Directory Authentication panel displays.
If configuring the Client Manager to use the LDAP option, the LDAP Authentication panel displays.
Step 14 For Active Directory, enter the following information:
For LDAP, enter the following information:
The Pre-Installation Summary panel displays.
This screen summarizes the information entered during the installation procedure.
Step 16 Review the information to ensure it is correct.
Step 17 If any information is incorrect, retrace your steps and correct the information by clicking Previous until you reach the desired screen.
If the information is correct, click Install to start the installation of the Client Manager files.
The Installing Tidal Client Manager panel displays.
The status of your installation is displayed with a progress bar.
The Install Complete panel displays.
Step 18 Click Done to exit the installer.
Note The first time the Client Manager is started, it initializes its data from the master. Depending upon the amount of data, this could take up to 20 minutes.
To install Client Master from a command line:
Step 1 Copy install.bin to the target machine.
Step 2 Change the permissions on the copied install.bin file to make the file executable by entering:
Step 3 After copying the file to the directory, begin the installation program by entering:
The following screen displays as the installation program begins.
When the installation program starts, the Introduction panel displays.
Step 4 After reading the introductory text that explains how to cancel the installation or modify an previous entry on a previous screen, press Enter.
The Choose Installation Folder panel displays.
Step 5 Enter the directory path to the location where you wish to install the Client Manager files, then press Enter.
Step 6 Verify the path you entered, then press Enter.
The Get TES DSP Name and master IP panel displays.
Note The master machines, both primary and backup, must have mirror configurations, meaning that both machines must use the same version of operating system and JVM for fault tolerance to operate correctly.
Step 7 Enter the name of your Data Source (TES 6.2) Plug-in, then press Enter.
Step 8 Enter the host name or IP address for your primary master, then press Enter.
Step 9 Enter the port number for the primary master, then press Enter.
Step 10 Enter the host name or IP address for your backup master, then press Enter.
Step 11 Enter the port number for the backup master, then press Enter.
Step 12 If using Fault Tolerance, enter the IP address for your backup master, then press Enter.
The Get Authentication Method screen displays.
Step 13 Enter 1 for the Active Directory option or 2 for the LDAP option, then press Enter.
Step 14 For Active Directory, enter the following information:
Note Contact your IT Administrator for Active Directory/LDAP authentication values.
For LDAP, enter the following information:
The Pre-Installation Summary screen displays.
The Installing screen displays.
Once installation is complete, the Installation Complete screen displays.
Step 17 Press Enter to exit the installer.
You should verify that the installation program installed all of the required files.
Verify that Client Manager files were installed by going to the directory location that you designated during installation and listing the directory contents with the following command:
The seven main file directories (not counting the UninstallerData directory) are listed at the top with the contents of the bin, lib and config directories also displayed.