Installing and Uninstalling the Server

This chapter describes how to install and uninstall the AnyLink server.

1. Installation

Execute the console installer to install AnyLink in Unix/Linux. The console installer suggests default values in the installation process. Since it is impossible to go back to a previous step in a shell, entered values can be changed after the installation.

The following describes how to install AnyLink in Unix/Linux.

  1. Upload the AnyLink installation file (AnyLink_unix_en.bin) to the server, and go to the directory that contains the file.

  2. Grant execution permission to the file.

    chmod u+x AnyLink_unix_en.bin
  3. Enter the file name in the console and then press the <ENTER> key.

    anylink@node:~$ ./AnyLink_unix_en.bin
    Preparing to install...
    Extracting the installation resources from the installer archive...
    Configuring the installer for this system's environment...
    strings: '/lib/libc.so.6': No such file
    
    Launching installer...
    
    Preparing CONSOLE Mode Installation...
    
    ===============================================================================
    AnyLink                        (created with InstallAnywhere by Macrovision)
    -------------------------------------------------------------------------------
  4. A brief introduction about the installer will be displayed. Press the <ENTER> key to proceed to the next step.

    ===============================================================================
    Introduction
    ------------
    
    InstallAnywhere will guide you through the installation of AnyLink.
    
    It is strongly recommended that you quit all programs before continuing with
    this installation.
    
    Respond to each prompt to proceed to the next step in the installation. If you
    want to change something on a previous step, type 'back'.
    
    You may cancel this installation at any time by typing 'quit'.
    
    PRESS <ENTER> TO CONTINUE:
  5. The license agreement will be displayed.

    ===============================================================================
    License Agreement
    -----------------
    
    Installation and Use of AnyLink Requires Acceptance of the Following License
    Agreement:
    
    
    AnyLink
    This Software is made by 'TmaxSoft Co.,Ltd.' and this software is distributed
    under our license agreement.
    
    Software End-User License Agreement
    
    Product : AnyLink
    This is a legal agreement between you (either an individual or an entity) and
    TmaxSoft,Incorporated.
    By opening the  sealed software package and/or by using the software, you agree
    to be bound by the terms of this agreement.
    
    AnyLink Software License
    
    1.  Grant of License:  This AnyLink Software License Agreement ("License")
    permits you to use one copy of the TmaxSoftware product Tmax, on any single
    computer, provided the software is in use on only one computer at any one time.
    If this package is a license pack, you may make and use additional copies of the
    software up to the number of licensed copies authorized.  If you have multiple
    licenses for the software, then at any time you may have as many copies of the
    software in use as you have licenses.
    The software is "in use" on a computer when it is loaded into the temporary
    
    PRESS <ENTER> TO CONTINUE:
  6. Press the <ENTER> key to see more information about the license agreement.

    memory (i.e., RAM) or installed into the permanent memory (e.g., hard disk,
    CD-ROM,or other storage device) of that computer, except that a copy installed
    on a network server for the sole purpose of distribution to other computers is
    not "in use". If the anticipated number of users of the software will exceed the
    number of applicable licenses, then you must have a reasonable mechanism or
    process in place to ensure that the number of persons using the software
    concurrently does not exceed the number of licenses.
    
    2.  Copyright:  The software (including any images, applets, photographs,
    animations, video, audio, music and text  incorporated into the software) is
    owned by TmaxSoft or its suppliers and international treaty provisions.
    Therefore, you must treat the software like any other copyrighted material
    (e.g., a book or musical recording) except that you may either (a) make one copy
    of the software solely for backup or archival purposes, or (b) transfer the
    software to a single hard disk provided you keep the original solely for
    backup or archival purposes.  You may not copy the printed materials
    accompanying the software, nor print copies of any user documentation provided
    in "online"or electronic form.
    
    3.  Other restrictions:  This license is your proof of license to exercise the
    rights granted herein and must be retained by you.
    You may not rent or lease the software, but you may transfer your rights under
    
    PRESS <ENTER> TO CONTINUE:
  7. Select whether to accept the terms of the license agreement. Enter "Y" and press <ENTER> to accept, or enter "N" and press <ENTER> to not accept.

    this license on a permanent basis provided you transfer this license, the
    software, and all accompanying printed materials, retain no copies, and the
    recipient agrees to the terms of this license.  You may not reverse engineer,
    decompile, or disassemble the software, except to the extent that the
    foregoingrestriction is expressly prohibited by applicable law.
    
    TmaxSoft Co., Ltd.
    
    
    
    
    DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): y
  8. Choose a platform to install AnyLink and enter its number. To use the default value, press <ENTER>. Otherwise, enter the number of the desired platform.

    ===============================================================================
    Choose Platform
    ---------------
    
    Choose the operating system and architecture :
    1)HP-UX PA-RISC
    2)HP-UX Itanium
    3)Solaris UltraSPARC
    4)Solaris x86
    5)Solaris x64
    6)AIX 5.x, 6.x, 7.x PowerPC
    7)Linux Itanium
    8)Linux x86
    9)Linux x64
    10)Linux PowerPC 64
    Quit) Quit Installer
    
    Choose Current System (DEFAULT: 9):
  9. Select the installation directory. To use the default value, press <ENTER>. To select a different directory, enter the desired installation directory.

    ===============================================================================
    Installation Folder
    -------------------
    
    Enter the installation folder.
    
      Default Install Folder: /home/anylink/jeus7
    
    ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT
          :
  10. Select Installation Mode. By default, Production Mode is selected.

    ===============================================================================
    Installation Mode
    -----------------
    
    * Production Mode
    - Disables JEUS Hot Swap.
    - Disables Automatic Reloading.
    - Displays a warning message and recommends using a full license if a demo
    license is used.
    
    * Development Mode
    - Enables JEUS Hot Swap.
    - Enables Automatic Reloading.
    
      ->1- Production Mode
        2- Development Mode
        3- Cancel
    
    ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE
       DEFAULT:
  11. Enter the location of JDK. If <ENTER> is pressed without any location, then the automatically recognized JDK location will be used.

    ===============================================================================
    Enter the JDK path.
    -------------------
    
    Enter the JDK path:
    
    Enter the JDK path (DEFAULT: /home/anylink/jdk1.7.0_79):
  12. Enter the password of the JEUS admin. The entered password will be assigned to the administrator ID. The password will be required for starting JEUS.

    ===============================================================================
    Password Input
    --------------
    
    Enter the Password for the administrator account.
    
    Input Password::
    
    Corfirm Password::
  13. Enter the domain name to be used for the Domain Admin Server.

    ===============================================================================
    User Domain name
    ----------------
    
    Enter the Domain name
    
    Enter the domain name (DEFAULT: AnyLink_domain):
  14. Enter the IP address of the LocalHost in which the AnyLink server will be installed.

    ===============================================================================
    Get User LocalHost IP
    ---------------------
    
    
    
    IP (DEFAULT: 127.0.1.1):
  15. Enter the DIS port.

    ===============================================================================
    Get User Variable
    -----------------
    
    
    
    DIS Port (DEFAULT: 7127):
  16. Select the type of the repository DB used by the AnyLink server. Currently, Tibero and Oracle are supported.

    ===============================================================================
    Choose DBMS type
    ----------------
    
    
    
      ->1- Tibero
        2- Oracle
    
    ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:
       :
  17. The following screen is displayed when Tibero is selected as the repository DB. Enter the connection information of the repository DB used by the AnyLink server.

    ===============================================================================
    Get Tibero JDBC Source
    ----------------------
    
    Enter requested information
    
    Tibero DB NAME (DEFAULT: tibero):
    
    Tibero Port (DEFAULT: 9629):
    
    Tibero DB Server IP (DEFAULT: 127.0.1.1):
    
    Tibero User ID (DEFAULT: tibero):
    
    Tibero PassWord (DEFAULT: tmax):
  18. If a repository DB already exists, select whether to delete it.

    ===============================================================================
    Drop Table
    ----------
    
    Do you want to delete the existing database schema?
    
      ->1- YES
        2- NO
    
    ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE
       DEFAULT:
  19. Determine whether to create a table in the repository DB.

    ===============================================================================
    Create Table
    ------------
    
    Do you want to create a new database schema?
    
      ->1- YES
        2- NO
    
    ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE
       DEFAULT:
  20. View the pre-installation summary. Check each item and then press <ENTER> to start the installation.

    ===============================================================================
    Pre-Installation Summary
    ------------------------
    
    Review the Following Before Continuing:
    
    Product Name:
        AnyLink
    
    Install Folder:
        /home/anylink/jeus7
    
    Link Folder:
        /home/anylink
    
    Install Set
        Domain Admin Server
    
    Disk Space Information (for Installation Target):
        Required:  821,169,125 bytes
        Available: 916,542,095,360 bytes
    
    PRESS <ENTER> TO CONTINUE:
  21. The installation will start, as displayed by the progress bar.

    ===============================================================================
    Installing...
    -------------
    
     [==================|==================|==================|==================]
     [------------------|------------------|------------------|------------------]
  22. The installation completion screen will be displayed when the installation is completed.

    ===============================================================================
    CHECK RUN SQL
    -------------
    
    DB TABLE CREATE SUCCESS!!
    
    PRESS <ENTER> TO CONTINUE:
    
    
    ===============================================================================
    Installation Complete
    ---------------------
    
    AnyLink has been successfully installed to:
    
         /home/anylink/jeus7
    
    PRESS <ENTER> TO EXIT THE INSTALLER:

