﻿<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0">
  <channel>
    <title>VESS R/J Family Articles</title>
    <description>Latest articles happening in the VESS R/J Family category</description>
    <link>https://kb.promise.com</link>
    <item>
      <title>Setting up a serial connection to Vess R3600 and collecting all logs using the Command Line Interface (CLI)</title>
      <description>&lt;p&gt;Here&amp;rsquo;s a structured guide on &lt;strong&gt;setting up a serial connection to Vess R3600&lt;/strong&gt;&amp;nbsp;and &lt;strong&gt;collecting all logs&lt;/strong&gt; using the Command Line Interface (CLI).&lt;/p&gt;&#xD;
&lt;hr&gt;&#xD;
&lt;h3&gt;&lt;strong&gt;1. Hardware Requirements&lt;/strong&gt;&lt;/h3&gt;&#xD;
&lt;ul&gt;&#xD;
&lt;li&gt;&lt;strong&gt;RJ11-to-DB9F cable&lt;/strong&gt; (provided in the accessories box).&lt;/li&gt;&#xD;
&lt;li&gt;&lt;strong&gt;Computer&lt;/strong&gt; (PC, Mac, Linux) with:&#xD;
&lt;ul&gt;&#xD;
&lt;li&gt;&lt;strong&gt;Embedded Serial Port&lt;/strong&gt; or&lt;/li&gt;&#xD;
&lt;li&gt;&lt;strong&gt;USB-to-Serial Adapter&lt;/strong&gt; for computers without serial ports.&lt;/li&gt;&#xD;
&lt;/ul&gt;&#xD;
&lt;/li&gt;&#xD;
&lt;li&gt;&lt;strong&gt;Terminal Emulation Application&lt;/strong&gt; such as:&#xD;
&lt;ul&gt;&#xD;
&lt;li&gt;PuTTY (Windows)&lt;/li&gt;&#xD;
&lt;li&gt;Tera Term (Windows)&lt;/li&gt;&#xD;
&lt;li&gt;Minicom (Linux)&lt;/li&gt;&#xD;
&lt;li&gt;Screen (Mac/Linux).&lt;/li&gt;&#xD;
&lt;/ul&gt;&#xD;
&lt;/li&gt;&#xD;
&lt;/ul&gt;&#xD;
&lt;p&gt;&lt;img src="/content/uploads/df16c4c6-7669-4a16-9ed5-aee500c4f594/292f44bf-8f0e-462e-aa8c-b25600e1c981_rj11cable.jpg" alt=""&gt;&lt;/p&gt;&#xD;
&lt;pre&gt;&lt;strong&gt;Promise RJ11-to-DB9F Cable&lt;/strong&gt;&lt;/pre&gt;&#xD;
&lt;hr&gt;&#xD;
&lt;h3&gt;&lt;strong&gt;2. Connecting the Serial Cable&lt;/strong&gt;&lt;/h3&gt;&#xD;
&lt;ol&gt;&#xD;
&lt;li&gt;Plug the &lt;strong&gt;RJ11 end&lt;/strong&gt; of the cable into the &lt;strong&gt;Vess RAID controller&lt;/strong&gt; (left-hand serial connector).&lt;/li&gt;&#xD;
&lt;/ol&gt;&#xD;
&lt;p&gt;&lt;img src="/content/uploads/df16c4c6-7669-4a16-9ed5-aee500c4f594/5f187cc5-9244-4eee-868b-b25600e35b3e_screenshot-2024-12-30-at-8.47.04 am.jpg" alt=""&gt;&lt;/p&gt;&#xD;
&lt;p&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp;2. Plug the &lt;strong&gt;DB9F end&lt;/strong&gt; into your &lt;strong&gt;computer&amp;rsquo;s serial port&lt;/strong&gt; or &lt;strong&gt;USB-to-Serial adapter&lt;/strong&gt;.&lt;/p&gt;&#xD;
&lt;p&gt;&lt;img src="/content/uploads/df16c4c6-7669-4a16-9ed5-aee500c4f594/83e9a08a-7a19-4dbb-8507-b25600e45f00_usbserialadapter.jpg" alt=""&gt;&lt;/p&gt;&#xD;
&lt;pre&gt;&lt;strong&gt;USB-Serial Adapter&lt;/strong&gt;&lt;/pre&gt;&#xD;
&lt;h3&gt;&lt;strong&gt;&lt;img src="/content/uploads/df16c4c6-7669-4a16-9ed5-aee500c4f594/ac387c60-92d6-4f2c-b5eb-b25600e4964c_computerserialport.jpg" alt=""&gt;&lt;/strong&gt;&lt;/h3&gt;&#xD;
&lt;pre&gt;&lt;strong&gt;Computer Serial Port&lt;/strong&gt;&lt;/pre&gt;&#xD;
&lt;hr&gt;&#xD;
&lt;h3&gt;&lt;strong&gt;3. Configuring the Terminal Emulator&lt;/strong&gt;&lt;/h3&gt;&#xD;
&lt;ol&gt;&#xD;
&lt;li&gt;Launch your terminal application.&lt;/li&gt;&#xD;
&lt;li&gt;Locate and select the appropriate &lt;strong&gt;COM port&lt;/strong&gt; assigned to your serial connection. (For USB adapters, check your device manager to identify the assigned COM port).&lt;/li&gt;&#xD;
&lt;li&gt;Set the following serial communication settings:&#xD;
&lt;ul&gt;&#xD;
&lt;li&gt;&lt;strong&gt;Baud Rate&lt;/strong&gt;: 115200&lt;/li&gt;&#xD;
&lt;li&gt;&lt;strong&gt;Data Bits&lt;/strong&gt;: 8 bits&lt;/li&gt;&#xD;
&lt;li&gt;&lt;strong&gt;Parity&lt;/strong&gt;: None&lt;/li&gt;&#xD;
&lt;li&gt;&lt;strong&gt;Stop Bits&lt;/strong&gt;: 1&lt;/li&gt;&#xD;
&lt;li&gt;&lt;strong&gt;Flow Control&lt;/strong&gt;: None&lt;/li&gt;&#xD;
&lt;/ul&gt;&#xD;
&lt;/li&gt;&#xD;
&lt;li&gt;Open the connection.&lt;/li&gt;&#xD;
&lt;li&gt;Press &lt;strong&gt;Enter&lt;/strong&gt; or &lt;strong&gt;Return&lt;/strong&gt;&amp;mdash;you should see a &lt;strong&gt;login prompt&lt;/strong&gt;.&lt;/li&gt;&#xD;
&lt;/ol&gt;&#xD;
&lt;hr&gt;&#xD;
&lt;h3&gt;&lt;strong&gt;4. Logging in to CLI&lt;/strong&gt;&lt;/h3&gt;&#xD;
&lt;ol&gt;&#xD;
&lt;li&gt;Enter your &lt;strong&gt;username&lt;/strong&gt; and &lt;strong&gt;password&lt;/strong&gt;.(Note:&amp;nbsp;The default user name is &lt;strong&gt;administrator&lt;/strong&gt;.The default password is &lt;strong&gt;password&lt;/strong&gt;)&lt;/li&gt;&#xD;
&lt;li&gt;You will be greeted with the CLI prompt:&#xD;
&lt;pre&gt;&lt;code&gt;administrator@cli&#xD;
&lt;/code&gt;&lt;/pre&gt;&#xD;
&lt;/li&gt;&#xD;
&lt;/ol&gt;&#xD;
&lt;hr&gt;&#xD;
&lt;h3&gt;&lt;strong&gt;5. Collecting Log Data&lt;/strong&gt;&lt;/h3&gt;&#xD;
&lt;p&gt;&lt;strong&gt;Enable session logging&lt;/strong&gt; (if supported by the terminal application) or manually copy outputs into a text file.&lt;/p&gt;&#xD;
&lt;p&gt;Run the following commands one by one and save the outputs:&lt;/p&gt;&#xD;
&lt;ol&gt;&#xD;
&lt;li&gt;&#xD;
&lt;p&gt;&lt;strong&gt;System Information&lt;/strong&gt;&lt;/p&gt;&#xD;
&lt;pre&gt;&lt;code&gt;subsys -v&#xD;
ctrl -v&#xD;
enclosure -v&#xD;
battery -v&#xD;
net -v&#xD;
&lt;/code&gt;&lt;/pre&gt;&#xD;
&lt;/li&gt;&#xD;
&lt;li&gt;&#xD;
&lt;p&gt;&lt;strong&gt;Background Activities&lt;/strong&gt;&lt;/p&gt;&#xD;
&lt;pre&gt;&lt;code&gt;bga&#xD;
&lt;/code&gt;&lt;/pre&gt;&#xD;
&lt;/li&gt;&#xD;
&lt;li&gt;&#xD;
&lt;p&gt;&lt;strong&gt;Fibre Channel Information&lt;/strong&gt;&lt;/p&gt;&#xD;
&lt;pre&gt;&lt;code&gt;fc -v&#xD;
fc -a list -t device&#xD;
fc -a list -t initiator&#xD;
&lt;/code&gt;&lt;/pre&gt;&#xD;
&lt;/li&gt;&#xD;
&lt;li&gt;&#xD;
&lt;p&gt;&lt;strong&gt;Physical Drives&lt;/strong&gt;&lt;/p&gt;&#xD;
&lt;pre&gt;&lt;code&gt;phydrv&#xD;
phydrv -v&#xD;
&lt;/code&gt;&lt;/pre&gt;&#xD;
&lt;/li&gt;&#xD;
&lt;li&gt;&#xD;
&lt;p&gt;&lt;strong&gt;Array Information&lt;/strong&gt;&lt;/p&gt;&#xD;
&lt;pre&gt;&lt;code&gt;array&#xD;
array -v&#xD;
&lt;/code&gt;&lt;/pre&gt;&#xD;
&lt;/li&gt;&#xD;
&lt;li&gt;&#xD;
&lt;p&gt;&lt;strong&gt;Logical Drive Details&lt;/strong&gt;&lt;/p&gt;&#xD;
&lt;pre&gt;&lt;code&gt;logdrv&#xD;
logdrv -v&#xD;
&lt;/code&gt;&lt;/pre&gt;&#xD;
&lt;/li&gt;&#xD;
&lt;li&gt;&#xD;
&lt;p&gt;&lt;strong&gt;LUN Mapping&lt;/strong&gt;&lt;/p&gt;&#xD;
&lt;pre&gt;&lt;code&gt;lunmap&#xD;
&lt;/code&gt;&lt;/pre&gt;&#xD;
&lt;/li&gt;&#xD;
&lt;li&gt;&#xD;
&lt;p&gt;&lt;strong&gt;Event Logs&lt;/strong&gt;&lt;/p&gt;&#xD;
&lt;pre&gt;&lt;code&gt;event&#xD;
event -l nvram&#xD;
&lt;/code&gt;&lt;/pre&gt;&#xD;
&lt;p&gt;&lt;em&gt;(Note: Last command has a lowercase 'L', not number '1').&lt;/em&gt;&lt;/p&gt;&#xD;
&lt;/li&gt;&#xD;
&lt;/ol&gt;&#xD;
&lt;hr&gt;&#xD;
&lt;h3&gt;&lt;strong&gt;6. Saving Logs&lt;/strong&gt;&lt;/h3&gt;&#xD;
&lt;ul&gt;&#xD;
&lt;li&gt;&lt;strong&gt;Enable Log Capture&lt;/strong&gt; in the terminal emulator to save logs directly to a file.&lt;/li&gt;&#xD;
&lt;li&gt;Or, &lt;strong&gt;copy-paste&lt;/strong&gt; the session output into a text document.&lt;/li&gt;&#xD;
&lt;/ul&gt;&#xD;
&lt;hr&gt;&#xD;
&lt;h3&gt;&lt;strong&gt;7. Provide Logs to Support&lt;/strong&gt;&lt;/h3&gt;&#xD;
&lt;p&gt;Send the saved log file to the &lt;strong&gt;Promise Technical Support Team&lt;/strong&gt; as part of your support request.&lt;/p&gt;&#xD;
&lt;p&gt;&lt;strong&gt;Start Support Request Online&lt;/strong&gt;:&lt;/p&gt;&#xD;
&lt;ul&gt;&#xD;
&lt;li&gt;Visit &lt;a href="https://support.promise.com/" target="_blank" rel="noreferrer, noopener"&gt;Promise Technology Support&lt;/a&gt; to create a support case.&lt;/li&gt;&#xD;
&lt;/ul&gt;&#xD;
&lt;hr&gt;&#xD;
&lt;h3&gt;&lt;strong&gt;Additional Notes&lt;/strong&gt;&lt;/h3&gt;&#xD;
&lt;ul&gt;&#xD;
&lt;li&gt;&lt;strong&gt;Custom Cable Requirements&lt;/strong&gt;:&lt;br&gt; If building your own cable, refer to the &lt;strong&gt;serial pinout diagram&lt;/strong&gt;&amp;nbsp;below or attached in this article&lt;/li&gt;&#xD;
&lt;/ul&gt;&#xD;
&lt;p&gt;&lt;img src="/content/uploads/df16c4c6-7669-4a16-9ed5-aee500c4f594/70416226-011f-4506-be43-b25600e25d70_20241227192221db9torj11.jpg" alt=""&gt;&lt;/p&gt;&#xD;
&lt;ul&gt;&#xD;
&lt;li&gt;&lt;strong&gt;Network Unavailability&lt;/strong&gt;:&lt;br&gt; Serial access is a reliable fallback if network access is down.&lt;/li&gt;&#xD;
&lt;li&gt;&lt;strong&gt;Permissions&lt;/strong&gt;:&lt;br&gt; Ensure you have administrator-level access to the RAID system for complete log collection.&lt;/li&gt;&#xD;
&lt;/ul&gt;&#xD;
&lt;p&gt;This process ensures you can securely gather logs for troubleshooting even without network access.&lt;/p&gt;</description>
      <pubDate>2024-12-30T13:45:33.9970000</pubDate>
      <link>https://kb.promise.com/thread/setting-up-a-serial-connection-to-a-vess-system-and-collecting-all-logs-using-the-command-line-interface-cli/</link>
    </item>
  </channel>
</rss>