Synology NAS Server Group Installation Guide 2008-06-16
States and other countries. Synology Inc. 2008 Synology Inc. All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, mechanical, electronic, photocopying, recording, or otherwise, without prior written permission of Synology Inc., with the following exceptions: Any person is hereby authorized to store documentation on a single computer for personal use only and to print copies of documentation for personal use provided that the documentation contains Synology s copyright notice. The Synology logo is a trademark of Synology Inc. No licenses, express or implied, are granted with respect to any of the technology described in this document. Synology retains all intellectual property rights associated with the technology described in this document. This document is intended to assist application developers to develop applications only for Synology-labeled computers. Every effort has been made to ensure that the information in this document is accurate. Synology is not responsible for typographical errors. Synology Inc. 6F-2, No. 106, Chang-An W. Rd. Taipei 103, Taiwan Synology and the Synology logo are trademarks of Synology Inc., registered in the United States and other countries. Marvell is registered trademarks of Marvell Semiconductor, Inc. or its subsidiaries in the United States and other countries. Other products and company names mentioned herein are trademarks of their respective holders. Even though Synology has reviewed this document, SYNOLOGY MAKES NO WARRANTY OR REPRESENTATION, EITHER EXPRESS OR IMPLIED, WITH RESPECT TO THIS DOCUMENT, ITS QUALITY, ACCURACY, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. AS A RESULT, THIS DOCUMENT IS PROVIDED AS IS, AND YOU, THE READER, ARE ASSUMING THE ENTIRE RISK AS TO ITS QUALITY AND ACCURACY. IN NO EVENT WILL SYNOLOGY BE LIABLE FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES RESULTING FROM ANY DEFECT OR INACCURACY IN THIS DOCUMENT, even if advised of the possibility of such damages. THE WARRANTY AND REMEDIES SET FORTH ABOVE ARE EXCLUSIVE AND IN LIEU OF ALL OTHERS, ORAL OR WRITTEN, EXPRESS OR IMPLIED. No Synology dealer, agent, or employee is authorized to make any modification, extension, or addition to this warranty. Some states do not allow the exclusion or limitation of implied warranties or liability for incidental or consequential damages, so the above limitation or exclusion may not apply to you. This warranty gives you specific legal rights, and you may also have other rights which vary from state to state. Freescale is registered trademarks of Freescale Semiconductor, Inc. or its subsidiaries in the United
Table of Content Introduction to the Synology Group Installation User Guide... 4 Environment Setting... 5 Configure Description... 6 Instructions... 7 How to ensure a successful installation?... 7 Progress... 8 Troubleshooting... 10 Document Revision History...11
Introduction to the Synology Group Installation User Guide The Synology NAS Server is shipped as a bare-bone system; users have to equip hard drive(s) and install the system before they can use the server. However, many Synology resellers equip hard drive(s) and install the system before they sell Synology NAS Servers to end users. Synology has put together this group installation guide in order to help resellers install Synology NAS Servers on a batch basis. With this installation guide, you will learn how to: 1. Prepare the environment for group installation 2. Run the group installation in a proper way
Environment Setting Before using this tool, you must first finish the following. 1. Prepare a Synology Disk Station DS508 (called Controller), and set its IP as 169.254.1.1. 2. Make sure that each Synology NAS Server (called Client) to be installed is connected with the Controller on the same LAN. 3. In order to perform remote operations from a PC, you need to use the COM port on the back panel of the DS508, or use telnet/ssh to access the Controller. This must be done on the same LAN 4. Create a shared folder named public on volume1 in the Controller 5. Create sub-directories for each Client model to be installed in the public shared folder using model-unique as the folder name, such as synology_ppc854x_508. 6. Put the patch file and the configuration file (synogrinst.conf) for each Client into the corresponding sub-directory. The structure is as follows. /volume1/public/synology_powerpc_108j/synology_powerpc_108j_0625.pat /volume1/public/synology_powerpc_108j/synogrinst.conf /volume1/public/synology_88f5281_207+/synology_88f5281_207+_0626.pat /volume1/public/synology_88f5281_207+/synogrinst.conf... 7. Enable NFS service on the Controller, and export the public shared folder via NFS. A. Edit or create the file /etc/exports and add /volume1/public as instructed below: Please follow the red text commands below. The commands in the square brackets [ ] are an indication of keyboard buttons. 1. DS508 > vi /etc/exports [Enter] 2. ~ [Shift+i] 3. ~ /volume1/public [Space] *(rw) 4. ~ [Esc] 5. : wq! B. Execute /usr/syno/etc/rc.d/s83nfsd.sh.sample start For the same Client model, it will use the same patch and configuration file for each execution, thus, make sure the number of installed hard drives in each Client of the same model is the same.
Configure Description The legal key-value pairs in synogrinst.conf are as follows. 1. disk_num [1-*], *depends on model This tool will check for the actual number of HDs detected against this value to avoid bad HDs being used. Please confirm that the count of installed HD in each DS of the same model is the same. 2. dd_alldisks [yes no] It checks for bad sectors on the used disks. If the value is yes, the whole disk will be written before installation, and if bad sectors are found, the bad sector mapping mechanism provided by the hard drive will be triggered. 3. create_raid [yes no] For the models with at least 2 hard drives, if the value is yes, a data volume will be created after installation. 4. set_configured [yes no] If the value is yes, it will set the configuration automatically with default settings and empty an password for admin after installation. 5. version [ex. 0625] This tool will look for the patch with the specified version. There may be several patch files in a directory. The latest version will be used if there is no version specified. Only the key disk_num is required and others are all optional with default values set to no. Example 1: disk_num=1 Example 2: disk_num=4 create_raid= yes set_configured= yes Note: 1. The configure text-file should be in Unix-style. (End line with LF, not CR+LF) 2. You can go to http://www.pspad.com/en/download.php and then download PsPad setup. 3. Install the PsPad program. 4. Enter Example 1 or Example 2.
5. Upon completion of the command input, go to Format->Unix(LF)->File->Save. Instructions NAME synogrinst - Synology group installation tool. SYNOPSIS synogrinst [OPTION] OPTIONS -S Start to do group installation. -q Query progress. -h Show this help. The default option if there is no option specified. 1. Connect to Controller with the COM port or telnet/ssh. 2. Run synogrinst -S and it will list all Clients on the LAN. It will then ask the user to confirm the list. A. If the user answers yes, it will begin to do a group installation. B. Otherwise the program returns. Users could adjust the environment and then run it again. 3. Run synogrinst -q and it will show the installation progress of each Client. 4. During the installation, the status LED will change with the current action, indicating installation, installation success, or installation failed. The LED status description is in the following section. How to ensure a successful installation? The Status LED of Clients will be a static green when the installation is successful. The user can confirm this by querying the progress. If there is any Client without a static green Status LED, there must be something wrong during the installation. Please check the progress and find out the reasons why the installation failed. Status LED Description Static Green Install successfully. Flashing Green Ongoing installation. If other Clients under the same conditions have already finished for a while, this might indicate that there are some problems, such as a crash when running dd or etc. Please check the progress for further information.
Static Orange Installation failed. Please check the progress for further information. Flashing Orange It also means Fail to install if the progress shows FINISH and rebooting... but the LED is flashing orange. Installation has not yet started or the connection has some problems if the progress shows Connecting Progress Run synogrinst -q to show all progresses in the following format MAC-address1 [model-unique] statement MAC-address2 [model-unique] statement MAC-address3 [model-unique] statement The Normal statements include: 1. Connecting... 2. Getting ready to install... 3. DD ing disk_list 4. Creating System Partition 5. Creating Data Volume 6. Copy patch file from server 7. Updating flash: old -> new 8. FINISH and rebooting... The Error statements include: 1. XXX.pat not found 2. Incompatible patch file 3. Patch Version < Flash Version 4. Disk count!= disk_num 5. Failed to DD disks 6. Failed to create system partition
7. Failed to create data volume 8. Failed to mount upgrade volume 9. Failed to copy patch file 10. Bad patch file 11. Failed to update flash 12. Failed to update patch 13. Cannot Downgrade The orange Status LED will light up if there is something wrong. It will indicate which DS is in an error state according to the MAC-address.
Troubleshooting Error Status Description XXX.pat not found Check the path of the patch file. Incompatible patch file Patch does not match. Patch Version < Flash Version Cannot Downgrade Patch version should not be less than flash version. Disk count!= disk_num Check installed disk count or configuration. Failed to DD disks Disk(s) is bad. Replace disks. Failed to copy patch file Network problems or NFS server busy. Bad patch file Checksum error. Please check the completeness of patch file.
Document Revision History This table describes the changes to the Synology NAS Server Group Installation Guide. Date Note 2008-06-16 Document originally released