Go to main content

Oracle® MiniCluster S7-2 Installation Guide

Exit Print View

Updated: October 2021
 
 

Perform Initial Configuration

  1. From compute node 1, type the deployment command to continue the initial configuration process.

    Note -  If the installmc command is not recognized, you might have to type the full path to the deployment command: /var/opt/oracle.minicluster/bin/installmc --deploy
    compute-node-1% installmc --deploy

    The installmc window appears.

             +---------------------------------------------------+
             | Oracle MiniCluster v1.0 :: Initial System Install |
             +---------------------------------------------------+
    
    Ready to setup MiniCluster? (Y/N)(Y): 
  2. Type y to start the initial system configuration.
    • If you copied the userinputs.txt and omcips.txt configuration files to the /var/opt/oracle.minicluster/store directory on compute node 1, then the initial system configuration steps will be performed automatically for you. The information that you entered earlier is displayed.

      If you want to use the existing configuration information, type Y. Go to Step 3.

      If you do not want to use that configuration information, type N. You will be prompted to enter the information manually. Enter the necessary information that you gathered in Preliminary Tasks at the appropriate prompts.

    • If you did not copy the two configuration files to the correct directory on compute node 1, then this message appears:

      [INFO    ]  Configuring Firstnet..
      [INFO    ] userinputs.txt does not exist in /var/opt/oracle.minicluster/store
      [INFO    ] omcips.txt does not exist in /var/opt/oracle.minicluster/store
      Did not find the userinputs.txt or  omcips.txt files in /var/opt/oracle.minicluster/store.  Do you wish to continue and generate the data now ? (Y/N)(N): 

      Type Y to continue the initial system configuration process, and type the necessary information that you gathered in Preliminary Tasks at the appropriate prompts.

      Enter Unique Prefix for this MiniCluster : 
      Enter Netmask in CIDR form (valid range: 8-28) : 
      Enter First IP address in IP addresses range 1 : 
      Enter Count of IP addresses reserved for range 1 : 
      Do you want to input more IP addresses range? Enter Y/N (Y): 
      Enter Default Gateway Address : 
      Enter Domain Name : 
      Enter Comma Separated List of IP Addresses of DNS Servers : 
      Enter Comma Separated List of NTP Servers : 
      [ILOM] Enter Netmask in CIDR form (valid range: 8-31) for ILOM : 
      [ILOM] Enter ILOM IP address of first compute node : 
      [ILOM] Enter ILOM IP address of second compute node : 
      [ILOM] Enter Default Gateway Address for ILOM :
      [ILOM] Enter Comma Separated List of IP Addresses of DNS Servers for ILOM :
      [ILOM] Enter Comma Separated List of NTP Servers for ILOM :
      Type of Cable Used to Connect Network Ports with the 10 GbE Switch: Copper/Fiber : 
      Enter CAN HA type (IPMP/AGGR) : 
      Enter your location 1 :
      Enter your location 2 :
      Enable PCI DSS Compliance: Yes/No (No):
      Enter Security Keystore Type [Choose: pkcs11] :
      VLAN ID is optional. Do you want to input this value? Enter Y/N (N):
      Port VLAN ID is optional. Do you want to input this value? Enter Y/N (N):
      [ILOM] VLAN ID for ILOM is optional. Do you want to input this value? Enter Y/N (N):
      [ILOM] Port VLAN ID for ILOM is optional. Do you want to input this value? Enter Y/N (N):

      An input summary page is generated. Type Y if you are satisfied with the information displayed or N if you want to change the information displayed.

      ---------- Input Summary ----------
      MACHINE_TYPE = S7-2
      OMC_UPREFIX = mc2
      FIRST_PUBLIC_IP = xx.xxx.xx.xx
      IPCOUNT = 50
      GATEWAY = xx.xxx.xx.xx
      NETMASK_CIDR = 22
      DOMAIN_NAME = us.example.com
      DNS_SERVER_LIST = xx.xxx.xx.xx,yy.yyy.yy.yy
      NTP_SERVER_LIST = xx.xxx.xx.xx
      CAN_CABLE_TYPE = COPPER
      FIRST_ILOM_IP = xx.xxx.xx.xx
      SECOND_ILOM_IP = xx.xxx.xx.xx
      ILOM_GATEWAY = xx.xxx.xx.xx
      ILOM_NETMASK_CIDR = 24
      ILOM_DNS_SERVER_LIST = xx.xxx.xx.xx,yy.yyy.yy.yy
      ILOM_NTP_SERVER_LIST = xx.xxx.xx.xx
      CAN_HA = YES
      CAN_HA_TYPE = IPMP
      SS_DISK_COUNT = 6
      TZ = America/Los_Angeles
      PCI_DSS_COMPL = NO
      KEYSTORE_TYPE = pkcs11
      Do you want to change the inputs? Enter Y/N (N):
  3. Verify that the initial system configuration process completes successfully.

    The installmc --deploy command goes through these processes:

    Number
    Step
    1
    Gather user inputs
    2
    Prepare for system install
    3
    Interconnect setup
    4
    Configure explorer
    5
    Check system readiness
    6
    Verify topology
    7
    Prepare network interfaces
    8
    Configure client access network on node 1
    9
    Configure client access network on node 2
    10
    Configure NTP client, set password policy and setup Apache web server
    • Steps 1 through 3 complete automatically.
    • Enter Explorer information at Step 4 in the initial system configuration process.

      Explorer output enables Oracle's engineers to perform assessments of the system by applying the output against knowledge-based rules engine. For more information on Explorer, refer to the following documents:

      [INFO    ] STEP 1: Check Package Version and Gather User Input COMPLETED
      [INFO    ] STEP 2: Prepare for System Install STARTED
      [INFO    ] Invoked by OS user: mcinstall
      ...
      [INFO    ] STEP 2: Prepare for System Install COMPLETED
      [INFO    ] STEP 3: Interconnect Setup STARTED
      ...
      [INFO    ] STEP 3: Interconnect Setup COMPLETED
      [INFO    ] STEP 4: Configure Explorer STARTED
      
      [INFO    ] Log file path : mccn:/var/opt/oracle.minicluster/setup/logs/omc_explorer_062716_143325.log
      [INFO    ] Configuring explorer...
      [INFO    ] Setting up explorer
      
      Absolute path of the Explorer output top location?
      • Provide the standard information for your company at the appropriate prompts.

      • Press Return to accept the default entries at these prompts:

        • Absolute path of the Explorer output top location? [/var/explorer/output]

        • Select the Explorer default transport upload method from this list:

          1) Using Diagnostic Assistant (DA)

          2) Other transport

          3) None

          [Using Diagnostic Assistant (DA)]

        • Do you want to configure Diagnostic Assistant to save credentials (y/n)? [y]

      • Enter a dash (-) at the Solaris zones prompt:

        Solaris zones:

        By default, Explorer collects data from all running local zones when the option -w localzones is specified. If you wish to limit data collection to only some of the local zones, enter the names of those zones below. Separate multiple zone names with a comma ','.

        Comma-separated list of zone names or '-' for all zones []:

      Note that you will not be able to schedule a cron job for Explorer, as shown in the message that appears as part of Step 4 in the initial system configuration process:

      [INFO ] Please do not schedule any cron job to run the Explorer, as cron entries will be removed and not run on the MiniCluster. 
    • Steps 5 through 10 complete automatically.

    Note -  Do not interrupt this process. Wait until you see the message Configuring Firstnet Completed before proceeding. It normally takes 1 to 2 hours to complete these steps.
  4. Verify that the process completed successfully.

    The process has completed successfully when you see the message Configuring Firstnet Completed.

    If the process fails at any point:

    1. Locate the log file that contains information on the point where the failure occurred.

      Usually, the error message provides a pointer to a log file, such as this:

      Log file path : mc2-n1:/var/opt/oracle.minicluster/setup/logs/mcmu_062016_142110.log
    2. Use the information in the log file to determine where the failure occurred and fix the error.

      For example, if the process failed at Step 6 (Verify topology), locate the issue (such as a problem with the cable connections) and fix the issue.


      Note -  You can fix issues related to the hardware connections (such as incorrect cable connections) or issues such as incorrect DNS entries, where you could use the MiniCluster tools to resolve the issue. Do not make any manual modifications outside of the MiniCluster tools. If you are not able to resolve the issue, open a Service Request through My Oracle Support (http://support.oracle.com/).
      • If the error occurred at the last step that was run before the failure occurred, then run the remaining steps starting at that particular step. For example, if the failure occurred at Step 6, and the process stopped at Step 6, then fix the error and run the system setup again starting at Step 6. Go to Step 4.d in this case.

      • If the error occurred at an earlier point but the process didn't stop until a later step, then you must undo the last step and each successfully completed step until you reach the step where the failure occurred. For example, if the failure occurred at Step 6, but the process continued and didn't stop until Step 8, fix the error, then undo Steps 8, 7 and 6, and then run the system setup again starting at Step 6. Go to Step 4.c.

    3. Undo the last step and each step that was successfully completed, including the step where the failure occurred.
      mcmu setupmc -u step-number

      For example, if the failure occurred at Step 6, but the process didn't stop until Step 8, type:

      mcmu setupmc -u 8
      mcmu setupmc -u 7
      mcmu setupmc -u 6
    4. Run the remaining system setup steps.

      Steps 1-10 in the system setup process would normally be run as part of the process. If the process failed at Step 6, then run Steps 6-10.

      To run the remaining steps one a time:

      mcmu setupmc -s step-number

      For example, type:

      mcmu setupmc -s 6

      To run the remaining steps as a range:

      mcmu setupmc -s starting-step-number-ending-step-number

      For example, type:

      mcmu setupmc -s 6-10

      Note -  For more information on performing MCMU CLI procedures, refer to the Oracle MiniCluster S7-2 Administration Guide.
  5. Note the BUI login information in the completed output.

    Successful completion yields output similar to this:

    -----------------------------------------------------------------------------------
    Please download the MiniCluster Component Bundle from Oracle MiniCluster S7-2 Software Download Center (My Oracle Support Doc ID: 2153282.1) and follow the instructions if not done already.
    If you download the Bundle on your local host, transfer files to both MiniCluster nodes by executing step 1 on both nodes
            1.scp <path-on-local-host>/mc-*-sfw.tar.a* mcinstall@<ip-or-host-of-node>:/var/tmp
    
            If you downloaded the Bundle directly on MiniCluster nodes, then make sure both nodes have the Bundle under /var/tmp directory.
    
            Then run these steps -
            2.cd /var/tmp on both the nodes and extract the files using
            3.cat mc-*-sfw.tar.a? | gtar -x -C /var/opt/oracle.minicluster/ -f -
    
        Please use browser user interface (BUI) to complete the system and tenant setup
        URL:
            https://compute-node1-hostname/MCMU -OR- https://compute-node1-IP-address/MCMU
            Administrator login ID: mcinstall. password: ******
    
        If you want to continue using Command Line Interface(CLI) and are currently connected via ILOM,
        login back to the host as mcinstall user, using public hostname or IP Address, then follow these steps -
        1.Register mcinstall user using 'mcmu user --create -u mcinstall -e <email> -n <fullname> -p <phone>' command
        2.Supervisor must check email and register 'mcinstall' user to activate account
        3.Change mcinstall user password using 'mcmu user --changepswd -u mcinstall' command
        4.Continue with setup using 'mcmu setupmc -s all' command
    -----------------------------------------------------------------------------------

    where the compute-node1-hostname and compute-node1-IP-address is the same information that was provided in the IP Hostname Mapping screen or the omcips.txt file that was generated as part of the process in Using the Initial Configuration Tool.


    Note -  In some situations, the core software on your MiniCluster is older and needs to be updated. In that situation, you will see a similar message, telling you to also download the MiniCluster Core Software from the download center. In that case, locate the latest release of the MiniCluster Core Software and install that software using the instructions in the MiniCluster MOS note 2153282.1.
  6. Transfer and install the MiniCluster component bundle onto both compute nodes.

    Go to Transfer and Install the MiniCluster Component Bundle.