HELIOS Base UB2 User manual (Version 3.0.0)  
 

4 The Base product

In the following descriptions, instructions, and examples, the expression “HELIOSDIR” is used for the directory path where the HELIOS software is installed. This could, for example, be the default installation path “/usr/local/helios”. The actual HELIOS installation path can be traced by entering the command:

$ cat /etc/HELIOSInstallPath
Previously installed versions of EtherShare or PCShare

The former default installation paths “/usr/local/es” and “/usr/local/pcshare” respectively, can easily be migrated to the new default path “/usr/local/helios” by means of the HELIOS Installer (see 4.3.1 “Migrate settings”).

4.1 Software installation

The following list gives details about the hardware and software you need for making the HELIOS Base software successfully work.

4.1.1 Network requirements

4.1.2 Server requirements

4.1.3 Additional requirements on Windows

4.1.4 General remarks

About this chapter

This chapter describes the steps that are indispensable for a standard installation, and gives short explanations where necessary. All steps are marked by an arrow (hsymInstruction) to the left. For a quick installation, you may proceed directly from one instruction to the other, and skip the explanations in between.

Firewalls

All installed firewalls must be turned off for the initial HELIOS installation (see 5.10 “Windows firewall problems”).

Machine ID USB-dongle

For Mac OS X, Linux and Windows machines, the machine ID is provided by a USB-dongle, which you have received from your HELIOS dealer. 3-hour demo mode and demo keys work without a USB-dongle (see What you have to do in “Welcome to HELIOS Base” and HELIOS USB driver for Windows below).

Machine ID in virtual machines

When installing the HELIOS software on virtual machines no USB-dongle is required to generate the machine ID (see 4.1.10 “Software installation (Virtual machines)”).

References to HELIOS CDs

References to “CD017 or earlier” mean EtherShare 2.6, PCShare 3.0, EtherShare OPI 2.1, PDF HandShake 2.0, and PrintPreview 1.1 or earlier.

References to “4th generation” mean EtherShare 3.1, PCShare 3.1, WebShare 1.0, ImageServer 2.5, PDF HandShake 2.1 and PrintPreview 2.0. These versions were available on HELIOS CD018, CD019, and CD020.

References to “HELIOS UB” mean EtherShare 4.0, PCShare 4.0, WebShare 1.2, ImageServer 3.0, PDF HandShake 3.0 and PrintPreview 3.0. These versions were available on HELIOS CD021 and CD022.

References to “HELIOS UB+” mean EtherShare 4.5, PCShare 4.5, WebShare 2, ImageServer 3.5, PDF HandShake 3.5 and PrintPreview 3.5. These versions were available on HELIOS CD023 and CD024

HELIOS UB2 is available on CD025. This manual covers the HELIOS software versions as of CD025, including EtherShare 5.0, PCShare 5.0, WebShare 3.0, ImageServer 4.0, PDF HandShake 4.0, and PrintPreview 4.0.

The server installation program(s)

The installation is carried out by two separate programs. The first program (“installer”) must be started from the installation media. It lets you select the product(s) you wish to install and copies all related files and the installation program to the local disk of your host. The “backend” installer then automatically completes the installation.

Updates

HELIOS issues software updates every now and then to enhance the product. These updates are distributed via the HELIOS website (www.helios.de/updates), and they are included on every HELIOS CD. The installation procedure for software updates is described in 18 “The HELIOS Update Installer”.

4.1.5 Preparing the installation

Note:

For installing the HELIOS software, you must be able to log in as “root” (“Administrator” on Windows) on your host.

Have your activation key at hand

You can install the HELIOS software without a software activation key (kind of password).

In case you have no activation key at hand, please follow the instructions given in the paragraphs License information and What you have to do in “Welcome to HELIOS Base” at the beginning of this manual.

Under certain conditions, HELIOS issues so-called demo licenses. If you are entitled to get a demo license, you will receive an activation key for demonstration purposes that expires after a given period of time.

Preparing the host

The host must be provided with a fully installed and configured operating system. You must be able to log in as user “root” (“Administrator” on Windows) to allow the installation program to create subdirectories and make the required system changes.

Important:

Before starting the installation, you should create a backup copy of the system disk of your host computer!

Upgrading from earlier HELIOS CDs

Those who upgrade from an earlier product version, e.g. CD016, install as described in 4.1.7 “Software installation”, 4.3 “Migrating from earlier versions (CD017 or earlier) to UB2”, and 4.2 “Upgrading product generations”.

4.1.6 Navigating within the HELIOS Installer

Key shortcuts

HELIOS Installer is a server program and does not support mouse operation. It is designed to be fully operable with the keys available on a standard “vt100”-keyboard. You can highlight menu items either by:

hsymTabKey TAB (or Ctrl+I)

In screens with several input fields, you can skip to the next field by means of the TAB key.

Shift+TAB

In screens with several input fields, you can skip to the previous field with “Shift+TAB”.

BACKSPACE (or Ctrl+H)

In lists, the BACKSPACE key deletes the selected entry. In text fields, it deletes the character to the left of the cursor and moves all other text one position to the left in order to fill the gap.

Note:

If BACKSPACE (on some special terminals/keyboards) does not work, try DEL instead.

hsymDeleteNextKey DEL

The DEL key deletes the character under the cursor and moves all other text one position to the left to fill the gap. DEL is not always available on a UNIX terminal keyboard.

hsymHomeKey Home (or Ctrl+A)

The cursor is moved to the start of the current Field or the first line of the list.

hsymEndKey End (or Ctrl+E)

The cursor is moved to the end of the current field or the last line of the list.

hsymPageUpKey PgUp (or Ctrl+P)

The cursor is moved to the previous page of a multiple-page list.

hsymPageDownKey PgDown (or Ctrl+N)

