Page 1 AUTHORIZED DOCUMENTATION Installation and Configuration Guide Novell ® PlateSpin Orchestrate 2.0.2 October 9, 2009 www.novell.com PlateSpin Orchestrate 2.0 Installation and Configuration Guide...
Page 2 Further, Novell, Inc., reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes.
Page 3 Novell Trademarks For Novell trademarks, see the Novell Trademark and Service Mark list (http://www.novell.com/company/legal/ trademarks/tmlist.html). Third-Party Materials All third-party trademarks are the property of their respective owners.
Page 4 PlateSpin Orchestrate 2.0 Installation and Configuration Guide...
Page 5: Table Of Contents
Contents About This Guide 1 Planning the Orchestrate Server Installation PlateSpin Orchestrate Requirements..........9 1.1.1 Orchestrate Server .
Page 6 3 First Use of Basic PlateSpin Orchestrate Components Walkthrough: Launching the PlateSpin Orchestrate Development Client ....99 Walkthrough: Logging In to the PlateSpin Orchestrate Server ..... . . 101 3.2.1 Logging In by Using the Explorer.
Page 7: About This Guide
This Installation and Configuration Guide explains how to install, monitor, and manage applications ® ® running on PlateSpin Orchestrate 2.0 from Novell . It helps you plan the installation of the basic PlateSpin Orchestrate components, to install them, and helps you understand how to use them in basic usage scenarios.
Page 8 Documentation Conventions In Novell documentation, a greater-than symbol (>) is used to separate actions within a step and items in a cross-reference path. ® A trademark symbol ( , etc.) denotes a Novell trademark.
Page 9: Planning The Orchestrate Server Installation
® ® Before you begin installing PlateSpin Orchestrate 2.0 from Novell , you need to compare your system resources with the requirements of the PlateSpin Orchestrate product. This section includes information to help you with that evaluation so that you can adequately plan for the installation. The following subsections are included: Section 1.1, “PlateSpin Orchestrate Requirements,”...
Page 10: Orchestrate Server
Orchestrate Server software on a dedicated server to ensure optimal performance. For example, you might not want the server to host Novell eDirectory NOTE: Although you can install the PlateSpin Orchestrate Server on a Virtual Machine, do not try to manage that server using PlateSpin Orchestrate.
Page 11: Required Network Resources
1.1.2 Required Network Resources The Orchestrate Server must allow traffic on TCP ports 80, 8001, 8100, 8101 (these four ports are configurable), and UDP and TCP port 1099 (mandatory). The following list summarizes the network resources required in a PlateSpin Orchestrate setup: Port 80 is used for the Server Portal when monitoring is not installed.
Page 12 PlateSpin Orchestrate Network Resources Figure 1-1 VM Builders OS Install Sources Auto-install files TCP 8100 TCP 8100 Orchestrate Service TCP 8101 TCP 8101 Admin Portal-TCP 8001 User Portal-TCP 8080 TCP 8100 (optionally TCP 80) “zos” CLI TCP 8101 Managed Resources JMX 1099 VM Guests &...
Page 13: Orchestrate Agent
1.1.3 Orchestrate Agent PlateSpin Orchestrate manages jobs on and gathers data about data center computing resources running the PlateSpin Orchestrate Agent and meet the following minimum requirements: Orchestrate Agent Requirements Table 1-2 Item Requirement Operating System Linux machines: SUSE Linux Enterprise Server 9 SP3 (32-bit or 64-bit) SUSE Linux Enterprise Server 10 SP1 (32-bit or 64-bit) SUSE Linux Enterprise Server 10 SP2 (32-bit or 64-bit) SUSE Linux Enterprise Server 11 (32-bit or 64-bit)
Page 14: Orchestrate Vm Client
Host Operating System Minimum Requirements Recommended Hardware SLES 10 SP2 x86 or x86_64 x86 or x86_64 2 GB RAM 4+ GB RAM 30 GB Hard Drive Space 100+ GB Hard Drive Space Windows Server 2008 enabled 1GHz (x86 processor) or 2+ GHz with Hyper-V 1.4GHz (x64 processor)
Page 15: Other Orchestrate Clients
1.1.6 Other Orchestrate Clients You can monitor and run jobs, run the command line interfaces, and create and modify jobs by using the tools and monitors included with the PlateSpin Orchestrate Clients. PlateSpin Orchestrate manages jobs on and gathers data about data center computing resources that meet the following minimum requirements: Orchestrate Client Requirements Table 1-5...
Page 16: Component Installation Methods
Available as an RPM package distribution (ISO images, 32-bit or Server or 64-bit) 64-bit) from the Novell Downloads Web site (http:// download.novell.com) after purchase and receipt of a license key. Uses the Add-On CD installation (PlateSpin Orchestrate Server pattern) available in YaST.
Page 17 Available as an RPM package distribution (ISO images, 32- Agent bit or 64-bit) bit or 64-bit) from the Novell Downloads Web site (http:// download.novell.com) after purchase and receipt of a SLES 10 SP1 license key. Uses the Add-On CD installation (PlateSpin (32-bit or 64-bit) Orchestrate Agent pattern) available in YaST.
Page 18 Available as an RPM package distribution (ISO images, 32- Clients (32-bit or 64-bit) bit or 64-bit) available from the Novell Downloads Web site (http://download.novell.com) after purchase and receipt of a SLES 11 (32-bit license key. Uses the Add-On CD installation (PlateSpin or 64-bit) Orchestrate Agent pattern) available in YaST.
Page 19 90 days, although the trial key controls the number of users and managed nodes you can configure. For fully supported functionality, product components require a purchased license key. contact your Novell Sales Representative or a Certified Novell Partner for purchase information.
Page 20 PlateSpin Orchestrate 2.0 Installation and Configuration Guide...
Page 21: Installation And Configuration
® This section explains the installation and setup of various components of PlateSpin Orchestrate ® from Novell Section 2.1, “Installation Prerequisites,” on page 21 Section 2.2, “Installing and Configuring All PlateSpin Orchestrate Components Together,” on page 21 Section 2.3, “Installing the Orchestrate Agent Only,” on page 45 Section 2.4, “Installing the Orchestrate Development Client Only,”...
Page 22: Installation And Configuration Steps
The VM Builder cannot be installed on a VM and must only be installed on the host operating system of the VM Builder node. Multiple servers with VM host capability can be used as VM Builder machines to make the VM Builder group. This section includes the following information: Section 2.2.1, “Installation and Configuration Steps,”...
Page 23 4f Select the PlateSpin Orchestrate installation patterns that you want to install: Orchestrate Server: This pattern is the gateway between enterprise applications and resource servers. The Orchestrate Server manages computing nodes (resources) and the jobs that are submitted from applications to run on these resources. Monitoring Server: Uses open source Ganglia monitoring of the performance of certain data on network resources in a user-defined time period.
Page 24 6a Make sure you are logged in as to run the configuration script. root 6b Run the script, as follows: /opt/novell/zenworks/orch/bin/config When the script runs, the following information is initially displayed: Welcome to PlateSpin Orchestrate. This program will configure PlateSpin Orchestrate 2.0...
Page 25 7a Enter the following command at the bash prompt of the machine where you installed the PlateSpin Orchestrate patterns: /opt/novell/zenworks/orch/bin/guiconfig The GUI Configuration Wizard launches. IMPORTANT: If you have only a keyboard to navigate through the pages of the GUI Configuration Wizard, use the Tab key to shift the focus to a control you want to use (for example, a Next button), then press the spacebar to activate that control.
Page 26 7c Accept the agreement, then click Next to display the PlateSpin Orchestrate components page. This section discusses new installation. For information about upgrading, see the PlateSpin Orchestrate 2.0 Upgrade Guide. 7d Select New Installation, then click Next to display the PlateSpin Orchestrate components page.
Page 27 The components page lists the PlateSpin Orchestrate components that are available for configuration. By default, all installed components are selected for configuration. 7e Click Next to confirm the components you want to install. Deselect any PlateSpin Orchestrate components that you do not want to configure, then click Next.
Page 28 If you do not select this check box and click Next, a second page of the Monitoring Configuration Wizard is displayed. Continue with Step 7e2. 7e2 (Conditional) Specify the host name or IP address you want to associate to this monitored node.
Page 29 Use the following command to run the configuration: /opt/novell/zenworks/orch/bin/config -rs 7h Click Next to display the following wizard page. 7i Click Next to launch the configuration script. When the configuration is finished, the following page is displayed: 7j Click Finish to close the configuration wizard.
Page 30: Platespin Orchestrate Configuration Information
PlateSpin Orchestrate system. 8 Open the configuration log file ( /var/opt/novell/novell_zenworks_orch_install.log to make sure that the components were correctly configured. You might want to change the configuration if you change your mind about some of the parameters you provided in the configuration process.
Page 31 PlateSpin Orchestrate Configuration Information Table 2-1 Configuration Explanation Information Orchestrate If you installed the Orchestrate Monitoring Server and the Orchestrate Monitoring Monitoring Agent, the following questions are asked during the configuration process. You can configure this host to be the Monitored or Monitoring Monitoring Server or a monitored node.
Page 32 Default = none A license key (90-day evaluation license or a full license) is required to use this product. You should have received this key from Novell, then you should have subsequently copied it to the network location that you specify here.
Page 33 Configuration Explanation Information Orchestrate Specify the Server Portal port. Server Portal Server Default = (if Monitoring is installed) or (if Monitoring is not 8080 (continued) installed). Because Apache uses port 80 for Orchestrate Monitoring, it forwards non- monitoring requests to the Orchestrate Server on the port you specify here. Specify the Administrator Administrator Information port Information page port.
Page 34 Configuration Explanation Information Orchestrate You can install and configure the Orchestrate Agent on any computing node. It is not Agent necessary to install it on the same machine with the Orchestrate Server. If you installed the Orchestrate Agent, the following questions are asked in the configuration process.
Page 35: Correcting Configuration Errors And Repeating The Configuration Process
Configuration Explanation Information Configuration When you have completed the configuration process, you have the option of viewing Summary a summary of the configuration information. Do you want to view summary information? View summary: Default = Answering to this question displays a list of all the PlateSpin Orchestrate components you have configured and the information with which they will be configured.
Page 36 SP2, you can use a PostgreSQL database and configure it for use with PlateSpin Orchestrate auditing. If you want to use another database, you have to configure it separately for use with PlateSpin Orchestrate. “Installing the PostgreSQL Package and Dependencies on an Independent Host” on page 36 “Configuring PostgreSQL to Accept Remote Database Connections”...
Page 37 # pg_ctl start pg_ctl: cannot be run as root Please log in (using, e.g., "su") as the (unprivileged) user that will own the server process. Detail postgres> initdb The files belonging to this database system will be owned by user "postgres". This user must also own the server process.
Page 38 host 0.0.0.0/0 trust NOTE: After initial configuration, you can replace the with a more restrictive mask. In 0.0.0.0/0 a high availability server configuration, make sure that each host in the high availability cluster is enabled as a remote host. After you make the change to the file, you need to specify the following command so pg_hba.conf that you do not receive an error when remote hosts try to connect:...
Page 39 Creating a PlateSpin Orchestrate User for the PostgreSQL Database Next, set up a PostgreSQL user to own the audit database schema before you run the server configuration script or the GUI Configuration Wizard. 1 On the database host machine, use the following commands to log in as at the database root host machine:...
Page 40: Installing And Configuring The Orchestrate Server For Use With A Local Postgresql Audit Database
6 Specify the PostgreSQL database administrator password, then press Enter. The following prompt is displayed: Retype password: 7 Retype the database administrator password to verify it, then press Enter. The following prompt is displayed: ZOS Audit Database Name [zos_db]: 8 Specify the name of the database you want to create for PlateSpin Orchestrate auditing, then press Enter.
Page 41 yast2 -i postgresql-server When PostgreSQL is installed, you need to create the default database and start it. Use the following commands: su - postgres initdb pg_ctl start These commands create or update the PostgreSQL privilege database and installs the prepared tables.
Page 42 The easiest way to configure the audit database is to do so when you configure the PlateSpin Orchestrate Server. Use the following procedure to configure the database. NOTE: The questions presented in the text-based config script are shown here, but the questions presented in the graphical Configuration Wizard are similar.
Page 43: Configuring The Audit Database After Platespin Orchestrate Is Configured
If you have already installed and configured PlateSpin Orchestrate, it is still possible to configure an audit database. 1 On the PlateSpin Orchestrate host machine, use your favorite editor to edit the script /opt/ novell/zenworks/zos/server/conf/audit_db_prep.sql 1a Replace the variable with the PostgreSQL database name (for example, ${DB_NAME}...
Page 44: Configuring The Remote Audit Database After Platespin Orchestrate Is Configured
If you have already installed and configured PlateSpin Orchestrate, it is still possible to configure an audit database. 1 On the PlateSpin Orchestrate host machine, use your favorite editor to edit the script /opt/ novell/zenworks/zos/server/conf/audit_db_def.sql 1a Replace the variable with the PostgreSQL database name (for example, ${DB_NAME}...
Page 45: Installing The Orchestrate Agent Only
If your Grid Objects are named with long names, you might have to configure some of the table columns in the audit database with different sizes. Here are some things you need to know about the database and how to make such changes: The default length of some names is pre-defined in the audit database.
Page 46: Installing The Orchestrate Agent Using The Product Iso
Section 2.3.4, “Installing the PlateSpin Orchestrate Agent on Other Supported Operating Systems,” on page 68 Section 2.3.5, “Automatically Installing the Orchestrate Agent on a VM Host Using a Job,” on page 72 NOTE: To automatically install the Orchestrate Agent on a VM that you created in the Client, in the client, right-click a VM that has been shut down, then select Install Agent.
Page 47 4c In the Add-on Product Media dialog box, select the ISO media (Local Directory or DVD) to install: (Conditional) Select DVD, click Next, insert the DVD, then click Continue. (Conditional) Select Local Directory, click Next, select the ISO Image check box, browse to and select the ISO in the file system, then click OK.
Page 48 6b Make sure you are logged in as to run the configuration script. root 6c Run the script, as follows: /opt/novell/zenworks/orch/bin/config When the script runs, the following information is initially displayed: Welcome to PlateSpin Orchestrate. This program will configure PlateSpin Orchestrate 2.0...
Page 49 7c Run the wizard: /opt/novell/zenworks/orch/bin/guiconfig When the script runs, the following information is initially displayed: IMPORTANT: If you have only a keyboard to navigate through the pages of the GUI Configuration Wizard, use the Tab key to shift the focus to a control you want to use (for example, a Next button), then press the spacebar to activate that control.
Page 50 7e Select the option to accept the agreement, then click Next to open the installation type page of the wizard: 7f Select New Installation, then click Next to display the Orchestrate Components page of the wizard: PlateSpin Orchestrate 2.0 Installation and Configuration Guide...
Page 51 PlateSpin Orchestrate Agent and applies the configuration settings. If you deselect the check box, the wizard writes out the configuration file to /etc/opt/novell/novell_zenworks_orch_install.conf without starting PlateSpin Orchestrate or applying the configuration settings. Installation and Configuration...
Page 52 .conf manually or with an installation script. Use the following command to run the configuration: /opt/novell/zenworks/orch/bin/config -rs 7j Click Next to display the following wizard page. 7k Click Next to launch the configuration script. When the configuration is finished, the following page is displayed: 7l Click Finish to close the configuration wizard.
Page 53 JVMARGS="-Xmx256m -Xms256m -Xmn64m -XX:NewSize=64m -XX:MaxNewSize=64m" argument specifies the maximum heap size for the JVM. Increasing the heap -Xmx size prevents a JVM out of memory condition. 8c Change the value in the argument from 256 MB to 512 MB. -Xmx Using the ISO to Install the PlateSpin Orchestrate 2.0.2 Agent on SLED and SLES 11 Machines PlateSpin Orchestrate 2.0.2 provides a separate ISO designated for SUSE Linux Enterprise Desktop...
Page 54 6b Make sure you are logged in as to run the configuration script. root 6c Run the script, as follows: /opt/novell/zenworks/orch/bin/config When the script runs, the following information is initially displayed: Welcome to PlateSpin Orchestrate. This program will configure PlateSpin Orchestrate 2.0 Select whether this is a new install or an upgrade PlateSpin Orchestrate 2.0 Installation and Configuration Guide...
Page 55 7 (Conditional) If you use the GUI Configuration Wizard, run it as follows: 7a Make sure the product ISO is accessible. The script copies some files from the ISO. 7b Make sure you are logged in as to run the configuration wizard. root 7c Run the wizard: /opt/novell/zenworks/orch/bin/guiconfig Installation and Configuration...
Page 56 When the script runs, the following information is initially displayed: IMPORTANT: If you have only a keyboard to navigate through the pages of the GUI Configuration Wizard, use the Tab key to shift the focus to a control you want to use (for example, a Next button), then press the spacebar to activate that control.
Page 57 7e Select the option to accept the agreement, then click Next to open the installation type page of the wizard: 7f Select New Installation, then click Next to display the Orchestrate Components page of the wizard: Installation and Configuration...
Page 58 PlateSpin Orchestrate Agent and applies the configuration settings. If you deselect the check box, the wizard writes out the configuration file to /etc/opt/novell/novell_zenworks_orch_install.conf without starting PlateSpin Orchestrate or applying the configuration settings. PlateSpin Orchestrate 2.0 Installation and Configuration Guide...
Page 59 .conf manually or with an installation script. Use the following command to run the configuration: /opt/novell/zenworks/orch/bin/config -rs 7j Click Next to display the following wizard page. 7k Click Next to launch the configuration script. When the configuration is finished, the following page is displayed: 7l Click Finish to close the configuration wizard.
Page 60: Installing The Orchestrate Agent From The Administrator Information Page
JVMARGS="-Xmx256m -Xms256m -Xmn64m -XX:NewSize=64m -XX:MaxNewSize=64m" argument specifies the maximum heap size for the JVM. Increasing the heap -Xmx size prevents a JVM out of memory condition. 8c Change the value in the argument from 256 MB to 512 MB. -Xmx Using the ISO to Install the Orchestrate Agent on Windows Machines The PlateSpin Orchestrate Agent is supported on Windows Server 2003 and Windows Server 2008, but not on Windows Vista, Windows XP, Windows 2000, or earlier releases (Windows ME,...
Page 61 This URL is the DNS name (or IP address) of the server for PlateSpin Orchestrate. Be sure to use Port 8001 in the address to access and display the page, as shown in the following illustration: The page includes links to information for PlateSpin Orchestrate administrators, including product documentation and the installers for the PlateSpin Orchestrate Development Client and the PlateSpin Orchestrate Agent.
Page 62 The Java 1.5.0 (32-bit) or Java 1.5.0 (64-bit) RPM 6 Install the Java 1.5.0 RPM by entering the one of the following commands (as applicable): rpm -ivh novell-zenworks-zos-java-1.5.0_sun_update17-0.x86_64.rpm rpm -ivh novell-zenworks-zos-java-1.5.0_sun_update17-0.i586.rpm 7 Install the Orchestrate Agent by entering the following command: rpm -ivh novell-zenworks-zos-agent-2.0.2-57039.i586.rpm...
Page 63 Installing and Registering the Windows PlateSpin Orchestrate Agent from the Administrator Information Page This section includes the following information about installing the Orchestrate Agent for Windows from the Administrator Information page: 1 On the computer where the PlateSpin Orchestrate Agent for Windows is to be installed, launch the PlateSpin Orchestrate Administrator Information page, as shown above.
Page 64 6 Click Next to display the License Agreement page. 7 Accept the license agreement, then click Next to display the Select Destination Directory page. 8 Accept the default location, then click Next to display the Select Start Menu Folder page of the Setup Wizard.
Page 65 9 Enter the path to the folder where you want the Wizard to set up shortcuts to the Agent or select Next to accept the default and to display the Windows Services page. 10 Select the services you want to install (at a minimum, you must select Install Service PlateSpin Orchestrate Agent), then click Next to display the Identify PlateSpin Orchestrate Server page.
Page 66 1.5.0 RPM to the ESX machine on which you want to install the Orchestrate Agent. 3 Install the Java 1.5.0 RPM by entering the following command: rpm -ivh novell-zenworks-zos-java-1.5.0.rpm 4 Install the Orchestrate Agent by entering the following command: rpm -ivh novell-zenworks-zos-agent-2.0.2rpm...
Page 67: Performing A Silent Install Of The Platespin Orchestrate Agent On Multiple Network Resources
7 From the bash prompt on the machine where you are configuring the agent, run the following command: /opt/novell/zenworks/orch/bin/config -s -C $CONF_FILE where CONF_FILE is the modified configuration file from Step The silent configuration runs, then the agent is displayed in the PlateSpin Orchestrate Console as registered with the server node.
Page 68: Installing The Platespin Orchestrate Agent On Other Supported Operating Systems
Silent Install and Configuration of the Orchestrate Agent for Windows The Windows Agent installer can be downloaded from the Administrator Information page, as documented in Section 2.3.2, “Installing the Orchestrate Agent from the Administrator Information Page,” on page PlateSpin Orchestrate includes an installation help page that provides tips for installing the Windows Orchestrate Agent on many machines by using some sort of scripting or automation.
Page 69 “Managing Virtual Machines” in the PlateSpin Orchestrate 2.0 VM Client Guide and Reference. Installing the Orchestrate Agent The manual installation procedure for the Orchestrate Agent depends on the operating system. The installed Orchestrate Agent components are: novell-zenworks-monitor-gmond-3.0.4-50.x86_64.rpm Installation and Configuration...
Page 70 The Orchestrate Agent can be installed on the following operating systems: “Microsoft Windows Server 2003 and Windows Server 2008” on page 70 “RHEL 4” on page 70 “RHEL 5” on page 71 “SLES 9” on page 71 NOTE: The Orchestrate Agent can be installed on VMware ESX 3.0.x /3.5.x VM hosts.
Page 71 $ up2date --solvedeps=libcap.so, libcap.so.1 6 Run the configuration script: $ /opt/novell/zenworks/orch/bin/config Table 2-1 on page 31 for an explanation of the configuration for the Orchestrate Agent. RHEL 5 To install the five packages of the Orchestrate Agent on RHEL 5: 1 Download the pertinent 32-bit or 64-bit Add-On ISO from the DVD.
Page 72: Automatically Installing The Orchestrate Agent On A Vm Host Using A Job
2.3.5 Automatically Installing the Orchestrate Agent on a VM Host Using a Job You can write a job to automatically install and configure the Orchestrate Agent on a host server. Such a job can be a script similar to the following, which is for an Apache VM: """...
Page 73: Installing The Orchestrate Development Client For Windows From The Administrator Information Page
Section 2.4.4, “Using the ISO to Install the Orchestrate Client on SLES 10 Machines,” on page 78 Section 2.4.5, “Using the ISO to Install the Orchestrate Client on SLES 11 Machines,” on page 79 2.4.1 Installing the Orchestrate Development Client for Windows from the Administrator Information Page After you install the server for PlateSpin Orchestrate on the network, you can launch the PlateSpin Orchestrate Administrator Information page.
Page 74 To install the Orchestrate Development Client for Windows from the Administrator Information page: 1 On the computer where the Orchestrate Development Client for Windows is to be installed, launch the PlateSpin Orchestrate Administrator Information page, as shown above. 2 Scroll to the Installation section of the page: 3 In the clients section of the Web page, identify the installer link.
Page 75 7 Accept the license agreement, then click Next to display the Select Destination Directory page. 8 Accept the default location, then click Next to display the Select Components page of the Setup Wizard. Installation and Configuration...
Page 76 Installing these components on a Windows workstation adds several items to the program group available from Start > All Programs > Novell > ZOS > Clients. One of these programs is the PlateSpin Orchestrate Command Prompt. The PATH is preset in this prompt to run the zos and zosadmin commands.
Page 77: Using The Iso To Install The Orchestrate Development Client On Windows Machines
11 Click Finish to exit the setup. 2.4.2 Using the ISO to Install the Orchestrate Development Client on Windows Machines The PlateSpin Orchestrate Client is supported on Windows Vista and Windows XP only. Use the following steps to download the PlateSpin Orchestrate Client for installation: 1 To verify that the device where you want to install the client software fulfills the necessary requirements, review Chapter 1, “Planning the Orchestrate Server Installation,”...
Page 78: Using The Iso To Install The Orchestrate Client On Sles 10 Machines
The Java 1.5.0 (32-bit) or Java 1.5.0 (64-bit) RPM 4 Install the Java 1.5.0 RPM by entering the one of the following commands (as applicable): rpm -ivh novell-zenworks-zos-java-1.5.0_sun_update17-0.x86_64.rpm rpm -ivh novell-zenworks-zos-java-1.5.0_sun_update17-0.i586.rpm 5 Install the Orchestrate Development Client by entering the following command: rpm -ivh novell-zenworks-zos-clients-2.0.2-57039.i586.rpm...
Page 79: Using The Iso To Install The Orchestrate Client On Sles 11 Machines
4g Click Accept to install the packages. You must install PlateSpin Orchestrate components before you can configure them. 5 Launch the Orchestrate Development Client from /opt/novell/zenworks/zos/clients/ with the following command: ./zoc 6 Select the Orchestrate Server grid object you want to log in to, then enter the username and password for that server to connect to it.
Page 80 3 (Optional) Create a DVD ISO (32-bit or 64-bit) that you can take with you to the machine where you want to install it. 4 Install PlateSpin Orchestrate Client software: 4a Log in to the target SLES 11 server or SLED 11 machine as , then open YaST2.
Page 81: Installing The Orchestrate Vm Client
5 Launch the Orchestrate Development Client from /opt/novell/zenworks/zos/clients/ with the following command: ./zoc 6 Select the Orchestrate Server grid object you want to log in to, then enter the username and password for that server to connect to it. 2.5 Installing the Orchestrate VM Client The PlateSpin Orchestrate VM Client program is installed on your Windows or Linux administration machines.
Page 82 You must uninstall the previous version of VM Client before installing version 2.0: Windows: On the Windows machine where the client is installed, click Start > Control Panel > Add or Remove Programs, select the Novell ZENworks VM Manager item, then click Remove. Linux: Run the following command: /opt/novell/zenworks/vmmanagement/Uninstall_ZENworks_VMM/ Uninstall_Novell_ZENworks_VM_Manager_1.3.0...
Page 83: Installing The Orchestrate Vm Client On The Windows Operating System
2.5.2 Installing the Orchestrate VM Client on the Windows Operating System NOTE: These installation steps apply only to Windows Vista and Windows XP. 1 Copy the file from the \Windows folder (see Table 2-3 on page 82) to vmclient_install.exe a location on your management Windows workstation. 2 Double-click the file to start the installation program: vmclient_install.exe...
Page 84 4 Read the terms of the license agreement; if you agree to abide by the terms, then click Next to display the Important Information page; otherwise, click Cancel to exit the installation: 5 After reviewing the third-party licenses, if you agree with them, click Next to display the Choose Install Folder page;...
Page 85 6 Select your installation folder, then click Next to display the Choose Shortcut Folder page: 7 Select a shortcut folder and any other options and groupings you want for the control of this interface, then click Next to display the Supported Hardware Platforms page: Installation and Configuration...
Page 86 8 Click Next to display the Pre-Installation Summary page: 9 Verify the information and click Previous as necessary to make changes. 10 When ready, click Install to begin the installation: PlateSpin Orchestrate 2.0 Installation and Configuration Guide...
Page 87: Installing Orchestrate Vm Client In A Linux Environment
When the installation has completed, the Install Complete page is displayed: 11 Click Done to finish the installation. If you selected to place the shortcut icon on your desktop, this is what it looks like: 12 For some necessary setup tasks, continue with “Managing Virtual Machines”...
Page 88 4 From the directory, enter to launch the installer: /mnt/iso/SLE10 ./vmclient_install 5 Click Next on the Introduction page to display the License Agreement page: PlateSpin Orchestrate 2.0 Installation and Configuration Guide...
Page 89 6 Read the terms of the license agreement; if you agree to abide by the terms, then click Next to display the Important Information page; otherwise, click Cancel to exit the installation: 7 After reviewing the third-party licenses, if you agree with them, click Next to display the Choose Install Folder page;...
Page 90 8 Select your installation folder, then click Next to display the Choose Desktop Launcher Folder page: 9 Select a shortcut folder and any other options and groupings you want for the control of this interface, then click Next to display the Supported Hardware Platforms page: PlateSpin Orchestrate 2.0 Installation and Configuration Guide...
Page 91 10 Click Next to display the Pre-Installation Summary page: 11 Verify the information and click Previous as necessary to make changes. 12 When ready, click Install to begin the installation: Installation and Configuration...
Page 92: Uninstalling The Vm Client
When the installation has completed, the Install Complete page is displayed: 13 Click Done to finish the installation. If you selected to place the launcher icon on your desktop, this is what it looks like: 14 For some necessary setup tasks, continue with “Managing Virtual Machines”...
Page 93: Uninstalling The Orchestrate Vm Client From The Windows Operating System
2.6.1 Uninstalling the Orchestrate VM Client from the Windows Operating System 1 On the Windows machine where the client is installed, click Start > Control Panel > Add or Remove Programs. 2 Select the PlateSpin Orchestrate VM Client item, then click Remove to open the InstallAnyWhere utility, which displays the first wizard page: 3 Click Next to display the Uninstall Options page: Installation and Configuration...
Page 94: Uninstalling Orchestrate Vm Client In A Linux Environment
If you receive a message after it is uninstalled indicating that some folders could not be removed, you must delete them manually. 2.6.2 Uninstalling Orchestrate VM Client in a Linux Environment 1 Run the following command: /opt/novell/zenworks/vmmanagement/Uninstall_PlateSpin_VMM/ Uninstall_PlateSpin_Orchestrate_VM_Client_2.0.2 PlateSpin Orchestrate 2.0 Installation and Configuration Guide...
Page 95 This opens the InstallAnyWhere utility, which displays the first wizard page: 2 Click Next to display the Uninstall Options page: Installation and Configuration...
Page 96: Determining The Product Version
If you are new to PlateSpin Orchestrate, if you need to determine component compatibility, or if you need to confer with Novell Support, it is useful to know how to obtain the version number of the different components.
Page 97 One way to determine which version of the PlateSpin Orchestrate RPM packages you have installed is to use the following command on the machine where an PlateSpin Orchestrate component is installed: rpm -qa | grep novell The table below provides additional methods you can use to determine the version number for PlateSpin Orchestrate components.
Page 98 PlateSpin Orchestrate 2.0 Installation and Configuration Guide...
Page 99: First Use Of Basic Platespin Orchestrate Components
® ® After you install and configure the basic components of PlateSpin Orchestrate from Novell , (that is, the PlateSpin Orchestrate Server, the PlateSpin Orchestrate Agent, and the PlateSpin Orchestrate Clients), you will want to see them at work. The information in this section is organized sequentially (that is, in a “walkthrough”...
Page 100 SLES 10 SP2: Use the following command to launch the Orchestrate Development Client: ./zoc Windows: In the Start menu, click Programs > Novell > ZOS > Clients submenu, click ZOS Management Console. When the Orchestrate Development Client is launched, it broadcasts throughout the network to discover all of the PlateSpin Orchestrate Servers that have been previously installed.
Page 101: Walkthrough: Logging In To The Platespin Orchestrate Server
3.2 Walkthrough: Logging In to the PlateSpin Orchestrate Server Before you can perform any administrator functions, you need to log in to the Orchestrate Server to establish your credentials as an authorized administrator. The information in this sections explains three methods for logging in to the server. Section 3.2.1, “Logging In by Using the Explorer,”...
Page 102: Logging In As Default
2 In the dialog box, specify the IP address of the Orchestrate Server in the Server Address field, then click OK to display the login dialog box. 3 Specify the administrator name (created during the install) in the Username field, specify the administrator password in the Password field, then click OK to log in to the server.
Page 103: Walkthrough: Creating A Resource Account
If the default user you provided as a preference is still accurate, you can simply click OK to log in. TIP: If you re-install PlateSpin Orchestrate and specify a new administrator username and password, that information is not displayed in the default login unless you change the login preferences.
Page 104: Opening The Resources Monitor
3.3.1 Opening the Resources Monitor Now that you have installed an Orchestrate Server and launched the PlateSpin Orchestrate Development Client, you can begin to create resource accounts. 1 Open the PlateSpin Orchestrate Development Client and click Resources to open the Resources Monitor in the Workspace panel of the Development Client.
Page 105: Automatically Registering A Resource
3.3.2 Automatically Registering a Resource If your network environment does not require a high level of security (such as in a development and testing environment) and you want a quick way to create a resource account, you can do so at the Development Client.
Page 106 Use the Orchestrate Development Client to Create a Resource Account Use the following steps to create a resource object in the PlateSpin Orchestrate Development Client. 1 Make sure that the Auto Register Agents check box on the grid object’s Authentication page is not selected (see Step 2 on page 105).
Page 107 Installing an Orchestrate Agent to Match the New Resource This section demonstrates installing an Orchestrate Agent to be used as a resource in your PlateSpin Orchestrate grid. The information in this part of the walkthrough assumes that a resource account has already been created for the Orchestrate Agent being installed.
Page 108 6 Follow the prompts in the wizard until the Identify PlateSpin Orchestrate Server page displays, then you need to ensure that you correctly enter the Platespin_Orchestrate_Server_name in the PlateSpin Orchestrate Server field. IMPORTANT: Make sure that the name you give the agent during the installation matches the name of the resource account you created in “Use the Orchestrate Development Client to Create a Resource Account”...
Page 109: Selecting A Resource For Manual Registration
9 In the PlateSpin Orchestrate Development Client, open the Resources Monitor to observe the resource object you created change from offline to online. When the object is no longer dimmed, the agent has logged in as a resource and is registered. When the resource is online, the Resources Monitor displays a labeled box representing the registered agent.
Page 110: Walkthrough: Observing Discovery Jobs
When the resource is online, the Resources Monitor displays a labeled box representing the registered agent. This box includes information about the agent, including the number of available slots it has and a status color indicating its state of readiness for PlateSpin Orchestrate jobs. The status color window can be white (inactive), blue (in use), yellow (available for use), or blue (in use).
Page 111: Walkthrough: Deploying A Sample Job
To verify this, you can view the resource account that you created earlier in Walkthrough: Creating a Resource Account (page 103) by selecting its object in the Explorer panel. By default, the Info/ Groups page for the resource opens in the Development Client workspace. Resource Information Page After Discovery Jobs Run Figure 3-3 If you scroll down on the Info/Groups page, you see that the discovery jobs have gathered basic data...
Page 112 Although a job developer can store PlateSpin Orchestrate jobs at any location on the network, the sample jobs shipped with PlateSpin Orchestrate are limited to the directories where the product is installed. For this walkthrough, navigate to the /opt/novell/zenworks/zos/ directory. server/examples 3 Select , then click OK to deploy the job to the Jobs container.
Page 113: Walkthrough: Creating A User Account
When the job is available, you need to create a user who can run that job. For more information, see Section 3.6, “Walkthrough: Creating a User Account,” on page 113 3.6 Walkthrough: Creating a User Account Although PlateSpin Orchestrate has some pre-assembled jobs, such as the discovery job cpuInfo that you learned about earlier, most jobs must be developed by a job developer, then be run and...
Page 114: Automatically Registering A User
You can use the Development Client to register a user automatically (see Section 3.6.2, “Automatically Registering a User,” on page 114) or to register a user manually (see Section 3.6.3, “Manually Registering a User,” on page 115). You can also select which users can log in to create accounts (see Section 3.3.4, “Selecting a Resource for Manual Registration,”...
Page 115: Manually Registering A User
When a user logs out, the User object icon is dimmed in the Explorer panel or in the Information view of each User group to which it belongs. 3.6.3 Manually Registering a User If you want a higher level of security for authorized users, you can manually create a user account in the Development Client before the user logs in.
Page 116: Logging In A User For Manual Registration
This dialog box includes a method for designating the user as a member of the administrators user group. In this walkthrough, we will create the user as a member of the all group, which does not place the user in the administrators group. 2 Specify the new username in the New User Name field, click Create, then click Close.
Page 117: Walkthrough: Running The Sample Job
2b Enter the password for the user credentials. For this walkthrough, you can simply press Enter to enter an empty password. 2c When prompted for a decision regarding whether you want to accept the server certificate, enter 3 In the Users Monitor, click the User Registration icon to open the User Registration Monitor dialog box.
Page 118: Walkthrough: Looking At The Job After It Has Run
3.8 Walkthrough: Looking at the Job After It Has After you have run the job, there are several ways to verify that it has run. This section explains those methods. Section 3.8.1, “Verification at the Command Line,” on page 118 Section 3.8.2, “Verification at the Jobs Monitor,”...
Page 119: Verification At The Jobs Monitor
Job Status for userA.whoami.60 ------------------------------ State: Completed Resource Count: 0 (0 this job) Percent Complete: 100% Queue Pos: n/a Child Job Count: 0 (0 this job) Joblet Counts: 1 (0) (1 (0/0/1/0/0) this job) Instance Name: whoami Job Type: whoami Memo: Priority: medium Arguments: resource=tszen4_agent...
Page 120: Verification At The Server Portal
3 In the Username drop-down list box, select the user who ran the job. whoami Although there is much more you can learn about a job in the Jobs Monitor view, you can see by displaying a recent job that the Development Client picks up the job activity and makes it available at the Development Client.
Page 121 2 Verify that the job you ran is displayed in the history of the Server Portal. 3 Click the log link in the Identification column of the job history to open the job log. First Use of Basic PlateSpin Orchestrate Components 121...
Page 122: Walkthrough: Using The Zosadmin Command To Gather Information
2 Enter the administrator’s user name and password. If the login was successful, the command line tool returns a message like this: Logged into tszen4_grid on server 'tszen4.provo.novell.com' 3 Enter the following command to list the active users on your PlateSpin Orchestrate system:...
Page 123: Stopping And Starting The Platespin Orchestrate Server
If you are running the agent on a Windows machine, click Start > Programs > Novell > ZOS > Agent > Shutdown ZOS Agent.
Page 124: Starting And Stopping The Platespin Orchestrate Development Client
To start the PlateSpin Orchestrate Agent from a Windows machine, double-click the ZOS Agent shortcut on your desktop or click Start > Programs > Novell > ZOS > Agent > Start ZOS Agent. If you are at the Linux bash prompt, enter the following command: /etc/init.d/novell-zosagent start...
Page 125: A Platespin Orchestrate Components: Install Patterns
The table in this section provides information about each of the server and agent installation patterns ® ® in PlateSpin Orchestrate from Novell Section A.1, “Installation Patterns in YaST,” on page 125 A.1 Installation Patterns in YaST The table in this section provides information about each of the server and agent installation patterns.
Page 126 /Agent Patterns Virtual Machine python-pywbem zw_zos_agent zw_mon_agent Builder sblim-cmpi-xenvm-builder zw_zos_clients [zw_vm_builder] zw_orch_config Monitoring Agent novell-zenworks-monitor-gmond zw_orch_config [zw_mon_agent] PlateSpin novell-zenworks-orch-config S or A Orchestrate Config novell-zenworks-orch-config-gui (not listed; included in all patterns except Client [zw_orch_config] 126 PlateSpin Orchestrate 2.0 Installation and Configuration Guide...
Page 127: B Installing The Orchestrate Monitoring Agent On Windows Machines
Installing the Orchestrate Monitoring Agent On Windows Machines ® Installing the PlateSpin Orchestrate Agent on a Microsoft* Windows* Server 2003 or Windows Server 2008 (see Section 2.3.4, “Installing the PlateSpin Orchestrate Agent on Other Supported Operating Systems,” on page 68) does not automatically install the Orchestrate Monitoring Agent as it does when you install it using RPM packages for Linux*.
Page 128: Starting And Stopping The Monitoring Agent
Windows local machine. It does not support multicasting. The installation includes a preconfigured that will work strictly on the local host. You can manually edit gmond.conf for a different configuration, but your changes are not supported by Novell. gmond.conf 128 PlateSpin Orchestrate 2.0 Installation and Configuration Guide...
Page 129 If you choose to customize an unsupported configuration for your needs, you can test the configuration by stopping the gmond service and then restarting gmond from the Windows command line prompt. Use the (debug) and (foreground) options to capture any error messages generated by the new configuration.
Page 130 130 PlateSpin Orchestrate 2.0 Installation and Configuration Guide...
Page 131: C Documentation Updates
Documentation Updates This section contains information about documentation content changes that were made in this PlateSpin Orchestrate Installation and Configuration Guide after the initial release of PlateSpin Orchestrate 2.0. The changes are listed according to the date they were published. The documentation for this product is provided on the Web in two formats: HTML and PDF.
Page 132 Location Update Section 1.1.3, “Orchestrate Agent,” Added information to indicate support for SLES 11. on page 13 Section 1.1.4, “VM Hosts,” on Added information to indicate support for SLES 11. page 13 Section 1.2, “Component Installation Added information to indicate support for SLES 11. Methods,”...

This manual is also suitable for:

Platespin orchestrate 2.0.2

Novell PLATESPIN ORCHESTRATE 2.0.2 - INSTALLATION AND CONFIGURATION GUIDE 10-09-2009 Installation And Configuration Manual

About this Guide

1 Planning the Orchestrate Server Installation

2 Installation and Configuration

3 First Use of Basic Platespin Orchestrate Components

A Platespin Orchestrate Components: Install Patterns

B Installing the Orchestrate Monitoring Agent on Windows Machines

C Documentation Updates

Quick Links

Related Manuals for Novell PLATESPIN ORCHESTRATE 2.0.2 - INSTALLATION AND CONFIGURATION GUIDE 10-09-2009

Summary of Contents for Novell PLATESPIN ORCHESTRATE 2.0.2 - INSTALLATION AND CONFIGURATION GUIDE 10-09-2009

This manual is also suitable for:

Table of Contents