Release Information

Introduction

Getting Started

Use Cases

Advanced Installation and Configuration

The Landshark Process

Troubleshooting

Enablement

Child pages
  • Quick Start Guide for the Delphix Landshark Environment
Skip to end of metadata
Go to start of metadata

Good to Know!

If you get any errors, or things don't go right: Try rebooting all VM's. Landshark is self-diagnosing and self-healing. Most of the time, it can figure out what went wrong, how to repair it, and resume where it left off. If that doesn't solve it, delete your problem object (dSource or environment), then reboot your VM's and Landshark will put it back for you automatically.

Quick Start for Landshark on VMware

The quick install deploys the following use cases:

  • WebApp 2.0
  • Oracle XE w/Employee & Medical Database

 

Steps 1 - 4

You can watch steps 1-4 in the following video:

VMware Workstation:

VMware Fusion:

 

  1. Download the Landshark and Delphix OVA's
  2. Double-click the OVA's and make adjustments to the settings as part of the import.  Do not power on the VMs until you verify the sub-points below..
    1. Your OVA's should be set to leverage a NAT network (share with my Mac). This setup will work fine for most Landshark applications

    2. If you need to change to a different network type or are importing to ESX, make your network assignments before you boot your machines for the first time to reduce complications
    3. OPTIONAL: If item b applies to you, consider the following two links
      1. Disabling the Discovery Function
      2. Using Static IP Addresses
    4. Add three 8GB thin-provisioned SCSI disks to your Delphix Engine VM. (If you are using DelphixExpress, you already have three disks and can skip this step.)
        1. Right-click your vm in vmware worsktation
        2. Choose settings
           
        3. In the "Virtual Machine Settings" window, click Add
           
        4. If prompted to allow changes, click yes
        5. In the "Add Hardware Wizard", select Hard Disk and click Next
           
        6. Select SCSI, leave Independent unchecked. Click Next
        7. Select Create a new virtual disk, click Next
           
        8. In Maximum disk size, type 8. Leave "Allocate all disk space now" unchecked, click Next
           
        9. Click Finish
           
        10. Repeat steps 3-9 two more times.
        11. Click OK

           
  3. Power on the VM's, if you haven't already done so.
  4. Ensure the console screens of the Linux VM's show an IP address
     
  5. Once the DE fully boots (green screen), validate you Delphix Engine has an IP address. Any valid IP address will do.

    Steps 5 - 15

    You can watch steps 5 -15 in the following video:

  6. Set the system values:  (If you are using DelphixExpress, skip this step.)
      1. Login to the Delphix Engine with the username sysadmin@SYSTEM (case sensitive) (password: sysadmin)
      2. type discard (ignore any errors from this command)
      3. type system/update
      4. type set hostname=DelphixExpress (case-sensitive)
      5. type commit
      6. type exit
      7. The main screen will now show the correct hostname

     

  7. Access the admin portal (http://<Delphix Engine IP>) and login as sysadmin, password sysadmin. You can set the sysadmin password to whatever you like.

  8. You can click "Next" all the way through the setup, changing certain parameters such as "time settings" to suit your preferences.

    Take Heed

    Completing the next step will set the stage for the Landshark process to begin discovery. Any other system changes (Static IPs, Turning on/off of features, etc) should be done prior to this step. Specifically, if you plan to depart from the Quick Install and do other things, such as using the Sybase ASE use case with Landshark, follow the first three steps of the Installation Section of Sybase ASE installation instructions and then reboot LINUXTARGET. Then proceed to the next step.

  9. Once the initial setup is complete, login to the admin portal as delphix_admin, password delphix. Change the password to "landshark" (no quotes, all lowercase). 

  10. Upon changing the delphix_admin password to "landshark", Landshark will begin to discover the entire environment and provision.
  11. The initial setup might take a couple of minutes to begin and will take ~15 minutes to complete.

  12. You can follow along in the logs on the LINUXSOURCE (/home/delphix/landshark_daemon.log) and LINUXTARGET (/home/delphix/landshark_setup.log)
  13. After those installations are complete, Landshark will automatically add the Linux Environments and Groups to the Delphix Engine
  14. Then Landshark will install the WebApp on the Linux VM's and add the WebApp and Oracle XE dSource to the DelphixEngine



  15. As a final step, Landshark will disable all of your dSources automatically so that your Delphix engine isn't growing unnecessarily.
  16. OPTIONAL (VMware only):
    1. ssh into LINUXSOURCE as delphix and execute the following command:
    2. sudo /home/delphix/landshark.shrink
    3. The VM will shutdown when the script is complete. This can take several minutes.
      1. You may see a message indicating "Disk is Full", this is part of the process and is expected.
    4. Repeate with the LINUXTARGET after the LINUXSOURCE is complete.
  17. shutdown the Delphix Engine and Linux VM's (if applicable)
  18. Take a snapshot of your VM's. This is your baseline. Repeat steps 15 through 17 each time you have a new baseline for your VM's (demo-ready), deleting the old snapshot first.

See the Common Faults section for any faults that Delphix may be reporting.

Quick Start for Landshark on VirtualBox

The quick install deploys the following use cases:

  • WebApp 2.0
  • Oracle XE w/Employee & Medical Database

 

Steps 1 - 4

You can watch steps 1-4 (including Setting Up Networking in VirtualBox ) in the following video:

 

  1. Download the Landshark and Delphix OVA's
  2. Double-click the OVA's to import them.
  3. If this is your first implementation of Landshark 2.2, follow the link below to complete the initial setup of networking. After that is complete follow the remaining steps outlined here.
    Setting Up Networking in VirtualBox 
  4. Power on the VM's, if you haven't already done so.
  5. Ensure the console screens of the Linux VM's show an IP address
     

     

    Steps 6 - 22

    You can watch steps 6 - 22 in the following video:

  6. Access the admin portal at http://localhost:8080 and login as sysadmin, password sysadmin. You can set the sysadmin password to whatever you like.

  7. You can click "Next" through the setup, changing certain parameters such as "time settings" to suit your preferences, until you get to the networking screen

  8. When you get to the networking screen, click settings on e1000g1

  9. Click the box next to enable

  10. Click the radio button next to Static

  11. For IP Address, enter 172.16.200.3

  12. For Subnet Mask, enter 255.255.255.0

  13. Click Save

  14. Complete the setup wizard, accepting the remaining defaults.

  15. After setup is complete, you can now access your DE at http://172.16.200.3
  16. Once the initial setup is complete, login to the admin portal as delphix_admin, password delphix. Change the password to "landshark" (no quotes, all lowercase). 

    Take Heed

    Completing the next step will set the stage for the Landshark process to begin discovery. Any other system changes (Turning on/off of features, etc) should be done prior to this step. Specifically, if you plan to depart from the Quick Install and do other things, such as using the Sybase ASE use case with Landshark, follow the first three steps of the Installation Section of Sybase ASE installation instructions and then reboot LINUXTARGET. Then proceed to the next step.

  17. Upon changing the delphix_admin password to "landshark", Landshark will begin to discover the entire environment and provision.
  18. The initial setup might take a couple of minutes to begin and will take ~15 minutes to complete.

  19. You can follow along in the logs on the LINUXSOURCE (/home/delphix/landshark_daemon.log) and LINUXTARGET (/home/delphix/landshark_setup.log)
  20. After those installations are complete, Landshark will automatically add the Linux Environments and Groups to the Delphix Engine
  21. Then Landshark will install the WebApp on the Linux VM's and add the WebApp and Oracle XE dSource to the DelphixEngine



  22. As a final step, Landshark will disable all of your dSources automatically so that your Delphix engine isn't growing unnecessarily.

    See the Common Faults section for any faults that Delphix may be reporting.

Using Static IP Addresses

Disabling the Discovery Function

Common Faults

The setup_level Parameter

Viewing and editing the landshark_properties.xml

Setting Up Networking in VirtualBox

 

Steps 1 - 4

You can watch steps 1-4 in the following vide

  • No labels