The cursor is moved to the next page of a multiple-page list.

hsymArrowNKey CsrUp (or Ctrl+K)

The cursor is moved up one line.

hsymArrowSKey CsrDown (or Ctrl+J)

The cursor is moved down one line.

hsymArrowWKey CsrLeft (or Ctrl+H)

The cursor is moved left one character.

hsymArrowEKey CsrRight (or Ctrl+L)

The cursor is moved right one character.

hsymEscapeKey Esc (or Ctrl+X)

The currently selected function is aborted and the program goes back to the previous prompt or action.

hsymReturnKey Return

The current input or selection is accepted.

Insert (or Ctrl+V)

The cursor is moved right one character.

Ctrl+R

Refresh the screen display. Sometimes needed for terminals.

4.1.7 Software installation

Note:

If you plan to install the HELIOS Software on a Mac OS X platform, skip ahead to 4.1.8 “Software installation (Mac OS X)”.

If you plan to install the HELIOS Software on a Windows platform, skip ahead to 4.1.9 “Software installation (Windows)”.

Upgrading from versions on CD017 or before

Before installing and migrating the new product versions, all previous HELIOS products must be stopped and deactivated in order to prevent the old product versions from being loaded instead of the new ones (Note that running the “uninstall” script is only required for versions before CD017):

# cd /usr/local/es 
# etc/uninstall 
# cd /usr/local/pcshare 
# etc/uninstall

The installation and migration can be done by installing the new versions without removing the previous versions. If you are upgrading from versions prior to EtherShare 3.1, PCShare 3.1, etc., please install the new versions in a different directory, e.g. “/usr/local/helios”.

First time and upgrade installations

You are guided through the installation by a menu-driven program, the HELIOS Installer. HELIOS Installer does nearly everything on its own. You merely have to start the installation.

Note:

The following installation example describes the steps that must be taken on an IBM RS/6000 computer under AIX. Slight deviations may occur – depending on your system type and configuration.

hsymInstruction

To start the installation, log in as “root” on your host.

hsymInstruction

Place the media in the drive of your host computer and enter the mount and install commands which may be different for different host systems.

The appropriate commands for your specific computer are stated in the booklet we have enclosed with our installation media.

Example:
 (IBM/RS 6000 computer running AIX)
# mount -r -v cdrfs /dev/cd0 /cdrom 
# cd /cdrom 
# ./installer

As soon as you have entered the last command, you are asked to choose the operating language of the installer. After having selected the desired language the “Introduction”, “Welcome to HELIOS”, and “License Information” windows of the “HELIOS Installer” window appear.

hsymInstruction

If you agree to the terms and conditions select Agree. If you do not agree select Disagree; the HELIOS software installation will then be aborted.

The HELIOS Installer main menu

Fig. 4.1: The HELIOS Installer main menu

Note:

The bottom of the “HELIOS Installer” window provides helpful details and instructions.

The default installation path of the HELIOS software is “/usr/local/helios”. However, if you want to use – for whatever reason – a different path you must first specify it in the HELIOS Installer.

hsymInstruction

Select Setup from the main menu (Fig. 4.1) and specify the desired path. Then confirm your changes with Ok, else select Cancel.

Note:

The HELIOS Installer creates an installation log file in the “/tmp” directory (“helios.installer.log”) which records all actions and steps that have been taken during the installation or migration process.

hsymInstruction

Select Install HELIOS Products from the main menu and press RETURN.

HELIOS Installation

The Installable Products section shows all available HELIOS software products. HELIOS software products already installed on the server are listed in the Already Installed section. Otherwise this section is missing (Fig. 4.2 and Fig. 4.3).

Note:

The HELIOS products Base and Base Data are always required for the installation of any other HELIOS product, e.g. EtherShare, PCShare, etc.

“Install HELIOS Products” dialog

Fig. 4.2: “Install HELIOS Products” dialog

“Install HELIOS Products” dialog

Fig. 4.3: “Install HELIOS Products” dialog

hsymInstruction

In the Installable Products section highlight the product you wish to install and press the space bar, so it becomes marked. To deselect one (or more) item(s) in the list, press the space bar again.

The example in Fig. 4.2 shows that Base (with Base Data) and EtherShare are already installed, and PCShare is about to be installed. Fig. 4.3 shows a “fresh” installation of Base (with Base Data), EtherShare and PCShare, where no HELIOS product software was installed before.

Important:

Starting the installation will stop all HELIOS services running on the server. Therefore, please make sure all HELIOS users are logged-out before you install new products. To verify the HELIOS user status you may use the “swho” command (8.7 “swho”) or HELIOS Admin (Lists > Active Users).

hsymInstruction

After you have marked all products you wish to install confirm with Ok.

The “Installation successfully completed” window shows the status of the installation (Fig. 4.4).

“Installation successfully completed” window

Fig. 4.4: “Installation successfully completed” window

hsymInstruction

Leave the installation menu with Esc or Ctrl-X (see also 4.1.6 “Navigating within the HELIOS Installer”) to get back to the main menu. You can now quit the HELIOS Installer.

The HELIOS Installer has now installed all the specified applications and related updates from the HELIOS CD. You should now check if there are subsequent updates available for download and installation. See 18 “The HELIOS Update Installer” for complete details.

See 17 “Uninstalling the HELIOS software” for instructions on how to remove the HELIOS software from the server.

If this is an upgrade installation, from CD017 or earlier, you can now migrate your settings from the previous versions. To do so, skip ahead to 4.3 “Migrating from earlier versions (CD017 or earlier) to UB2”.

Otherwise, your next step is to enter the HELIOS software license(s) for the installed product(s). Find instructions on how to do that by skipping ahead to 4.4 “Licenses”.

4.1.8 Software installation (Mac OS X)

In order to install the HELIOS software on a Mac OS X platform, do the following:

