SAS Publishing

Change SAS® Forecast Server 1.4 Project Directory

The correct bibliographic citation for this manual is as follows: SAS Institute Inc. 2006. Change SAS ® Forecast Server 1.4: Project Directory. Cary, NC: SAS Institute Inc.

Change SAS ® Forecast Server 1.4: Project Directory

Copyright © 2002-2006, SAS Institute Inc., Cary, NC, USA

All rights reserved. Produced in the United States of America.

For a hard-copy book: No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, photocopying, or otherwise, without the prior written permission of the publisher, SAS Institute Inc.

For a Web download or e-book: Your use of this publication shall be governed by the terms established by the vendor at the time you acquire this publication.

U.S. Government Restricted Rights Notice: Use, duplication, or disclosure of this software and related documentation by the U.S. government is subject to the Agreement with SAS Institute and the restrictions set forth in FAR 52.227-19, Commercial Computer Software-Restricted Rights (June 1987).

SAS Institute Inc., SAS Campus Drive, Cary, North Carolina 27513.

1st printing, December 2006

SAS® Publishing provides a complete selection of books and electronic products to help customers use SAS software to its fullest potential. For more information about our e-books, e-learning products, CDs, and hard-copy books, visit the SAS Publishing Web site at support.sas.com/pubs or call 1-800-727-3228.

SAS® and all other SAS Institute Inc. product or service names are registered trademarks or trademarks of SAS Institute Inc. in the USA and other countries. ® indicates USA registration.

Other brand and product names are registered trademarks or trademarks of their respective companies.

Change the SAS Forecast ServerProjects Location

Contents

SAS FORECAST SERVER PROJECTS DEFAULT LOCATION . . . . . . 3

CHANGE THE DEFAULT LOCATION OF SAS FORECAST SERVERPROJECTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

CHANGE THE LOCATION WHERE USER PROJECTS ARE SAVED . . 4

INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2

Change the SAS Forecast ServerProjects Location

SAS Forecast Server Projects Default LocationBy default, the location of the SAS Forecast Server (forecast-studio-project) directoryis the following:

UNIX: <config-dir>/SAS/ForecastStudioWindows: c:\SAS\ForecastStudio

You might prefer to store the central SAS Forecast Server files in the SAS IntelligencePlatform configuration directory’s logical server tree, such as the following:UNIX: <config-dir>/Lev1/SASMain/Data/ForecastingWindows: <config-dir>\Lev1\SASMain\Data \Forecasting

Change the Default Location of SAS ForecastServer ProjectsYou can specify a different default location of the forecast-studio-project directorywhen you run the SAS Forecast Server setup file. This process must be executedon the physical machine that is running the SAS Analytics Platform. However, thescript updates the project location in the SAS Metadata Server, and also it createsa physical directory structure in your chosen path on the SAS Workspace Servermachine.

Note: If you change the project location after you created projects in SAS ForecastServer, then using the ForecastStudioSetup script to change the project location onlychanges the location for new projects. All of your existing projects still reference theoriginal location because this physical location is stored in metadata with the projectinformation, as well as in the project.xml file found in the project directory.

• Windows: You create the directory structure from a SAS Forecast ServerMid-Tier machine by running the script ForecastStudioSetup.bat, whichexecutes the SAS Forecast Server administrative setup without the installationof the SAS Forecast Studio client. The script is located in the followingdirectory:!SASROOT\SASAPCore\apps\Forecasting\bin

4 � Change the SAS Forecast Server Projects Location

Note: If you want to change the file location, then specify a new directorypathname when you execute the ForecastStudioSetup.bat file with the follow-ing option:ForecastStudioSetup"location=<new-directory-pathname>\ForecastStudio"Example:

ForecastStudioSetup"location=D:\myprojects\ForecastStudio"

• UNIX: On the machine where you installed the SAS Analytics Platform, runthe script ForecastStudioSetup.sh, which executes the SAS Forecast Serveradministrative setup. The location of the setup script is in the followingsubdirectory of the installation directory:!SASROOT/SASAPCore/apps/Forecasting/bin

Note: If you want to change the file location, then specify a new directory path-name when you execute the ForecastStudioSetup.sh script with the followingoption:ForecastStudioSetup"location=<new-directory-pathname>/ForecastStudio"Example:

ForecastStudioSetup"location=/myprojects/ForecastStudio"

