Transferring Installation - Mac OS X
Posted by Josh Brewer on 02 November 2015 17:57

You may want to complete a migration of your Archiware installation for many reasons. When migrating from one Mac host to another, the process isn’t complicated, but should be completed cautiously. This guide describes how to complete this migration and retain your configuration, indices, and log files during the process. 

Please note:

The configuration directory for version P4.x and P5.x differ. 

  • With P4, the configuration directory is:
    • /usr/local/aw/conf/
  • With P5, the configuration directory is:
    • /usr/local/aw/config/

** This guide will utilize the installation directories for P5. If you are migrating a P4 installation you will need to use its configuration directory instead.

Prerequisite:

You will be duplicating your configuration directory, which includes all your indices, and generated previews. Keep in mind that this could be large, and may take a few minutes to create the tar package. You will want to ensure that you have disk space available locally, or have storage attached where this tar package could be directed if local storage space is limited.

 

Begin on the current Archiware host machine.

Ensure there are no active jobs.

Open the Terminal application. 

  • Run the following command to stop the P5 service:
    • sudo /usr/local/aw/stop-server

Enter your administrative password when prompted. 

 

The process will look like this:

user$ sudo /usr/local/aw/stop-server 

Password:

Stopping PresStore application servers, be patient...

  lexxsrv pid: 83 (stopped)

Stopped 1 from 1 application servers.

 

With the service now stopped, you need to create the tar package and copy it to your preferred destination, in this case its headed to my desktop.

Move to the Archiware installation directory. 

  • In Terminal:
    • cd /usr/local/aw/
  • Then enter the following command:
    • $ sudo tar -cf ~/Desktop/archiware_backup.tar .
  • Then do the same, if you wish, to package the directory containing all your logs:
    • sudo tar -cf ~/Desktop/archiware_logs_backup.tar log/

The above will grab the configuration and log directories (and their sub-directories), combining them into the tar packages and placing them on the Desktop. You will now see “archiware_backup.tar” and "archiware_logs_backup.tar" (or whatever you named them) on your Desktop (or whatever destination you chose). 

Copy these packages to the new hardware. I copied them from the desktop of one machine to the desktop of the other.

That is all for the current installation, you can now proceed to the new hardware.

 

On the new hardware.

You will first need to download and install P5.

Our download page is found here: http://www.archiware.com/download

Once installed, you can ensure its running by logging into the P5 web interface. 

(127.0.0.1:8000/login)

 

Open the Terminal application. 

  • Run the following command to stop the P5 service:
    • sudo /usr/local/aw/stop-server

Enter your administrative password when prompted. 

The command will perform as it did on the original host.

In the Terminal again

  • Navigate to the installation directory:
    • cd /usr/local/aw/config
  • Unpack the tar package from the Desktop (or destination you chose) to the current “config” directory. 
    • sudo tar -xvf ~/Desktop/archiware_backup.tar
  • Unpack the logs tar package from the Desktop (or destination you chose) to the current "log" directory. 
    • cd /usr/local/aw/log
    • sudo tar -xvf ~/Desktop/archiware_logs_backup.tar

The step above will unpack the tar file and overwrite the empty installation directories you just installed with your data from the other installation. Depending on its size, this step could take a few minutes or much longer depending on your index and configuration. 

In the Terminal again

  • Run the following command to start the P5 service:
    • sudo /usr/local/aw/start-server

Enter your administrative password when prompted. 

The process will look like this:

$ sudo /usr/local/aw/start-server 

Password:

Starting PresStore application servers, be patient...

  lexxsrv pid: #### (version “5.x.x” running)

  lexxsrv url: http://###.###.##.###:8000/login (use web-browser to connect)

Started 1 from 1 application servers.

 

You can now open your browser and navigate to P5 and login. It will appear as it did on the previous host. 

If you had tape hardware configured you will need to remove that from this installation and configure it again using the Library wizard. This is necessary because the attached hardware would have different identification information on the new hardware and P5 will not be able to identify it properly with the old configuration. 

Once this is complete, you will also need to perform an Inventory of that library so you will have an accurate volume list.

You now need to complete a Host transfer for your licensing. This will transfer your license from the old host to the new. This is done from within the Archiware Portal. You will see the Portal link at the top of our homepage.

The Host Transfer process is also explained on our website, here: http://www.archiware.com/host-transfer.126.1.html

 

Transferring to or from a Windows host? 

The process remains the same, but the directories on the windows host are a bit different. 

On mac and linux hosts, the installation directory is: /usr/local/aw/

On a P5 (versions 5.2+) Windows host the installation directory is: C:\Program Files\ARCHIWARE\Data_Lifecycle_Management_Suite\ 

On a P5 (versions 5.0-5.1.9) Windows host the installation directory is: C:\Program Files (x86)\ARCHIWARE\PresStore\

Beyond the above the directory structure remains the same. 

(7 vote(s))
Helpful
Not helpful

Comments (2)
Lucas Hokanson
25 February 2016 3:21
The Tar command syntax needs tweaking. If you use the one listed on this article, it creates a absloute directory tree within the tar.

E.g.:
Aw_config_dir.tar has:
/usr/local/aw/config/fileshere

If restored in the config directory, you would only see a "usr" directory extracted, with a tree you could follow to another config directory. A-la: /usr/local/aw/config/usr/local/aw/config/<expected files to restore>
Josh Brewer
09 May 2016 17:23
Thank you, Lucus.
The instructions have been altered.
Post a new comment
 
 
Full Name:
Email:
Comments:
CAPTCHA Verification 
 
Please enter the text you see in the image into the textbox below (we use this to prevent automated submissions).

ERROR: This domain name (portal.archiware.com), does not match the domain name in the license key file support.archiware.com.

For assistance with your license, please contact the Kayako support team: https://support.kayako.com