hsymInstruction

Insert the HELIOS CD in the Mac OS X computer and double-click the “HELIOS Network Installer” CD icon, which appears on the desktop.

hsymInstruction

In the “HELIOS Network Installer” window double-click the “mac-os-x” folder.

hsymInstruction

Start the installation by double-clicking the “HELIOS Installer” icon.

The “Welcome to the HELIOS Installer” dialog opens (Fig. 4.5).

“Welcome to the HELIOS Installer” dialog

Fig. 4.5: “Welcome to the HELIOS Installer” dialog

hsymInstruction

Then click on the padlock symbol in order to authenticate with administrative rights to make changes (Fig. 4.6).

If you have administrative rights on the machine you can use your name and password in the authentication dialog.

The HELIOS Installer authentication dialog

Fig. 4.6: The HELIOS Installer authentication dialog

The Introduction dialog (Fig. 4.7) gives an overview of the installable HELIOS products and their main features.

hsymInstruction

Make sure that the Please select pull-down menu shows the entry Installation, and click Continue to proceed.

The HELIOS Installer “Introduction” dialog

Fig. 4.7: The HELIOS Installer “Introduction” dialog

The “License Agreement” is displayed (Fig. 4.8).

hsymInstruction

Read the content carefully and click Continue.

hsymInstruction

If you agree to the terms and conditions click Agree. If you do not agree click Disagree; the installation of the HELIOS software will then be aborted.

hsymInstruction

In the “Destination for HELIOS Products” dialog (Fig. 4.9) enter the path to the location where you want to install the HELIOS products or click Choose, which brings up the Mac File Selector. Then click Continue.

The HELIOS Installer “License Agreement”

Fig. 4.8: The HELIOS Installer “License Agreement”

“Destination for HELIOS Products” dialog

Fig. 4.9: “Destination for HELIOS Products” dialog

“Install HELIOS Products” dialog

Fig. 4.10: “Install HELIOS Products” dialog

The Installable Products section shows all available HELIOS software products. If there are already HELIOS software products installed on the server they are listed in the Already Installed section. Otherwise this section is empty (Fig. 4.10 and Fig. 4.11).

“Install HELIOS Products” dialog

Fig. 4.11: “Install HELIOS Products” dialog

hsymInstruction

In the Installable Products section click the checkbox of the product you wish to install (see Fig. 4.10).

The example shows that Base (with Base Data) and EtherShare are already installed, and PCShare is about to be installed. Fig. 4.11 shows a “fresh” installation of Base (with Base Data), EtherShare and PCShare, where no HELIOS product software was installed before.

Important:

Starting the installation will stop all HELIOS services running on the server. Therefore, please make sure all HELIOS users are logged-out before you install new products. To verify the HELIOS user status, you can use the “swho” command described in 8.7 “swho” or use HELIOS Admin (Lists > Active Users).

hsymInstruction

After you have marked all products that you want to install confirm with Install.

The “Status” window (Fig. 4.12) informs you about the progress of the HELIOS software installation. As soon as the installation is finished, the software is started so the services are available immediately.

hsymInstruction

Enter the HELIOS software license(s) for the installed product(s) according to 4.4 “Licenses”.

The HELIOS Installer “Status” dialog

Fig. 4.12: The HELIOS Installer “Status” dialog

4.1.9 Software installation (Windows)

Available products

The HELIOS products EtherShare UB2 and PCShare UB2 are not available for Windows.

PCShare UB2
  • Every Windows version already includes SMB/CIFS

  • PCShare SMB/CIFS printing is included in HELIOS Base for Windows

EtherShare UB2
  • HELIOS AFP server is not available, Windows Server SFM (Services for Macintosh) is supported

  • Windows 2003 Server AppleTalk is supported

  • EtherShare features included in HELIOS Base:
    Print spooler: PAP & TCP/IP printer drivers, …
    Tools: “atechoping”, “poll”, “LanTest”, …

WebShare UB2, ImageServer UB2, PDF HandShake UB2, and PrintPreview UB2 are available for Windows.

Installation path

The default HELIOS installation path on Windows used in the examples in this manual is “C:\​Program Files\​Helios”.

HELIOS USB driver for Windows

A USB-dongle provides the machine ID on Windows computers. When the dongle is plugged in for the first time, a driver must be installed. You will find the driver on the HELIOS media, in the “windows\​usbdriver” directory.

hsymInstruction

Plug the HELIOS USB-dongle into a free USB port on the Windows computer.

Windows will recognize it as a new hardware component and open the “Found New Hardware Wizard” program (Fig. 4.13).

“Found New Hardware Wizard”

Fig. 4.13: “Found New Hardware Wizard”

hsymInstruction

Select the No, not this time radio button because you want Windows to search for the driver on the HELIOS CD. Continue with Next >.

hsymInstruction

Place the HELIOS CD into the CD-ROM drive of your Windows computer, select the Install from a list or specific location (Advanced) radio button and click Next > (Fig. 4.14).

Installation mode

Fig. 4.14: Installation mode

hsymInstruction

Click Browse to to the correct installation search path <CD_drive>:\​windows\​usbdriver and continue with Next > (Fig. 4.15).

USB driver installation search path

Fig. 4.15: USB driver installation search path

The Wizard shows that the installation has been completed.

hsymInstruction

If the “Windows Device Manager” (Device Manager in the Hardware tab in Control Panel > System) lists the entry HELIOS MachID USB Devices the installation of the USB driver was successful (Fig. 4.16).

Windows “Device Manager”

Fig. 4.16: Windows “Device Manager”

Installation
hsymInstruction

Insert the HELIOS CD into the CD-ROM drive of your Windows computer and start the installation by double-clicking the “HELIOS Installer.exe” icon in the “windows” subfolder.

The “HELIOS Installer” window opens.

