Dollar.universe 6.6 Getting Started Guide En

Embed Size (px)

Citation preview

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    1/27

    Version: 6.6.01

    Publication Date: 2016-02

    Automic Software GmbH

    Dollar Universe

    Getting Started

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    2/27

    ii | Copyright

    Copyright

    Automic and the Automic logo are trademarks owned by Automic Software GmbH (Automic). Allsuch trademarks can be used by permission only and are subject to the written license terms. This

    software/computer program is proprietary and confidential to Automic Software and is only availablefor access and use under approved written license terms.

    This software/computer program is further protected by copyright laws, international treaties and otherdomestic and international laws and any unauthorized access or use gives rise to civil and criminalpenalties. Unauthorized copying or other reproduction of any form (in whole or in part), disassembly,decompilation, reverse engineering, modification, and development of any derivative works are allstrictly prohibited, and any party or person engaging in such will be prosecuted by Automic Software.

    No liability is accepted for any changes, mistakes, printing or production errors. Reproduction in wholeor in part without permission is prohibited.

    Copyright Automic Software GmbH. All rights reserved.

    Other names may be trademarks of their respective holders.

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    3/27

    Dollar Universe Getting Started | iii

    Contents

    1Release Notes ...................................................................................................................... 5

    2

    Introduction .......................................................................................................................... 6

    3Environment ......................................................................................................................... 7

    3.1

    Logging into UniViewer Console .................................................................................... 7

    3.1.1

    UVMS License Management .................................................................................... 8

    3.2 Declaring the Dollar Universe Node ............................................................................... 8

    3.2.1

    Validity of Dollar Universe License ........................................................................... 8

    3.2.2

    Ensuring start-up of services- Windows ................................................................... 9

    3.2.3 Ensuring start-up of services- UNIX/Linux ............................................................... 9

    3.3Accessing Dollar Universe Explorer ............................................................................... 9

    3.3.1

    DUX License Management ....................................................................................... 9

    3.3.2

    Repository Creation ................................................................................................ 10

    3.3.3 UniViewer Configuration ......................................................................................... 10

    3.3.4 Starting and Stopping Dollar Universe Explorer ..................................................... 11

    3.3.5

    Connection Page .................................................................................................... 12

    4Business Views .................................................................................................................. 13

    4.1 Introduction to Business Views ..................................................................................... 13

    4.2 How to Create a Business View ................................................................................... 13

    4.2.1

    Creating a Uproc .................................................................................................... 13

    4.2.2

    Duplicating a Uproc ................................................................................................ 14

    4.2.3 Save the Business View ......................................................................................... 15

    4.2.4 Creating a Session ................................................................................................. 15

    4.2.5

    Creating a Task ...................................................................................................... 17

    4.2.6 Deploying the Business View ................................................................................. 18

    4.3 Job Chains .................................................................................................................... 19

    4.4

    Recap............................................................................................................................ 21

    5Monitoring Workflows ....................................................................................................... 22

    5.1 Filtering Workflows ....................................................................................................... 23

    6

    About Automic Software, Community and Services ...................................................... 24

    6.1

    Automic Software Company ......................................................................................... 24

    6.2Automic Community ...................................................................................................... 24

    6.3 Download Center .......................................................................................................... 24

    6.4

    Technical Support ......................................................................................................... 25

    6.5

    Training and Services ................................................................................................... 25

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    4/27

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    5/27

    Chapter 1Release Notes | 5

    1 Release Notes

    The following is the change history. Information on bug-fixes and known errors is available in theWorkload Automation Release Notes and by contacting Automic technical support.

    Date Key Features

    2014-11 Dollar Universe user manuals change their look to integrate the Automic world.

    2016-02 Update for version 6.6: changes in Business Views

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    6/27

    6 | Chapter 2Introduction

    2 Introduction

    Welcome to the Dollar Universe 6 Getting Started!

    This manual addresses the needs of the person(s) who will use UniViewer Console to manage DollarUniverse for the first time and accessing Dollar Universe Explorer.

    This manual will provide basic information to design jobs and to run a job chain.

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    7/27

    Chapter 3 Environment | 7

    3 EnvironmentYour environment should contain:

    Dollar Universe Application Server

    Dollar Universe Explorer

    UniViewer Management Server

    UniViewer Console installed locally on your machine

    3.1 Logging into UniViewer Console

    In Windows:

    Select the UniViewer Consolefrom the Windows Menu.

    Start>Programs>AUTOMIC>UniViewer Console > UniViewer Console.

    In UNIX/LINUX:

    Go to the UniViewer Console installation directory (by default):

    cd /var/opt/AUTOMIC/univiewer_console

    Execute the UniViewer Console launch script:

    ./unistartconsole.ksh

    Enter adminin the Loginfield.

    Enter the password you choose at UniViewer Management Server installation (admin by default).

    Click the Advanced button.

    Enter the UVMS Hostname NB120290(for example) and port Number4184(default).

    Click Connect.

    The Management Server you specify during the first connection is recorded. You will not have toprovide it at subsequent connections.

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    8/27

    8 | Chapter 3Environment

    3.1.1 UVMS License Management

    Dollar Universe features are activated by license key. To enter the license key select AdministrationMode > Nodes > Nodes.

    Select Management Servernode then click Node Settings.

    Select Licensesfrom the list of categories, then select an empty row and click Addon the shortcutmenu (or double click on a blank line).

    Finally, paste in the License Key string.

    Click Save.

    If the license key is correct the Statusfield will display green and show a VALID status.

    3.2 Declaring the Dollar Universe NodeFirst go to Administration>Nodes>Nodes, select the Management Server and right-click NodeSettings>Optional Services.

    Ensure that the following optional service is on:

    Consolidation of Job SummaryThe Dollar Universe node is automatically declared to the Management Server during its installation. Itmust appear in this list. Its status should be Connected.

    If the status is unreachable or you get an error message, check whether Dollar Universe has started.

    3.2.1 Validity of Dollar Universe License

    A valid license is required to operate Dollar Universe.

    To access the license, select the target DUAS from Administration>Nodes>Nodes, select the DollarUniverse node thenNode Settings>Licenses.

    If the DUAS license is invalid or missing:

    Access to the $U functions are still possible (if the UVMS license for DUAS is valid).

    Objects can be created and saved.

    Launcher and Calculator engines however, cannot be started.

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    9/27

    Chapter 3 Environment | 9

    Access the product log from Nodes > Trace > Product Log

    If the circled message above appears, the license you entered is invalid.

    3.2.2 Ensuring start-up of services- Windows

    To ensure that the Dollar Universe services have actually started: select the menu Start > Programs> Administration tools > Services.

    The Univer$e __IO_X service are basic processes of the product and should bestarted at least for the Production Area (_X).

    The Univer$e __EEP_X service is used to monitor Dollar Universe externalresources.

    The Univer$e _ Interactive Desktop service is used to submit interactive jobs.

    The Univer$e _ user administrator service can be used as submission account.

    3.2.3 Ensuring start-up of services- UNIX/Linux

    To ensure that the Linux services have actually started, make sure the following processes are startedin the Production Area (X):

    uxioserv X

    uxcdjsrv X

    uxbvssrv X

    uxdqmsrv X

    The IO (uxioserv) and CDJ (uxcdjsrv) processes are basic processes of the product and should bestarted at least for the Production Area (X). The BVS (uxbvssrv) processes are the Business ViewStatus processes. DQM (uxdqmsrv) is used to submit the jobs. They are necessary for operations inlocal mode.

    3.3 Accessing Dollar Universe Explorer

    3.3.1 DUX License Management

    Use of the Dollar Universe Explorer graphical Interface is subject to license. The license key must bedeclared in the Dollar Universe Explorer license file. This file data\u_fali01.txtis created by theinstallation procedure.

    This license is specific to the Dollar Universe Explorer node name.

    The product code is DUX; the product version is 6. Enter the valid license in the following format:

    node product version expiration_date key

    Example:DUXnode DOLLAR_UNIVERSE:DUX 6 20201231 0123456789ABCDEFGH

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    10/27

    10 | Chapter 3Environment

    License keys can be obtained from the Support Portal (customer login onSupport Portal)or throughyour sales contact.

    In the absence of a valid license, the Dollar Universe Explorer server starts but refuses all newuser connections. A message is written in the log file.

    A modification of the license file may be detected by the server, at the latest at the end of acycle of 5 minutes.

    3.3.2 Repository Creation

    When started, Dollar Universe Explorer connects to UVMS and collects the defined repositories.

    To create a repository, in Administration mode >Nodes > Repositories: create a repository on aCompany/Area environment of your choice. In this example the repository is called Repository.

    3.3.3 UniViewer ConfigurationTo create the minimum UniViewer configuration to use Dollar Universe Explorer, the approach is thefollowing (refer to the UniViewer User Manualor the online help for a detailed description of thescreens):

    In Administration mode > Security >Roles, create a Dollar Universe Explorer role (ex. DUX) onthe repository and grant it the display permission.

    In Administrationmode > Security > Groups: create a new group (ex. DUX) or open an existinggroup. In the section Roles, click the box before the Dollar Universe Explorer role that you justcreated.

    http://customer.orsyp.com/http://customer.orsyp.com/http://customer.orsyp.com/http://customer.orsyp.com/
  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    11/27

    Chapter 3 Environment | 11

    In Administrationmode > Security > Login: modify your user account. In the Group section, checkthe case before the group that contains the Dollar Universe Explorer role (DUX in this example).

    Once your user name exists in UVMS, its group (i.e. DUX) has a Dollar Universe Explorer role thatgives the display permission to the repository ( respository). You can then connect to Dollar UniverseExplorer.

    3.3.4 Starting and Stopping Dollar Universe Explorer

    Dollar Universe Explorer is started automatically at installation. To start Dollar Universe Explorer

    manually:

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    12/27

    12 | Chapter 3Environment

    From the command line: To start Dollar Universe Explorer, run the unistartdux commandfrom the bin directory (ex. C:\Program files(86)\AUTOMIC\Dollar UniverseExplorer\bin\unistartduxon Windows). To stop Dollar Universe Explorer, run the commandunistopdux.

    From the Windows menu: Programs > AUTOMIC > Dollar Universe Explorer > DollarUniverse Explorer Startor Dollar Universe Explorer Stop

    Dollar Universe Explorer must be started in order for the graphical interface to be displayed.

    3.3.5 Connection Page

    To access the graphical interface of Dollar Universe Explorer, open a web browser and enter thefollowing URL:

    http://localhost:9000: If you are opening Dollar Universe Explorer on your local machine.

    http://:9000: to access a remote machine. The name of the machine can be thehostname or the IP address.

    9000 is the port number attributed by default when Dollar Universe Explorer is installed. If it ismodified, the new value will be in the variable HTTP_SERVER_PORT.

    The connection page allows you to enter the user name and password. It gives access to therepositories the user has permission to display.

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    13/27

    Chapter 4Business Views | 13

    4 Business ViewsDollar Universe Explorer is a tool for monitoring workflows in order to better understand DollarUniverse production. Therefore, there must be an already existing workflow on the repository node. If

    one does not exist, the user can create and deploy a business view in order to create a job chain.In order for the job chain to appear in Dollar Universe Explorer, all the Dollar Universe objects must besaved on the reference node entered during the creation of the repository (repositoryin theexamples).

    4.1 Introduction to Business Views

    Business Views are stored on an arbitrary Dollar Universe reference Node. It is for design purposesonly and objects are stored locally. A Business View may use Uprocs, Sessions, Resources, andTemplate Tasks.

    Business Views provide users with an open stage to freehand their business process design. Theyare a particularly attractive proposition when it comes to process design that is pertinent to an actualbusiness segment in the organization, like an ERP or the activity of some departments like period-endfinancial reporting.

    Business Views do away with the constraints of Dollar Universe's legacy interface. You are no longernavigating through screens or working with Uprocs and Sessions as isolated items. The focus is nowon the process itself. You're given an empty stage with free range to design scheduling applicationsthat are modeled around real-life applications and hard business procedures.

    4.2 How to Create a Business ViewIn UVC, go to Design Mode>Graphical Design>Business Views.

    Select the target Dollar Universe Company/Area and node. Click Ok.

    Open the document Graphical Design > Business Views.

    Once the new Business Views List Document appears click on New.

    In the New Business Viewdocument, you will see four tabs:

    Object Design

    Edit and Display

    Design

    Deployment

    4.2.1 Creating a Uproc

    To create a new Uproc make sure you are in Area X or S. Then, under the first tab Object Design,click on Create Uproc to open the Uproc document.

    Under the General Section which will appear, enter the Name of the new Uproc as shown: DB_SHUT(this field can hold 64 alphanumeric characters at most).

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    14/27

    14 | Chapter 4Business Views

    Enter a Label:Shutdown database (this field can hold 64 alphanumeric characters at most).

    Version: 000

    Type: Select CL_INT for a Uproc with an internal script.

    Application:Enter the application code: "U_" (64 alphanumeric characters).

    Domain: I

    4.2.1.1 Internal script

    Click the Editbutton on the far right in the Typefield to create the script to be automated:

    Enter the following script on Windows:

    echo off

    %UXEXE%\uxsleep 15

    set resexe=0

    Echo on

    Enter the following script on UNIX/Linux:

    sleep 15

    exit 0

    Save.

    Execution waits for 15 seconds, then the resexevariable (on Windows) or the exit (on UNIX/Linux)indicates the result of script execution:

    If it equals 0: the job will complete (COMPLETED status).

    If it is different from 0: the job will fail (ABORTED status).

    4.2.1.2 Save and Close Uproc

    Dont forget to save your Uproc, and then close the breadcrumb, which is a device used to openmultiple levels of documents.

    To close the document just click on the little encircled cross. If the document contains opensubdocuments, they will also be closed.

    4.2.2 Duplicating a Uproc

    Now create another Uproc. Once back in the Object Designtab, right-click on your original UprocDB_SHUTand then click on Duplicate.

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    15/27

    Chapter 4Business Views | 15

    Name this Uproc DB_SAVE. The new DB_SAVE Uproc is identical to the Uproc that was duplicated:same specs and same command file.

    Fill in the name and label fields.

    Remember to save each Uproc.

    Close the breadcrumb.

    Repeat this process to create DB_START.

    Once all your Uprocs are created, line them up vertically:

    Click on the Designtab.

    Select the three Uprocs (Ctrl + left button of the mouse).

    Click the LEFT green arrow to align the Uprocs.

    Now you can create a session.

    4.2.3 Save the Business View

    Click on the disk on the top left side of the Business View document. In the window displayed:

    Enter the Name: DAILYDB.

    Enter the Label: DB daily processing.

    Click OK.

    4.2.4 Creating a Session

    To create a Session: Click on the Object Designtab

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    16/27

    16 | Chapter 4Business Views

    Select the three Uprocs

    Click Create > Create Session from Uproc(s)

    In the window displayed:

    Enter the Nameof your Session: DB_MAINT (64 characters max).

    Enter a Label:Daily DB Maintenance.

    Click OK.

    The name and the Uproc description will appear in red because the Session links dont exist yet.Select the Session, and then click on Create OK Session Link.

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    17/27

    Chapter 4Business Views | 17

    Put the DB_SHUT cursor towards DB_SAVE. Use arrows to link the Uprocs. They determine thesubmission order.

    Next, click again on Create OK Session Linkto release the cursor.

    Savethe Business View. This action displays a message to inform you the session will be savedfirst.

    The little colored ball in the top right corner of the Session allows the color of the Session box to bechanged.

    4.2.5 Creating a Task

    Right-click on the session and click on Schedule.

    In the General section, enter the name of your Task: DB_MAINTENANCE

    In the Schedulesection, select the Add >Launch Window:

    Click onAtthen type 19:00 in the Time field.

    Fill in the Duration field with 1 hour and 0 minutes.

    You may leave the Every and Until fields at zero.

    Click OK.

    4.2.5.1 Schedule Tab

    To plan a task, click Add>Rulein the Schedule section. In the Ruleframe, click on the arrow buttonto display the rules list. Select the WORKDAY rule, which schedules the job every working day(defined in the general calendar created at installation: from Monday to Friday).

    Then choose the Start dateby clicking on the calendar on the right or using the up and down arrowkey.

    Click OK.

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    18/27

    18 | Chapter 4Business Views

    4.2.5.2 Choosing a Submission Account

    In the Technical data section, click the Submission Accounts value help button to display the list ofexisting submission accounts.

    Choose the local administrator account and then click Select.

    Click Save and Close to keepthe task and close the breadcrumb.

    Back in the Business View window, click on Save. Close the Business View.

    4.2.6 Deploying the Business View

    The Business View Deployment is necessary to use the objects in Dollar Universe. Objects aredeployed to the appropriate Dollar Universe nodes. Deploy distributes the components to targetManagement Units and renders them operational.

    In order to deploy a Business View, you can use either method below. They accomplish the samething:

    In the Business Views list, select DAILYDB.BV and click Send to

    In the Design Mode > Deployment, click Deployment Hub. In the list of deployments, clickNew Deployment.

    In the Source section, select type "Business View and check the DAILYDB.BV checkbox.

    Using either method, you should see the following screen:

    In the Destinationsection, select "Management Unit" and check the checkbox for the ManagementUnit, whose name matches the name of the local Node.

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    19/27

    Chapter 4Business Views | 19

    Check the "Enable the following" checkbox to create a Job Chain as you deploy the BV. Click Sendtoinitiate the deployment.

    The list of deployed objects appears in the list of deployments: Design Mode > Deployment >Deployment Hub.

    Close the Deployment Hub.

    4.3 Job Chains

    Job Chains are used for Monitoring and are stored on the arbitrary Dollar Universe reference node. They contain operational tasks. Business Views create Job Chains after deployment. Progress of

    executions is displayed graphically and the user can see the status of each execution and drill downto see the detail. Job Chains can be generated from existing Business Views (when deployed) or fromscratch.

    In the Monitoring Mode>Monitoring>Job Chainsselect the Dollar Universe environment where theBusiness View was deployed. Then click OK.

    Next, select the DAILYDB.JC Job Chain in the list and click on Monitor.

    Select the task and in the Monitoringtab, click Run. In the New Run window click Runagain. Youcan see the Uprocs running in the Graphical frame and in the Job Monitoring list.

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    20/27

    20 | Chapter 4Business Views

    By moving the mouse over the Uproc, you can display the average run time (using statisticalaverages).

    By moving the mouse over the Task space, you can display the status of the Session, at the end ofSession execution as well as average run time (using statistical averages).

    Choose your first Uproc and right click. Then select Display Run.

    Check the status in the Generalsection or the Job Logand History Traceoptions in the toolbar.

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    21/27

    Chapter 4Business Views | 21

    Close the breadcrumb.

    4.4 RecapTo recap, Business Views is an extremely powerful aide to those users whose responsibility involve alot of development centered on business processes and prefer a global interface rather than move inand out of object categories.

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    22/27

    22 | Chapter 5Monitoring Workflows

    5 Monitoring WorkflowsOnce a job chain has been created with UVC in the Dollar Universe environment, connect to DollarUniverse Explorer.

    Click Search

    Once the search is entered, all workflows on the selected repository are displayed. Currently, on therepository there is only one workflow, the job chain that was just created: DB_MAINTENANCE.

    Double-click on the workflow and select View details to display the contents of the workflow. Thedetail of the scheduled workflow contains the Uprocs created for the Business View and displays the

    Uproc name and type (Shutdown Database, Save Database and Start Database).

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    23/27

    Chapter 5Monitoring Workflows | 23

    5.1 Filtering WorkflowsIf a repository contains several workflows a search can be performed using a string of characters.

    The engine searches for words that start with the entered string in the object names or theirdescriptions. The search engine by default considers all the strings separated by spaces as differentwords. The following characters are also considered as separators: \ _ $ @ #.

    Example: If the job is called SHUTDOWN DATABASE, the user can perform a search on S, SH, SHU,D DATABASE.

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    24/27

    24 | Chapter 6About Automic Software, Community and Services

    6 About Automic Software,Community and Services

    This topic introduces the Automic Software company and how to leverage the full potential of oursolutions to you.

    You can also obtain Automic documentation online fromdocs.automic.com.

    6.1 Automic Software Company

    Automic Software is dedicated to business automation.

    Automic is the world's most comprehensive platform in automating businesses. Founded 1985,Automic pioneered the largest, independent, globally deployed automation platform which powers theenterprise, application and infrastructure. Now, as the consumerization of IT accelerates, Automic isre-imagining how organizations integrate next generation service models such as Cloud, DevOps andBig Data. Today, our software automates tens of millions of operations a day for over 2,000customers worldwide. We challenge conventional thinking, enabling our customers to be faster,smarter, in control. Automicthe standard in business automation.

    Find out more at our websitewww.automic.com.

    6.2 Automic CommunityWant to connect with other Automic users to compare notes or learn how others are tackling problemsthat youre running into?

    Talk with other users from around the world to learn how they optimize their business automation withAutomic. Interact with the Automic Team to get ONE Automation Platform tips and tricks straight fromthe source.

    Join the Automic Community and become an Automic Insider and be among the first to get newsabout new products and events, even before they are generally announced!

    6.3 Download Center

    Make sure that you are using our products to their fullest potential.

    The Download Center is the place where you find product downloads, documentation and informationon new releases and hot-fixes about your Automic solution. Its all in oneplace: from service hotfixes,release notes, and all guides. You will also find patch descriptions, known bugs or workarounds.

    http://localhost/var/www/apps/conversion/tmp/scratch_3/docs.automic.comhttp://localhost/var/www/apps/conversion/tmp/scratch_3/docs.automic.comhttp://localhost/var/www/apps/conversion/tmp/scratch_3/docs.automic.comhttp://www.automic.com/http://www.automic.com/http://www.automic.com/http://www.automic.com/http://localhost/var/www/apps/conversion/tmp/scratch_3/docs.automic.com
  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    25/27

    Chapter 6About Automic Software, Community and Services | 25

    6.4 Technical Support

    We have a support team you can trust.

    Our team of professionals is ready to support you, anytime and anywhere. Three support centerslocated in Europe, the United States, and Asia Pacific build the core of the Automic supportorganization.

    Our Technical Support Team makes sure that your closest Automic experts are never more than afew hours flight away, no matter on which continent your subsidiaries and data centers are located.

    Automic Software is designed to provide global connectivity for international companies. You areemploying Automic software on a global scale and therefore you can expect global service.

    6.5 Training and Services

    Do you want to learn even more about Automic solutions?

    We offer a range of training options on how to get the most out of your Automic solution. Dependingon your location, either open training sessions at an Automic Software Service Center, orpersonalized training sessions at your company's site suits best. Visit the training site and get detailedinformation about currently offered courses.

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    26/27

  • 7/26/2019 Dollar.universe 6.6 Getting Started Guide En

    27/27