============================================================================== Portlock Storage Manager Portlock Software www.portlock.com ============================================================================== Copyright (c) 2000-2007 Portlock Software. All rights reserved. ============================================================================== Release notes for Portlock Storage Manager ============================================================================== CONTENTS 1. What's New in Release 4.01. 2. Overview. 3. Installation and Removal. 4. Known Issues. 5. Command Line Options. 6. Software Updates. 7. Reporting problems to us. 8. Additional Information and Support. ============================================================================== 1. What's New in Release 4.01 This section has been moved to the file history.txt ============================================================================== 2. Overview Portlock Storage Manager is a comprehensive tool for managing storage on Linux, NetWare and Windows systems. The following versions of Novell Open Enterprise Server are supported: - Open Enterprise Server Linux - Open Enterprise Server NetWare The following versions of Novell NetWare are supported: - Novell NetWare 5.0 to 5.0 SP6a and Small Business versions - Novell NetWare 5.1 to 5.1 SP8 and Small Business versions - Novell NetWare 6.0 to 6.0 SP5 and Small Business versions - Novell NetWare 6.5 to 6.5 SP6 and Small Business versions - NetWare 4.20 SP9 **** Note: NetWare 3.x is no longer supported. Use version 3.36. **** Note: NetWare 4.11 is no longer supported. Use version 3.36. **** Note: NetWare 4.20 SP8 and prior are no longer supported. Use version 3.36. **** Note: NetWare 5.0 to 5.0 SP3 NSS Volumes are not supported. Supported Diagnostic Partition features include: - Copy Compaq, Dell and IBM Diagnostic partitions. - Delete Compaq, Dell and IBM Diagnostic partitions. - Image and Restore Compaq, Dell and IBM Diagnostic partitions. Supported DOS Partition features include: - Copy DOS FAT16 partitions. - Delete DOS FAT12 and FAT16 partitions. - Create DOS FAT16 partitions in either MS-DOS or DR-DOS format. - Hide DOS FAT12 and FAT16 partitions. - Image and Restore DOS FAT12 and FAT16 partitions. - Unhide DOS FAT12 and FAT16 partitions. Supported Novell NetWare partition features: - Copy NetWare partitions. - Create NetWare partitions. - Delete NetWare partitions. - Hide NetWare partitions. - Move NetWare partitions. - Resize NetWare partitions. - Unhide NetWare partitions. - Upgrade NW 3 and NW 4 partitions to the new NW 5 format. Supported Novell NetWare volume features include: - Image and Restore NetWare volumes. - Copy, clone and resize NetWare volumes. - Single-segment volumes. - Multi-segment volumes. - Mirrored partitions. - NetWare Partition Hotfix. - Block Suballocation. - Compression. - DOS, LONG, MAC, NFS Name Spaces. - DSK Device Drivers. - HAM (NWPA) Device Drivers. Supported Novell NSS partition features: - Create NSS partitions. - Delete NSS partitions. - Hide NSS partitions. - Resize NSS type 1 (Non-Storage Group) partitions. - Resize NSS type 2 (Storage Group) partitions. - Image and Restore NSS partitions. - Unhide NSS partitions. Supported Novell NSS volume features include: - Copy, clone and resize NSS Type 1 volumes. - Copy, and clone NSS Type 2 volumes. - Copy an NSS Non-Storage Group volume to a Storage Group volume. - Copy an NSS Storage Group volume to a Non-Storage Group volume. - Image and Restore NSS volumes. NetWare Multipath Support: - NetWare Multipath Support is support for NetWare 6.5 with the following software: EMC Powerpath NetWare 6.5 Software Multipath - Note: NetWare Multipath is only supported when executing under NetWare. Unsupported Features: - Volumes with Data Migration enabled. - FTAM Name Space. Video Monitors - Storage Manger does not support monochrome monitors. Color VGA mode is required for both the video adapter and the monitor. ============================================================================== 3. Installation and Removal. ------------------------------------------------------------------------------ Installation for NetWare: This software is packaged as a zip file. Create a temporary directory on your system and unzip the files. This software does not require an installation before use. However, there are three supported installation methods: 1) Installation using INSTALL.NLM (NW 3 & 4) or NWCONFIG.NLM (NW 5 & 6). Copy the files either to a floppy diskette or to a temporary directory on your server. Using INSTALL.NLM or NWCONFIG.NLM select "Product Options". Then select "Install a product not listed". Specify the directory that has STORMGR.IPS. For example you created a temporary directory called SYS:/TEMP In NWCONFIG specify the directory SYS:/TEMP 2) Create the directory SYS:/STORMGR. Copy the files to the SYS:/STORMGR directory on your server. The software can also be copied to any directory on your server. 3) Installation using PINSTALL.NLM. From the server console type: "load a:pinstall.nlm" if the files are on a floppy diskette, or "load /pinstall.nlm" if the files are on a directory on the server. The default installation directory is SYS:/STORMGR. To execute the software type: "load sys:/stormgr/stormgr" at the server console. See the command line options section below. To remove the software, use INSTALL.NLM (NW 4) or NWCONFIG.NLM (NW 5 * 6). Select "Product Options". Then select "View/Configure/Remove installed products". Then select STORMGR and press delete. To uninstall for NetWare 3, you will need to manually delete the directory and its contents SYS:/STORMGR. ============================================================================== 4. Known Issues Refer to history.txt for specific details. This version does have the following limitations (by design): - Volumes with FTAM Name Space are not supported. - Volumes with Data Migration enabled are not supported. - The software supports a maximum of 128 logical disk drives per server. Note that a RAID-5 array appears as one logical disk drive to NetWare. - The software supports a maximum of 256 NetWare partitions per server. ============================================================================== 5. Command Line Options This version supports a number of command line options that can be used to modify the behavior of the software. Command Syntax: stormgr [options] The following are valid command line options: -help Display the help screen. All other options will be ignored. -cmd=filename This options specifies a file to be processed for commands. This option turns on Storage Manager Scripting. This option is not currently available. This is a special command for Novell's NetWare 6 Evaluation CD. -compression Enables Image Compression. Default level = 5. -compression=[1-10] Enables Image Compression specifying the level. -dvd Enable support for CD/DVD writers (default). -nodvd Disable support for CD/DVD writers. -ignore=[1-128] Ignore the specified disk drive. This is commonly used on Fibre Channel SANs that have multiple paths to the same device. Using this switch causes Storage Manager to ignore the disk drive. -logfile=filename This option creates a file on either a NetWare volume or a file located on the DOS partition to store status and error information from Storage Manager. -luns DOS only. By default, Portlock Storage Manager will scan LUN 0 - 7 on each target ID. This flag will cause Storage Manager to scan for luns 0 thru 7. -memtest (DOS only) This option will cause Storage Manager to report how much memory could be allocated when running under DOS. By adding or removing himem.sys the best memory allocation strategy can be found. -nodefrag After a resize is complete, do not defragment the directory tables. Resizing a volume normally involves moving the FAT and directory tables. The directory tables are then fragmented after a resize. The software will then defragment the directory tables after a resize to improve volume performance. -noluns DOS only. By default, Portlock Storage Manager will scan LUN 0 - 7 on each target ID. This flag will cause Storage Manager to scan for lun 0 only. -nwio The software supports using either the older NetWare NWIO (DSK) I/O subsystem interface and the newer NWPA (HAM) interface. This command line option specifies to use the older NWIO (DSK) interface. Note: This option is not available on NetWare 5.x or 6.x servers. -nwpa The software supports using either the older NetWare NWIO (DSK) I/O subsystem interface and the newer NWPA (HAM) interface. This command line option specifies to use the newer NWPA (HAM) interface. Note: This option is not available on NetWare 3.x servers unless the NWPA update package has been installed. This is the only interface available for NetWare 5.x and 6.x servers. -os=version This option sets the version of NetWare that Storage Manager emulates when running under DOS. Valid versions are 3, 4, 5, 6 and 65. To have Storage Manager display a prompt for the version use "-os=x" -port= This option changes the TCP/IP Port number used for TCP/IP communications. By default, Storage Manager uses port 19000. Both the sending and receiving processes must use the same port number. -verbose This option increases the amount of information placed into the logfile. For some types of operations, the information will be extensive creating logfiles of hundreds of megabytes. This option is sometimes needed for technical support. Do not enable this option unless requested by technical support. -smtp=mail_server_name This option specifies the name of the SMTP server to use for the license renewal or purchase command. This name can be a system name (mail.portlock.com) or an IP address. -smtp_user=user_name This option is used when an email server requires user authentication. The user_name must be a valid user name that the SMTP server supports. If this option is used, then the -smtp and -smtp_pass options must also be used. -smtp_pass=password This option is used when an email server requires user authentication. The pasword must be a valid password that the SMTP server supports. If this option is used, then the -smtp and -smtp_user options must also be used. **************************************** Scripting Features: **************************************** We have added several command line options to automate scripting. 1) You want to image your workstation or server to an FTP server. stormgr -script -os=6 -imageall -imageftp=192.168.1.10,anonymous,user@test.com,imgfile.img 2) You have mapped a drive letter from DOS using either the Novell Client or the Microsoft Client. You want to image your workstation or server to this mapped drive letter. stormgr -script -os=6 -imageall -imagefile=g:imgfile.img -purge 3) You want to image your NetWare 6.5 server using Online Imaging to an FTP server. The temporary snapshot data will use the pool TEST_POOL. stormgr -script -online -snapshot=test_pool -imageall -imageftp=192.168.1.10,anonymous,user@test.com,imgfile.img 4) You want to image your NetWare server to the first tape drive using Variable length blocks (volumes will be dismounted). stormgr -script -imageall -imagetape=0 -variable 5) You want to image your NetWare 6.5 server to the first tape drive using Variable length blocks (volumes will be imaged online). stormgr -script -online -snapshot=test_pool -imageall -imagetape=0 -variable Details: -script Turn on scripting. -os=6 Set the version for NetWare emulation (3, 4, 5, 6 or 65) For Windows workstations set to 6 -compression Enables Image Compression. Default level = 5. -compression=N Enables Image Compression. N = 1 - 10. -imageall Image all disk drives and all partitions / volumes -imageftp=ip_address,ftp_user,ftp_password,filename -imagefile=filename -imagetape=device where device numbers start with 0 -tape_fixed Use Fixed length records when writing to tapes. -tape_variable Use Variable length records when writing to tapes. -purge Purge a volume before imaging it. For NSS volumes, the volume must be mounted. If an NSS volume is not mounted then the volume will not be purged. Traditional volumes can be purged mounted or not mounted (scripting only). -purge will be ignored with -online. -nopurge Do not purge a volume before imaging (scripting only). -online Use Online Imaging for NSS Pools (NetWare 6.5 SP3 & above). The default is to use Offline Imaging. You must also specify the command line option -snapshot=pool_name. -snapshot=pool_name This specifies the name of the pool to be used to store temporary snapshot data. This pool will not be imaged during an online image. The default name is "SNAPSHOT". -image_pool=pool_name image only the pool named pool_name. Note: -image_pool can be used up to sixteen times. -skip_pool=pool_name Do not image the pool named pool_name or any of its volumes. Note: -skip_pool can be used up to sixteen times. -iscsi Add iSCSI Partitions as Virtual Disks. The partitions in iSCSI Partitions can then be managed just like any other disk drive. -noiscsi Ignore iSCSI Partitions. -NoCheckPartitionIDs Disable checking for Duplicate Partiition IDs. ============================================================================== 6. Software Updates Portlock Storage Manager supports updating itself over the Internet. The update feature will connect to our web server and retrieve a file that lists the latest files. We use the HTTP "GET" command for all software downloads. An error message will sometimes occur about not being able to resolve the address www.portlock.com. This is fixed by loading the Novell NLM netdb.nlm which provides the DNS name resolution that Storage Manager needs. As a fallback we have hard coded the IP address of our web server into Storage Manager. ============================================================================== 7. Reporting problems to us. Portlock Software is very interested in any comments regarding Storage Manager. Many features in the current product are the result of customers letting us know what they need. When reporting a problem to us, use the command line option -logfile to help us identify the problem. stormgr -logfile=filename Also, make sure that you are using the latest version of Storage Manager. We will ask you to upgrade to the latest version before providing support. Check the history.txt file to see if your issue has already been addressed. ============================================================================== 8. Additional Information and Support. Please visit our web site to obtain addition documents on Novell NetWare and Storage Manager: www.portlock.com/documents/index.htm. For technical support send email to: support@portlock.com. For technical support visit our support news server at: news://support-forums.portlocksoftware.com/portlock.support.storage-manager For sales support send email to: sales@portlock.com. ============================================================================== End of Document