hsymInstruction

Click Continue.

The introductory dialog gives an overview of the installable HELIOS products and their main features.

hsymInstruction

Make sure that Installation is selected on the pull-down menu and click Continue to proceed.

The “License Agreement” is displayed.

hsymInstruction

Read the content carefully and – if you agree to the terms and conditions – activate the Accept License radio button and click Continue.

Note:

The “license” file is also available on the HELIOS CD.

hsymInstruction

If you do not agree, leave the Do Not Accept License radio button as is and close the window. The installation of the HELIOS software will then be aborted.

hsymInstruction

To specify a different location where you wish to install the HELIOS products (Fig. 4.17) click Custom..., which brings up the Windows file selector. Then click Continue.

Select destination folder

Fig. 4.17: Select destination folder

The Installable Products section shows all available HELIOS software products. If there are already HELIOS software products installed on the server they are listed in the Already Installed: section. Otherwise this section is empty (Fig. 4.18 and Fig. 4.19).

Select products to install (clean install)

Fig. 4.18: Select products to install (clean install)

Select products to install (update install)

Fig. 4.19: Select products to install (update install)

hsymInstruction

In the Installable Products section click the checkbox for the product you wish to install (see Fig. 4.19).

Fig. 4.18 shows a “fresh” installation of Base (with Base Data) and ImageServer, where no HELIOS product software was installed before. Fig. 4.19 shows that Base (with Base Data) is already installed, and ImageServer is about to be installed.

Important:

Starting the installation will stop all HELIOS services running on the server. Therefore, please make sure that all HELIOS users log off before you install new products. To verify the HELIOS user status you can use the “swho” command or use HELIOS Admin (Lists > Active Users).

hsymInstruction

After you have selected the desired products for installation, click the Install button.

The status window (Fig. 4.20) shows the progress of the HELIOS software installation. As soon as the installation is finished, the software is started so the services are immediately available.

Installation status

Fig. 4.20: Installation status

After the installation, an installation log file is written to the user’s temp directory:
Documents and Settings\​<user>\​Local Settings\​Temp\​helios.installer.log.

It contains the information from the “HELIOS Installer” window (Fig. 4.20).

Configuration

Upon installation, the HELIOS programs are automatically started. They are generally administered via the HELIOS Admin application.

hsymInstruction

To run HELIOS Admin directly on the server, navigate to the “Helios\​public\​Windows” directory, and double-click on “HELIOS Admin.exe” (requires Java SE runtime 1.4.2 or newer).

hsymInstruction

To run HELIOS Admin remotely from a client, it is necessary to share the Helios\​public directory. Navigate to the “Helios” directory, and right-click on the “public” directory. Select Sharing and Security..., and the Sharing tab. Click Share this folder, and (if desired) change the Share name to something descriptive, e.g. “HELIOS_Apps”. See 5.7 “Windows shares & HELIOS volumes” for additional details.

Network clients can now mount that volume via SMB, or, if the Windows server is running SFM (Services for Macintosh), via AFP. However connected, Mac clients can find “HELIOS Admin.app” in the “MacOS” folder, and Windows clients will find “HELIOS Admin.exe” in the “Windows” folder of the volume. Other clients can use the “HELIOS Admin.jar” application in the “Java” folder. Simply double-click the respective HELIOS Admin icon. Alternatively, you can copy the application to your local hard disk.

For a complete reference to HELIOS Admin, refer to 7 “HELIOS Admin”.

4.1.10 Software installation (Virtual machines)

Software installation works as described in the chapters for the installation on UNIX and Windows. However, only certain virtual machine solutions (VMs) are supported.

Host OS Guest OS
IBM PowerVM IBM AIX 5.3, AIX 6
Microsoft Hyper-V Server Windows Server 2003/​2008, Linux, Solaris
VMware ESX Server Windows Server 2003/​2008, Linux, Solaris

Table 4.1: Currently supported virtualization solutions

For a HELIOS installation in a virtual machine, no USB-dongle is required.

The HELIOS machine ID is based on the network hardware address and VM-specific information.

For up-to-date information on supported and tested VM solutions, see the HELIOS website www.helios.de/virtualization.

4.2 Upgrading product generations

4.2.1 Upgrading from UB+ to UB2

When upgrading from HELIOS UB+ generation products to the UB2 products, all settings are preserved. However, since AD/PDC authentication has changed, it will take some manual configuration. For details see Migrating HELIOS UB+ to UB2 on the HELIOS website.

4.2.2 Upgrading from UB+ CD023 to CD024

A mixed operation of CD023 and CD024 installation is not possible. So all products must be installed from CD023 or all products must be installed from CD024. See also Migrating the HELIOS UB+CD023 to CD024 on the HELIOS website.

4.2.3 Upgrading from UB generation products to UB+

When upgrading from HELIOS UB generation products to the UB+ products, all settings are preserved. A rebuild will automatically be done for all volumes to re-index the SQL desktop database. For details see 13.1.1 “The new SQL desktop database” and Migrating HELIOS UB to UB+ on the HELIOS website.

4.2.4 Upgrading from 4th generation products to UB

When upgrading from HELIOS 4th generation products to the UB products, all settings are preserved. See also Migrating HELIOS 4th generation to UB on the HELIOS website.

Users of HELIOS 4th generation or later can skip the next chapter and continue reading with 4.4 “Licenses”.

4.3 Migrating from earlier versions (CD017 or earlier) to UB2

This section is applicable to sites upgrading from these or earlier versions: EtherShare 2.6, PCShare 3.0, EtherShare OPI 2.1, PDF HandShake 2.0, and PrintPreview 1.1 (see References to HELIOS CDs in 4.1.4 “General remarks”).

4.3.1 Migrate settings