The SAS Forecast Server administrative user’s credentials must be used whenrunning this script, so that the physical path on the SAS Workspace Server ma-chine is created by the SAS Forecast Server administrative user (e.g., fsadm).If the folder is not created by the SAS Forecast Server administrative user, thenan error is displayed.

Change the Location Where User Projects AreSavedThe current user interface does not support a project location to be specified. The onlylocation known to the system is stored in the metadata, and the user cannot customizethis location either in the user interface or in the metadata.

However, an optional file can be created to define a mapping for users and the defaultSAS workspace server location where projects, data specifications, and archives arecreated. The user–locations.properties file must reside on the SAS Analytics Platformmiddle tier in the following directory (Windows operating environment example):!SASROOT\SASAPCore\apps\Forecasting

The user–locations.properties file contains the workspace server locations by userID, or by user ID and workspace session ID. SAS Forecast Server uses this mappingfile to determine where workspace server project files should be saved physically.

Change the Location Where User Projects Are Saved � 5

SAS Forecast Server first attempts to find the user ID and SAS workspace server IDentries, and if it does not find them, then attempts to find just the user ID. If neitherID is found, then the default location in the metadata is used. The user ID and SASworkspace server ID entries are case insensitive, as shown in the following Windowoperating environment examples:

myuser=C:\SAS\ForecastStudio

myuser\A5PITA0F.AT000001=D:\myuser\ForecastStudio

brenda=c:\users\brenda\orecastStudio

mike=c:\users\mike\ForecastStudio

george=c:\users\george\ForecastStudio

brian=\\myserver\myprojects (UNC path name example)

The user–locations.properties file is read dynamically, and can be modified while theSAS Analytics Platform is running. Changes are reflected without having to restartthe SAS Analytics Platform.

A mapped drive letter such as U:\<foldername> is not supported. Given that thisdirectory path is resolved by the SAS Workspace Server, the logon script for that useris NOT executed when a SAS Workspace Server starts. As a result, a drive letter thatwould be mapped automatically in a logon script would never be defined.

6

Index

Aadministration

change default project location, 3change user project location, 4default project location, 3

Cchange default project location

administration, 3change user project location

administration, 4

Ddefault project location

administration, 3

8

Your Turn

If you have comments or suggestions about Change SAS ® Forecast Server 1.4: Project Directory, please send them to us on a photocopy of this page or send us electronic mail.

For comments about this book, please return the photocopy to

SAS Publishing SAS Campus Drive Cary, NC 27513 E-mail: yourturn@sas.com

For suggestions about the software, please return the photocopy to

SAS Institute Inc. Technical Support Division SAS Campus Drive Cary, NC 27513 E-mail: suggest@sas.com

66

SAS and all other SAS Institute Inc. product or service names are registered trademarks or trademarks of SAS Institute Inc. in the USA and other countries. ® indicates USA registration. Other brand and product names are trademarks of their respective companies. © 2006 SAS Institute Inc. All rights reserved. 403726US.0806

SAS® Publishing gives you the tools to flourish in any environment with SAS®!

Whether you are new to the workforce or an experienced professional, you need to distinguish yourself in this rapidly changing and competitive job market. SAS® Publishing provides you with a wide range of resources— including publications, online training, and software —to help you set yourself apart.

Expand Your Knowledge with Books from SAS® Publishing SAS® Press offers user-friendly books for all skill levels, covering such topics as univariate and multivariate statistics, linear models, mixed models, fixed effects regression, and more. View our complete catalog and get free access to the latest reference documentation by visiting us online.

s u p p o r t . s a s . c o m / p u b s

SAS® Self-Paced e-Learning Puts Training at Your Fingertips You are in complete control of your learning environment with SAS Self-Paced e-Learning! Gain immediate 24/7 access to SAS training directly from your desktop, using only a standard Web browser. If you do not have SAS installed, you can use SAS® Learning Edition for all Base SAS e-learning.

s u p p o r t . s a s . c o m / s e l f p a c e d

Build Your SAS Skills with SAS® Learning Edition SAS skills are in demand, and hands-on knowledge is vital. SAS users at all levels, from novice to advanced, will appreciate this inexpensive, intuitive, and easy-to-use personal learning version of SAS. With SAS Learning Edition, you have a unique opportunity to gain SAS software experience and propel your career in new and exciting directions.

s u p p o r t . s a s . c o m / L E