2. Installation Verification

This section describes how to verify the installation as well as starting the server.

2.1. Directory Structure

The following directory will be created when the AnyLink server is installed.

$AnyLink_HOME/jeus7
   +---- bin
   +---- db_scripts
   +---- dis_config
   +---- domains
   +---- AnyLink-licenses
   |---- lib
         +----anylink
         +----client
         +----datasource
         +----endorsed
         +----etc
         +----jext
         +----licenses
         +----schemas
         +----shared
         +----system
         +----systemapps
         +----thirdparty
   +---- license
   |---- logs
           +---- AnyLink
   +---- nodemanager
   +---- server
bin

Contains the server boot and shutdown scripts startDomainAdminServer, startManagedServer, and stopServer as well as execution files such as the JEUS console tool (jeusadmin).

dis_config

Contains the dis-config.xml file, which has the DIS server’s configuration information.

db_scripts

Contains the DB script files for using AnyLink.

domains

Contains the nodes.xml file, which has the information of nodes used in DOMAIN_HOME and JEUS_HOME for each domain.

AnyLink-licenses

Contains license files of open sources used in AnyLink.

lib

Contains the library used for starting JEUS. Users do not need to access directories other than the shared directory.

license

Contains the JEUS license file. The license file is needed for executing JEUS.