The format to store server settings was changed beginning with the 4th generation version. There is only one preferences file for all HELIOS products. You can convert your configuration files (e.g. “atalk.conf”) from a previous version.

hsymInstruction

Select Migrate Settings from the HELIOS Installer.

Note:

Keep in mind that you must have installed the new product before you can migrate. You may also need to adjust the migrated settings manually.

hsymInstruction

Verify that the paths are correct and select the settings to migrate. Then select Ok and quit the HELIOS Installer (Fig. 4.21).

“Migrate Settings” dialog

Fig. 4.21: “Migrate Settings” dialog

Important:

If you are migrating settings from just one product, EtherShare or PCShare, you must erase the other path entry in the respective field (Fig. 4.21)! Otherwise, you will receive an error message.

The Migrate Settings feature calls the HELIOS utility “migrate”, which is described in 8.4 “migrate”.

hsymInstruction

Now enter the following command to adopt the migrated settings:

# cd /usr/local/helios 
# bin/start-helios -i

4.3.2 Previous (CD017 and earlier) and new version settings

The following comparison shows where the various software settings used to be set in previous versions (left column), and where they are set in the new version (right column). See References to HELIOS CDs in 4.1.4 “General remarks”.

EtherShare & PCShare volumes
…/conf/afpvolumes …var/conf/Preferences
…/conf/exports …var/conf/Preferences
EtherShare printers
/etc/printcap …var/conf/printcap
…/PPD & font list …var/spool/qmeta
…/lpr interface files …var/spool/qmeta
…/conf/atalk.conf …var/conf/Preferences
AppleTalk network interface settings

All AppleTalk network interfaces are migrated into the preferences file. The interfaces are stored with the same syntax (e.g.: if=..., nif=...), but in the form of a string list in the preferences file. The settings can be verified by issuing the “prefdump” command, or by using HELIOS Admin to view the “Versions” file. The interface settings are stored in:

[Programs][atalkd][if] = active interfaces 
[Programs][atalkd][nif] = inactive interfaces

To configure the network interfaces use the “netconf” program, which is described in the HELIOS EtherShare manual (note that Mac OS X uses its own network interface configuration program instead of “netconf”).

PCShare printers

As all new printer queues can be administered via HELIOS Admin and new output options are available, we have decided not to migrate PCShare printers to the new preferences storage. Shared printers can be published for PCShare with a single click in HELIOS Admin. Other printer queues must be created using HELIOS Admin.

Only old DOS printer queues using the PCShare DOS “printsrv” must be configured using PCShare Admin.

Passwords
…/conf/afppasswd …var/conf/passwd
DHCP
…/conf/ethers.pcs …var/conf/ethers.pcs
IP access lists
…/conf/ipaccess …var/conf/ipaccess
OPI settings
…/conf/Preferences …var/conf/Preferences
Home directories

Please note that home directories are turned on by default. Home volume settings can be configured by use of HELIOS Admin. For a conversion between different character sets on home volumes refer to the utility script “converthome” in the HELIOS EtherShare manual.

OPI & PDF HandShake server settings

OPI & PDF HandShake server settings are not migrated, please set them manually in HELIOS Admin (Settings > PDF HandShake Settings and ImageServer Settings).

PCShare WINS and Browsing

These settings are migrated.

4.3.3 Switching back to the old versions (up to CD017 and earlier)

As all old configuration files will stay unchanged in the system it is possible to switch back to the previous versions anytime (see References to HELIOS CDs in 4.1.4 “General remarks”).

hsymInstruction

Deactivate the new HELIOS product version by taking the following steps:

# cd /usr/local/helios 
# bin/stop-helios now 
# sbin/uninstall -unconfigure 
# cd /usr/local/es 
# ./install
hsymInstruction

In the “EtherShare Installation Menu” take the steps

1) Install programs and configuration files and
2) Install and configure AppleTalk kernel modules.

Then quit the “EtherShare Installation Menu”.

Likewise, if you also have PCShare installed:

# cd /usr/local/pcshare 
# ./install
hsymInstruction

In the “PCShare Installation Menu” take only step

1) Install programs and configuration files.

Then quit the “PCShare Installation Menu”.

Note:

All changes and modifications applied to the new versions are not migrated back into the previous product versions.

4.3.4 Switching back to the new versions

After the new version is installed and running, the old version can remain on the server for the purpose of switching back to the previous versions.

hsymInstruction

To prevent the old versions from loading during a system boot, deactivate the old product versions as start scripts, and start the HELIOS services again:

# cd /usr/local/es 
# etc/uninstall 
# cd /usr/local/pcshare 
# etc/uninstall 
# cd /usr/local/helios 
# bin/start-helios -i

4.3.5 Migrating a second time

If you have used the previous version or the migration failed it is possible to start the migration again. Every time you do a migration the old version settings will override the new version settings.

4.3.6 Removing the old versions completely

# cd /usr/local/es 
# etc/uninstall 
# cd .. 
# rm -rf es 
# cd /usr/local/pcshare 
# etc/uninstall 
# cd .. 
# rm -rf pcshare 
# cd /usr/local/helios 
# bin/start-helios -i

The font lists and PPD of all old spool queues can be removed because the new ones are in “HELIOSDIR/var/spool/qmeta”.

After all existing ICC profiles have been copied into the “HELIOSDIR/var/​ICC-Profiles” volume, the old “ICC-Profiles” volume can be removed.

4.4 Licenses

Note:

For instructions on how to enter HELIOS software licenses on a Mac OS X platform read 4.4.3 “Entering a new license (Mac OS X)”.

4.4.1 Entering a new license

After you have installed a HELIOS software product on the server you must license the program in order to make it work.

hsymInstruction

On the command line of the host machine log in as “root” and enter:

# cd /usr/local/helios 
# bin/license

The “License a HELIOS Product” dialog appears (Fig. 4.22).

hsymInstruction

In the Licensed Products section select …New Entry and press RETURN (Fig. 4.23).

“License a HELIOS Product” dialog

Fig. 4.22: “License a HELIOS Product” dialog

“License a HELIOS Product” dialog

Fig. 4.23: “License a HELIOS Product” dialog

In our example, we license the PCShare software which was installed in HELIOS Installation above in this chapter.

hsymInstruction

In the “PCShare Base License” dialog window (Fig. 4.24) enter the serial number of the product, the number of users (i.e. the type of license you purchased with the software product) and the checksum which you get from the “Activation Key Reply” form. Then confirm with Ok.

Note:

What you have to do in “Welcome to HELIOS Base” shows you step-by-step how to receive the “Activation Key Reply” form with the required keys.

hsymInstruction

To leave the “License a HELIOS Product” dialog navigate to Ok and press RETURN. Otherwise the changes you have applied to the server will not take effect.

The HELIOS application must now be stopped and restarted for the new license to take effect. See 4.5 “Starting/stopping HELIOS services manually”.

“License a HELIOS Product” dialog

Fig. 4.24: “License a HELIOS Product” dialog

4.4.2 Removing a HELIOS license from the server

An already existing HELIOS license cannot be edited. In such cases it must be removed and then replaced by another. To remove a HELIOS software license do the following:

hsymInstruction

In the “License a HELIOS Product” dialog highlight the software license you want to remove and press BACKSPACE or Ctrl+H (see 4.1.6 “Navigating within the HELIOS Installer”).

hsymInstruction

To leave the “License a HELIOS Product” dialog navigate to Ok and press RETURN. Otherwise the changes you have applied to the server will not take effect.

4.4.3 Entering a new license (Mac OS X)

HELIOS Services is a GUI application designed for entering HELIOS software licenses, and for easily starting and stopping HELIOS processes.

hsymInstruction

Double-click the “HELIOS Services” icon in the “Applications” folder and select the Licenses tab within the “HELIOS Services” window (Fig. 4.25).

The field Machine ID shows the machine ID of the USB-dongle connected to your Mac. In the other field all HELIOS product licenses are displayed, with Product name, Serial Number, and Expiration Date (note that the entry in the Expiration Date column remains empty if you are running the software with a full license).

“HELIOS Services” – View License

Fig. 4.25: “HELIOS Services” – View License

hsymInstruction

Click View License File... to see the complete license file (Fig. 4.26).

This may be convenient if you wish to view and extract serial numbers etc. with “copy and paste”.

hsymInstruction

Click Add License ... to add a new HELIOS product license.

“HELIOS Services” – View License

Fig. 4.26: “HELIOS Services” – View License

“HELIOS Services” – Add License

Fig. 4.27: “HELIOS Services” – Add License

An extra dialog window opens (Fig. 4.27) which lets you choose the desired product from the pull-down menu Product, and lets you enter the serial number (Serial), the number of Units, and the Checksum. As mentioned before, if you are running a full license of the HELIOS products, leave the Expires field empty. Otherwise, the expiration date of the demo or subscription license must be entered in the Expires field as well.

Note:

All HELIOS products are licensed for use on a single computer system (“server”), which has a unique machine identification (“HELIOS MachID”) which is provided by a HELIOS USB dongle. The software can only once be licensed for a given USB dongle (MachID). Compare Fig. 4.25 and Fig. 4.26.

HELIOS services must be stopped and restarted for the new license to take effect. See 4.5 “Starting/stopping HELIOS services manually”.

4.4.4 License conditions (Windows)

Note:

This chapter is about the HELIOS licensing conditions only. Microsoft’s licensing conditions for their server and client solutions must be obtained separately. For instructions on how to enter HELIOS software licenses read the chapter 4.4.1 “Entering a new license”.

HELIOS Base for Windows includes the HELIOS Advanced Print Server and provides the foundation for all HELIOS products. Except for WebShare, all HELIOS products on Windows require a HELIOS Base license.

User expansions can be added to HELIOS Base for Windows and are valid for HELIOS Base and all add-on products (ImageServer, PDF HandShake and PrintPreview). The user licenses are based on different users per day, the same as on all HELIOS server platforms. License details are described in the file “license.txt” on the HELIOS CD.

Supported example product combinations:

Advanced Print Server
Advanced Prepress Server
PDF Workflow Server
Image Conversion Server
WebShare File Server

A WebShare standalone server without any add-on product does not need a HELIOS Base license. Additional add-ons like ImageServer require a HELIOS Base for Windows license.

Dedicated WebShare Webserver
Note:

WebShare has its own user licenses. Additional WebShare users can be added with user expansions licensed for the WebShare product.

WebShare Document Preview and Proofing Server
Summary

Supported software installation and license requirements for HELIOS products on Windows:

HELIOS Base UB2
must be installed
HELIOS Base UB2
license is required
(must be purchased)
WebShare File Server hsymCheckMark
WebShare Webserver hsymCheckMark
ImageServer UB2 hsymCheckMark hsymCheckMark
PDF HandShake UB2 hsymCheckMark hsymCheckMark
PrintPreview UB2 hsymCheckMark hsymCheckMark

HELIOS Base for Windows is required for all HELIOS products.

WebShare can be used stand-alone but additional add-on products always require a HELIOS Base for Windows license.

HELIOS Base for Windows user expansions are valid for Base and all add-on products (ImageServer, PDF HandShake, PrintPreview). WebShare user expansions are independent of Base for Windows user expansions.

4.5 Starting/stopping HELIOS services manually

For instructions on how to start and stop HELIOS services on Mac OS X skip to 4.5.1 “Start/Stop (Mac OS X)” below.

For instructions on how to start and stop HELIOS services on Windows, see 5.1.3 “Starting and stopping the HELIOS software”.