logs

Contains AnyLink log files.

nodemanager

Contains the jeusnm.properties file, which is a configuration file for the JEUS node manager.

server

Contains the files used in the DIS server.

2.2. Server Startup

When all installations have been successfully completed, start the AnyLink server as follows.

  • Start the data integration server (DIS)

    Start the DIS server in the same method as starting the JEUS server’s DAS server.

    $startDomainAdminServer -domain <domain_name> -u administrator -p <password>

    E.g.

    $startDomainAdminServer -domain AnyLink_domain -u administrator -p jeusadmin
  • Start the runtime engine (RTE)

    Start the RTE server in the same method as starting the JEUS server’s MS server.

    $startManagedServer -domain <domain_name> -server <server_name> -u administrator -p <password>

    E.g.

    $startManagedServer -domain AnyLink_domain -server server1 -u administrator -p jeusadmin

3. Uninstallation

The following describes how to uninstall AnyLink in console mode.

  1. Execute $AnyLink_HOME/UninstallerData/Uninstall in the path in which AnyLink is installed.

    [anylink@node UninstallerData]$./Uninstall
  2. The uninstallation will proceed. The Uninstallation Complete screen will be displayed when the uninstallation is completed.

    Preparing CONSOLE Mode Installation...
    
    ===============================================================================
    AnyLink                        (created with InstallAnywhere by Macrovision)
    -------------------------------------------------------------------------------
    
    
    
    
    ===============================================================================
    Uninstall AnyLink
    --------------------
    
    About to uninstall...
    
    AnyLink
    
    This will remove features installed by InstallAnywhere.  It will not remove
    files and folders created after the installation.
    
    PRESS <ENTER> TO CONTINUE:
    
    
    
    ===============================================================================
    Uninstalling...
    ---------------
    
    
    ...*
    *
    *************************
    *************************
    *************************
    ************************
    ...*
    *
    *************************
    *************************
    *************************
    ************************
    ...*
    *
    *************************
    *************************
    *************************
    ************************
    ...*
    *
    *************************
    *************************
    *************************
    ************************
    ...*
    *
    *************************
    *************************
    *************************
    *************************
    
    
    
    ===============================================================================
    Uninstallation Complete
    -----------------------
    
    All items were successfully uninstalled.

4. Uninstallation Verification

Check that the directories and installed files have been deleted in the path where the AnyLink server is installed. Files created after the server is installed are not deleted, so they must be deleted manually.