Sometimes it may become necessary to start or stop HELIOS services on the server manually, e.g. after installing updates via the HELIOS Update Installer (see also 18 “The HELIOS Update Installer”):

hsymInstruction

On the command line of the host machine log in as “root” and enter:

# cd /usr/local/helios 
# bin/start-helios
hsymInstruction

To stop all HELIOS processes on the server enter:

# cd /usr/local/helios 
# bin/stop-helios now
Important:

Before issuing the “stop-helios” command make sure that all clients are logged-out (e.g. with the “swho” command, see 8.7 “swho”).

4.5.1 Start/Stop (Mac OS X)

“HELIOS Services” is a Mac OS X GUI application designed for entering HELIOS software licenses, and for easily starting and stopping HELIOS processes.

hsymInstruction

Double-click the “HELIOS Services” icon in the “Applications” folder.

The “HELIOS Services” window appears providing information on the HELIOS products status when you click Status.

Starting the HELIOS services

In order to start the HELIOS software do the following:

hsymInstruction

Click the lock icon (Fig. 4.28) to authenticate. After the authentication, the Start button will become available.

“HELIOS Services” – Click the lock

Fig. 4.28: “HELIOS Services” – Click the lock

hsymInstruction

Click the Start button within the “HELIOS Services” window.

The Messages box shows the information that the HELIOS services are being started. When all available services are running, the display shows Done..

A click on the Status button then reveals a listing of all HELIOS processes (Fig. 4.29) and gives information about their name (Service), their Status, their process ID number (PID), date and time of starting (When), and – if a process has been started more than once – the number of Restarts.

“HELIOS Services” – View process status

Fig. 4.29: “HELIOS Services” – View process status

Stopping the HELIOS services

All HELIOS services on Mac OS X must be stopped:

hsymInstruction

Click Stop within the Status tab window.

HELIOS Services has a feature that lets you specify a shutdown message and the time span to shutdown (Fig. 4.30).

“HELIOS Services” – Specifying shutdown options

Fig. 4.30: “HELIOS Services” – Specifying shutdown options

hsymInstruction

Specify the shutdown message in the Shutdown message text box. In the Time to shutdown (minutes) field enter the time after which the services should be stopped (to make the services stop immediately, enter “0”).

The Messages box then displays the information that the HELIOS services are being stopped (Fig. 4.31).

“HELIOS Services” – Stopping services

Fig. 4.31: “HELIOS Services” – Stopping services

4.6 HELIOS TCP/IP security overview

HELIOS server applications allow very precise, easy to administer control of access to their services. For example, access to volumes can be limited to members of specific groups (if you are not a member of an authorized group, the volume will not even be listed), and a password can be required to mount the volume. Printers can also be password-protected. HELIOS Admin recognizes four levels of authorization, to allow appropriate delegation of administrative capabilities.

4.6.1 Password security

HELIOS programs use encrypted passwords, so that no cleartext passwords are sent over the network during the login procedure. This feature is called Encrypted Password Transport.

For more information, see 10.1 “The authentication server program”.

4.6.2 Set passwords

During the installation of the HELIOS software on UNIX, the user “demouser” is created. The HELIOS password for both “root” and “demouser” are set to empty. This means a significant lack of security (anybody can log on to the server as user “root” without needing to know the password), and so you should specify a password for “root”.

Important:

For your own security, provide your user accounts with passwords to prevent them from unauthorized access and abuse!

Note:

If this is an upgrade from an installation that utilized HELIOS encrypted passwords, and those settings were migrated to the new version, then normally no further action is needed.

hsymInstruction

Launch HELIOS Admin (see 7.2 “Start HELIOS Admin”) and select Login from the HELIOS Admin File menu. In the User Name field enter “root” and leave the Password field empty.

hsymInstruction

Open the Users tab, select the “root” entry from the list and double-click it.

HELIOS Admin – User configuration window

Fig. 4.32: HELIOS Admin – User configuration window

hsymInstruction

In the User configuration window for “root” (Fig. 4.32) specify a password for “root” in the Password field and click Save.

HELIOS Admin will ask you to enter the new password again. This ensures that no typing mistakes have been made. After clicking OK the password will be assigned to user “root”.

hsymInstruction

Then set passwords for all other existing users or add new users (passwords defined in HELIOS Admin also update the user’s system password).

Note:

On a Mac OS X machine, the “root” login is disabled by default. Once a “root” password is specified with HELIOS Admin, it is enabled automatically. Also note that if a password is modified via host system tools, our additional password file is not changed. Therefore it makes more sense to administer users with HELIOS Admin or by using the HELIOS utility program “authutil” (see 10.2 “authutil”).

4.6.3 IP access control list

HELIOS offers additional access control by means of IP access lists, based upon the user’s IP address. The default installation creates a single IP access list, that specifies which IP addresses are allowed access to HELIOS resources (volumes, home directories, printers) and services (HELIOS Admin).

All of the above settings are easily configured by means of HELIOS Admin, which allows easy GUI-based server administration from any client on the network. Once the HELIOS software is installed, HELIOS Admin should be used to configure these security options.

Finer IP-based access control can be specified for individual HELIOS resources. For example, each volume can have its own IP access list. This allows certain volumes to be accessible only from within the local network, while others can be made available to remote offices or customers. Or the System Administrator can be authorized to access HELIOS Admin from home. The default IP access list is called ipaccess, and is described in 6.8 “HELIOSDIR/var/conf”. To create a resource-specific IP access list, create an “ipaccess” file (see 7.8.6 “IP Access”) with the desired access settings for that resource, and use either HELIOS Admin or the “prefvalue” command to associate it with the appropriate volume, etc. For reference, upon installation, a second access list is created, ipaccess.local, which contains the settings that will allow access only to users on the local network.

Occurence Chapter
ipaccess “AFP server preference keys” (see EtherShare manual)
ipaccess “PCShare preference” (see PCShare manual)
ipaccess 19.12 “HELIOS Admin server preference keys”
IPAccess 19.1 “Volume preference keys”
ipaccess 15.7 “LPD”
ipaccess.local 6.8 “HELIOSDIR/var/conf”
ipaccess “papsrv” (see EtherShare manual)

Table 4.2: Overview of IP access preferences and their description

4.6.4 Firewall ports

If your server is protected by a firewall, then access from network clients to HELIOS server services (volumes, printers, Admin, etc.) will be blocked by the firewall, until ports for the respective services are opened in the firewall.

For example, on a Mac OS X based HELIOS server, these ports need to be open:

137       UDP PCShare Browsing 
138       UDP PCShare NetBIOS 
139       TCP PCShare SMB/CIFS 
445       TCP PCShare SMB/CIFS 
2005      TCP Create PDF Server (Distiller) 
2006      TCP HELIOS Admin 
2007      TCP EtherShare print spooler (papsrv) 
2009      TCP WebShare Webserver 
2010-2015 TCP WebShare File Server
2026      TCP Server mDNS proxy server registrations
5353      UDP Server mDNS Server (“Bonjour”) Port 

You will not need any other ports open, unless you enable other HELIOS services (e.g. DHCP server, Remote LPR).

A complete overview about TCP server and client ports used by the HELIOS software is given in C.7 “TCP ports used by HELIOS”.

4.7 After the installation – What now?

hsymInstruction

Read the manuals of the HELIOS software products you have installed.

Check the product specific README files which contain the latest information and updates that did not make it into the manuals. They are available in:

We recommend that you subscribe to the HELIOS Newsletter, and to HELIOS Tech Infos to be alerted about updates and new features.
www.helios.de/contact.html

hsymInstruction

To configure the network interfaces use – if necessary – the “netconf” program, which is described in the EtherShare manual (Mac OS X uses its own network interface configuration program).

Note:

If EtherShare is installed, and the server has more than one network interface, then AppleTalk routing is automatically configured. If you need to change the configuration, refer to the EtherShare manual for instructions on the “netconf” utility (recommended). Alternatively, see chapter 8.13 “prefvalue” to set the “atalkd” preferences (see “AppleTalk preference keys” in the HELIOS EtherShare manual).

hsymInstruction

Verify that all HELIOS services are running:

# cd /usr/local/helios
# bin/srvutil status

On Mac OS X, run the HELIOS Services application (Fig. 4.29).

hsymInstruction

Check the system messages file for any HELIOS startup messages. See 7.5.9 “System messages”.

Note:

HELIOS LanTest can be used to test network server volume and local hard disk performance. LanTest can be found in “HELIOS_APPS” (Windows) and “HELIOS Applications” (Mac).

hsymInstruction

Verify that user passwords have been set (see 4.6.2 “Set passwords”).

hsymInstruction

Set up users, groups, volumes, printers, ipaccess, etc. We recommend to do this with HELIOS Admin (see 7 “HELIOS Admin”).

4.8 Migration to other platforms

Note:

This chapter only refers to migrating software as of HELIOS CD018 or newer (i.e. EtherShare 3.1, PCShare 3.1, WebShare 1.0, ImageServer 2.5, PDF HandShake 2.1 and PrintPreview 2.0 or newer).

All installed HELIOS products and settings can be transferred to a new platform by installing the HELIOS products from the installation media and moving the HELIOS “var” folder to the new platform. All server settings including volumes and printers are transferred to the new platform and are automatically used on the new system. All volumes and printer spool directories will then be re-created on the new platform when start-helios -i is executed.

Example:

The HELIOS software on Sun Solaris is subject to be transferred to a Linux platform:

hsymInstruction

Install the HELIOS software from CD on the new platform (in this example Linux).

hsymInstruction

Then enter the command stop-helios on the new (Linux) platform.

hsymInstruction

Enter the command stop-helios on the old (here Sun Solaris) platform. Copy the complete “HELIOSDIR/var” directory, which contains all volumes and printer settings, from the old platform to the new platform (Linux).

In doing so the “HELIOSDIR/var” directory on the Linux platform will be replaced with the “HELIOSDIR/var” directory of the Sun Solaris platform.

hsymInstruction

On the new (Linux) platform, enter the command:

start-helios -i

All existing server settings from the Sun Solaris platform are now available on the Linux platform.

Note:

Users, groups and volume content are NOT migrated. Please set users and groups manually in HELIOS Admin (Lists > Users and Lists > Groups), and copy the volume content from the old to the new platform.

4.9 Back up HELIOS settings

It is prudent to save the “HELIOSDIR/var” directory to CD at regular intervals, so that if a prior setting needs to be recovered or if the server goes down and you want to quickly migrate settings to a different server, it will be easy to do so. Tape backups are often not readily accessible for such purposes.

4.9.1 Automatic backup of the configuration

The configuration in “var/conf” and “var/spool/qmeta” is automatically saved daily in a “tar” file. This allows restoring old settings, e.g. if the preferences file has accidentally been deleted.

If there is the need to restore the system to a previous configuration, go to “HELIOSDIR/var/adm” and open the desired “tar” archive “configuration.tgz” (today) to “configuration.tgz.6” (seven days ago).

4.10 Data backup

As with all computer systems, it is highly advisable to make regular backups of network volumes to tape or disk. Although modern servers provide comprehensive safety mechanisms in case of system faults, it is never possible to fully exclude loss of data. For this reason, the administrator should regularly archive all volumes of the file server to mass storage. For data backup solutions see www.helios.de/3rd-party.


HELIOS Website © 2011 HELIOS Software GmbH  
HELIOS Manuals May 17, 2013